Documentation/scsi/st.rst

49 above. Additional modes are dormant until they are defined by the
58 parameters are reset when a new tape is loaded).
73 non-rewind devices (minor is 128 + device number) are implemented.
98 are caught at that point, but this takes time. In some applications, several
109 The compile options are defined in the file linux/drivers/scsi/st_options.h.
124 each drive are used.
132 byte). The bits defining the mode are below the non-rewind bit. The
142 directories corresponding to the existing tape devices. There are autorewind
143 and non-rewind entries for each mode. The names are stxy and nstxy, where x
145 a). For example, the directories for the first tape device are (assuming four
157 bit definitions are the same as those used with MTSETDRVBUFFER in setting the
168 The following method can be used to locate the statistics that are
191         movement such as when rewind on close tape devices are used.
226 progress. The individual values are read and written to atomically however
230 The value shown in in_flight is incremented before any statstics are
232 The value of in_flight is 0 when there are no I/Os outstanding that are
254 is used (i.e., bounce buffers for individual pages are not
257 - one or more pages are at addresses not reachable by the HBA
273 NOTE that if direct i/o is used, the small writes are not buffered. This may
281 at the next tape operation. Asynchronous writes are not done with
294 in the physical memory) are used if contiguous buffers can't be
307 2. The scatter/gather segments to fill the specified buffer size are
308    allocated so that as many segments as possible are used but the number
312    are used to extend the buffer at run-time if this is necessary. The
327 bytes is returned. After this, -1 and the number of bytes are
335 are configurable when the driver is loaded as a module. The keywords are:
363 the driver as module. If several parameters are set, the keyword-value
364 pairs are separated with a comma (no spaces allowed). A colon can be
384 The tape is positioned and the drive parameters are set with ioctls
391 The supported ioctls are:
436 	block numbers in the status are not valid after a seek.
480         with mask MT_SET_OPTIONS, the low order bits are used as argument.
482 	subcommands are:
488            Sets the buffering options. The bits are the new states
506 		the defaults are meant only for writes (mode)
521 		this flag unless there are tapes using the device
537 		if you are sure that the drive supports SILI and the HBA
560 	   contains the new default. If the bits 8-15 are set to a
571 	   Set the long timeout that is used for operations that are
581 	   cleaning. The bits are device-dependent. The driver is
592 	   qualifier 00h 17h are seen regardless of the setting of
606         The file number and block number within file are returned. The
611         The current block size and the density code are stored in the field
612         mt_dsreg (shifts for the subfields are MT_ST_BLKSIZE_SHIFT and
622 The recovered write errors are considered fatal if ST_RECOVERED_WRITE_FATAL
626 ST_MAX_TAPES. If more tapes are detected at driver initialization, the
633 gracefully, but some drive/adapter combinations are known to hang the
671 Note also that the timeouts are very long compared to most other