(split) LDP: Update original to LDP v3.65

[linuxjm/LDP_man-pages.git] / original / man4 / st.4

diff --git a/original/man4/st.4 b/original/man4/st.4
index 78585c7..6f6a937 100644 (file)
--- a/original/man4/st.4
+++ b/original/man4/st.4
@@ -1,6 +1,7 @@
 .\" Copyright 1995 Robert K. Nichols (Robert.K.Nichols@att.com)
 .\" Copyright 1999-2005 Kai Mäkisara (Kai.Makisara@kolumbus.fi)
 .\"
+.\" %%%LICENSE_START(VERBATIM)
 .\" Permission is granted to make and distribute verbatim copies of this
 .\" manual provided the copyright notice and this permission notice are
 .\" preserved on all copies.
@@ -20,6 +21,7 @@
 .\"
 .\" Formatted or processed versions of this manual, if unaccompanied by
 .\" the source, must acknowledge the copyright and authors of this work.
+.\" %%%LICENSE_END
 .TH ST 4  2010-09-04 "Linux" "Linux Programmer's Manual"
 .SH NAME
 st \- SCSI tape device
@@ -170,7 +172,7 @@ on the system.
 Starting from kernel 2.6.2, the driver exports in the sysfs directory
 .I /sys/class/scsi_tape
 the attached devices and some parameters assigned to the devices.
-.SS "Data Transfer"
+.SS Data transfer
 The driver supports operation in both fixed-block mode and
 variable-block mode (if supported by the drive).
 In fixed-block mode the drive
@@ -208,8 +210,8 @@ If this is not possible, the driver's internal buffer
 is used.
 The reasons for not using direct transfers include improper alignment
 of the user buffer (default is 512 bytes but this can be changed by the HBA
-driver), one of more pages of the user buffer not reachable by the
-SCSI adapter, etc.
+driver), one or more pages of the user buffer not reachable by the
+SCSI adapter, and so on.
 .PP
 A filemark is automatically written to tape if the last tape operation
 before close was a write.
@@ -236,10 +238,10 @@ driver are passed to the
 driver.
 The definitions below are from
 .IR /usr/include/linux/mtio.h :
-.SS "MTIOCTOP \(em Perform a tape operation"
+.SS MTIOCTOP \(em perform a tape operation
 .PP
 This request takes an argument of type
-.IR "(struct mtop *)" .
+.IR "(struct mtop\ *)" .
 Not all drives support all operations.
 The driver returns an
 .B EIO
@@ -491,7 +493,6 @@ If this option is false and the drive uses a fixed block size, then
 all write operations must be for a multiple of the block size.
 This option must be set false to write reliable multivolume archives.
 .TP
-.TP
 .BR MT_ST_ASYNC_WRITES " (Default: true)"
 When this option is true, write operations return immediately without
 waiting for the data to be transferred to the drive if the data fits
@@ -511,7 +512,7 @@ all read operations must be for a multiple of the block size.
 .BR MT_ST_TWO_FM " (Default: false)"
 This option modifies the driver behavior when a file is closed.
 The normal action is to write a single filemark.
-If the option is true the driver will write two filemarks and
+If the option is true, the driver will write two filemarks and
 backspace over the second one.
 .IP
 Note:
@@ -539,7 +540,7 @@ lose track of the current file number normally returned by the
 request.
 If
 .B MT_ST_FAST_EOM
-is false the driver will respond to an
+is false, the driver will respond to an
 .B MTEOM
 request by forward spacing over files.
 .TP
@@ -560,7 +561,7 @@ sends the SCSI-commands immediately when the device is changed.
 If the
 option is true, the SCSI-commands are not sent until a write is
 requested.
-In this case the drive firmware is allowed to detect the
+In this case, the drive firmware is allowed to detect the
 tape structure when reading and the SCSI-commands are used only to
 make sure that a tape is written according to the correct specification.
 .TP
@@ -604,7 +605,7 @@ Otherwise the device-specific addresses are used.
 It is highly advisable to set this option if the drive supports the
 logical addresses because they count also filemarks.
 There are some
-drives that only support the logical block addresses.
+drives that support only the logical block addresses.
 .TP
 .BR MT_ST_SYSV " (Default: false)"
 When this option is enabled, the tape devices use the SystemV
@@ -678,10 +679,10 @@ If the bit pattern is zero, one or more bits under the mask indicate
 the cleaning request.
 If the pattern is nonzero, the pattern must match
 the masked sense data byte.
-.SS "MTIOCGET \(em Get status"
+.SS MTIOCGET \(em get status
 .PP
 This request takes an argument of type
-.IR "(struct mtget *)" .
+.IR "(struct mtget\ *)" .
 .PP
 .in +4n
 .nf
@@ -800,10 +801,10 @@ This value is set to \-1 when the block number is unknown (e.g., after
 .BR MTBSS ,
 or
 .BR MTSEEK ).
-.SS "MTIOCPOS \(em Get tape position"
+.SS MTIOCPOS \(em get tape position
 .PP
 This request takes an argument of type
-.I "(struct mtpos *)"
+.I "(struct mtpos\ *)"
 and reports the drive's notion of the current tape block number,
 which is not the same as
 .I mt_blkno
@@ -823,7 +824,7 @@ struct mtpos {
 };
 .fi
 .in
-.SH "RETURN VALUE"
+.SH RETURN VALUE
 .TP 14
 .TP
 .B EACCES
@@ -945,17 +946,26 @@ If this is not possible, direct transfers can be disabled.
 .\" .br
 .\" Copyright \(co 1999-2005 Kai M\(:akisara.
 .\" .PP
+.\" %%%LICENSE_START(VERBATIM)
 .\" Permission is granted to make and distribute verbatim copies of this
 .\" manual provided the copyright notice and this permission notice are
 .\" preserved on all copies.
 .\" Additional permissions are contained in the header of the source file.
-.SH "SEE ALSO"
+.SH SEE ALSO
 .BR mt (1)
 .PP
 The file
 .I drivers/scsi/README.st
 or
 .I Documentation/scsi/st.txt
-(kernel >= 2.6) in the kernel sources contains
+(kernel >= 2.6) in the Linux kernel source tree contains
 the most recent information about the driver and its configuration
-possibilities.
+possibilities
+.SH COLOPHON
+This page is part of release 3.65 of the Linux
+.I man-pages
+project.
+A description of the project,
+and information about reporting bugs,
+can be found at
+\%http://www.kernel.org/doc/man\-pages/.