ST(4)

NOMBRE
st - dispositivo de cinta magnética SCSI

SINOPSIS
#include <sys/mtio.h>

int ioctl(int fd, int request [, (void *)arg3]);
int ioctl(int fd, MTIOCTOP, (struct mtop *)mt_cmd);
int ioctl(int fd, MTIOCGET, (struct mtget *)mt_status);
int ioctl(int fd, MTIOCPOS, (struct mtpos *)mt_pos);

DESCRIPCIÓN
El manejador (driver) st proporciona la interfaz para una variedad de dispositivos de cinta magnética SCSI. Actualmente, toma el control de todos los dispositivos detectados de tipo “acceso secuencial”. El manejador st emplea el número mayor de dispositivo 9.

Each device uses eight minor device numbers. The lowermost five bits in the minor numbers are assigned sequentially in the order of detection. In the 2.6 kernel, the bits above the eight lowermost bits are concatenated to the five lowermost bits to form the tape number. The minor numbers can be grouped into two sets of four numbers: the principal (auto-rewind) minor device numbers, n, and the “no-rewind” device numbers, (n + 128). Devices opened using the principal device number will be sent a REWIND command when they are closed. Devices opened using the “no-rewind” device number will not. (Note that using an auto-rewind device for positioning the tape with, for instance, mt does not lead to the desired result: the tape is rewound after the mt command and the next command starts from the beginning of the tape).

Dentro de cada grupo, hay disponibles cuatro números menores para definir dispositivos con diferentes características (tamaño de bloque, compresión, densidad, etc.). Cuando el sistema arranca, sólo está disponible el primer dispositivo. Los otros tres se activan cuando se definen las carcterísticas por defecto (ver más abajo). (Cambiando las constantes en tiempo de compilación, es posible cambiar el equilibrio entre el número máximo de unidades de cinta y el número de números menores para cada unidad. La asignación por defecto permite controlar 32 dispositivos de cinta. Por ejemplo, es posible controlar hasta 64 unidades de cinta con 2 números menores para diferentes opciones).

Normalmente los dispositivos se crean con:

    mknod -m 666 /dev/st0 c 9 0
    mknod -m 666 /dev/st0l c 9 32
    mknod -m 666 /dev/st0m c 9 64
    mknod -m 666 /dev/st0a c 9 96
    mknod -m 666 /dev/nst0 c 9 128
    mknod -m 666 /dev/nst0l c 9 160
    mknod -m 666 /dev/nst0m c 9 192
    mknod -m 666 /dev/nst0a c 9 224

No existe el dispositivo de bloque correspondiente.

El manejador usa un buffer interno que tiene que ser lo suficientemente grande para contener, al menos, un bloque de la cinta. En los núcleos anteriores al 2.1.121, el buffer se reserva como un bloque contiguo. Esto limita el tamaño de bloque al mayor bloque contiguo de memoria que el código de asignación de memoria del núcleo puede proporcionar. Actualmente, el límite es de 128 kB para arquitecturas de 32 bits y 256 kB para arquitecturas de 64 bits. En núcleos posteriores el manejador reserva el buffer en varias partes si es necesario. Por defecto, el número máximo de partes es de 16. Esto significa que el tamaño máximo de bloques es muy grande (2 MB si es posible una asignación de 16 bloques de 128 kB).

El tamaño del buffer interno del manejador viene determinado por una contante en tiempo de compilación que se puede alterar con una opción de inicio del núcleo. Aparte de esto, el manejador intenta reservar un buffer temporal mayor en tiempo de ejecución si es necesario. Sin embargo, la asignación en tiempo de ejecución de grandes bloques contiguos de memoria puede fallar y es aconsejable no confiar demasiado en la asignación dinámica de buffers con núcleos anteriores al 2.1.121 (esto se aplica también a la carga por demanda del manejador con kerneld o kmod).

El manejador no soporta específicamente ninguna marca o modelo de unidad de cinta. Después del arranque del sistema se definen las opciones de los dispositivos de cinta a partir del firmware de la unidad. Por ejemplo, si el firmware de la unidad selecciona un modo de bloque fijo, el dispositivo de cinta usa el modo de bloque fijo. Las opciones se pueden cambiar con llamadas explícitas a ioctl(2) y permanecen activas cuando el dispositivo se cierra y se vuelve a abrir. La configuración de las opciones afecta tanto al dispositivo con auto-rebobinado como sin rebobinado.

Se pueden indicar diferentes opciones para los diferentes dispositos dentro del subgrupo de cuatro. Las opciones entran en vigor cuando el dispositivo se abre. Por ejemplo, el administrador del sistema puede definir un dispositivo que escribe en modo de bloque fijo con un tamaño de bloque concreto y otro que escribe en modo de bloque variable (si la unidad de cinta soporta ambos modos).

El majenador soporta particiones de cinta si son soportadas por la unidad. (Dese cuenta que las particiones de cinta no tienen nada que ver con las particiones de disco. Una cinta particionada se puede ver como varias cintas lógicas dentro de un mismo medio). El soporte de particiones se debe habilitar con ioctl(2). La posición de cinta se conserva dentro de cada partición durante los cambios de partición. La partición usada para las operaciones de cinta subsiguientes se selecciona con ioctl(2). El cambio de partición se ejecuta junto con la siguiente operación de cinta para evitar movimientos de cinta innecesarios. El número máximo de particiones en una cinta es definido por una constante en tiempo de compilación (originalmente cuatro). El manejador contiene un ioctl(2) que puede formatear una cinta con una o dos particiones.

El dispositivo /dev/tape se crea normalmente como un enlace físico o simbólico al dispositivo de cinta predeterminado en el sistema.

Starting from kernel 2.6.2, the driver exports in the sysfs directory /sys/class/scsi_tape the attached devices and some parameters assigned to the devices.

  Data transfer
El manejador soporta tanto el funcionamiento en modo de bloque fijo como en modo de bloque variable (si la unidad lo soporta). En el modo de bloque fijo la unidad escribe bloques del tamaño especificado y el tamaño de bloque no depende de la cantidad de bytes de las llamadas al sistema de escritura. En el modo de bloque variable se escribe un bloque de cinta para cada llamada de escritura y el número de bytes determina el tamaño del bloque de cinta correspondiente. Dese cuenta que los bloques en la cinta no contienen ninguna información sobre el modo de escritura: cuando se lee, lo único importante es usar órdenes que acepten los tamaños de los bloques en la cinta.

In variable-block mode the read byte count does not have to match the tape block size exactly. If the byte count is larger than the next block on tape, the driver returns the data and the function returns the actual block size. If the block size is larger than the byte count, an error is returned.

En el modo de bloque fijo, la cantidad de bytes a leer puede ser arbitraria si se habilita el uso de buffers, o un múltiplo del tamaño de bloque de la cinta si se deshabilita el uso de buffers. Los núcleos anteriores al 2.1.121 permiten escrituras con cantidades de bytes arbitrarias si se habilita el uso de buffers. En todos los otros casos (un núcleo anterior al 2.1.121 con uso de buffers deshabilitado o un núcleo nuevo) la cantidad de bytes a escribir debe ser un múltiplo del tamaño de bloque de la cinta.

In the 2.6 kernel, the driver tries to use direct transfers between the user buffer and the device. 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 or more pages of the user buffer not reachable by the SCSI adapter, and so on.

Automáticamente se escribe una marca de fichero en la cinta si la última operación de cinta antes de cerrar era un escritura.

Cuando se encuentra una marca de fichero durante las lecturas, ocurre lo siguiente. Si quedan datos en el buffer cuando se encuentra la marca de fichero, se devuelven los datos del buffer. La próxima lectura devuelve cero bytes. La siguiente lectura devuelve datos del siguiente fichero. El final de los datos grabados se indica devolviendo cero bytes para dos lecturas consecutivas. La tercera lectura devuelve un error.

  Ioctls
El manejador admite tres peticiones ioctl(2). Las peticiones no reconocidas por el manejador st se pasan al manejador SCSI. Las definiciones de abajo son de /usr/include/linux/mtio.h:

  MTIOCTOP — Efectuar una operación en la cinta

Esta petición toma un argumento de tipo (struct mtop *). No todas las unidades de cinta admiten todas las operaciones. El manejador retorna un error EIO si la unidad rechaza una operación.

    /* Estructura para MTIOCTOP - orden de op. de cinta mag.: */
    struct mtop {
        short   mt_op;       /* operationes definidas abajo */
        int     mt_count;    /* cuántas de ellas */
    };

Operaciones de Cinta Magnética para el uso normal de una cinta:

MTBSF
    Espacio atrás sobre mt_count marcas de fichero.

MTBSFM
    Espacio atrás sobre mt_count marcas de fichero. Reposiciona la cinta a la parte EOT de la última marca de fichero.

MTBSR
    Espacio atrás sobre mt_count registros (bloques de cinta).

MTBSS
    Espacio atrás sobre mt_count marcas de conjunto.

MTCOMPRESSION
    Habilita la compresión de los datos de la cinta dentro de la unidad si mt_count no es cero y deshabilita la compresión si mt_count es cero. Esta orden usa el MODO página 15 (`MODE page 15') soportado por la mayoría de DATs.

MTEOM
    Ir al fin del material grabado (para añadir ficheros).

MTERASE
    Erase tape. With 2.6 kernel, short erase (mark tape empty) is performed if the argument is zero. Otherwise, long erase (erase all) is done.

MTFSF
    Espacio atrás sobre mt_count marcas de fichero.

MTFSFM
    Espacio atrás sobre mt_count marcas de fichero. Reposiciona la cinta a la parte BOT de la última marca de fichero.

MTFSR
    Espacio atrás sobre mt_count registros (bloques de cinta).

MTFSS
    Espacio atrás sobre mt_count marcas de conjunto.

MTLOAD
    Ejecuta la orden SCSI de carga. Se dispone de un caso especial para algunos autocargadores HP. Si mt_count es la constante MT_ST_HPLOADER_OFFSET más un número, el número se envia a la unidad para controlar al autocargador.

MTLOCK
    Bloquea la puerta de la unidad de cinta.

MTMKPART
    Format the tape into one or two partitions. If mt_count is positive, it gives the size of partition 1 and partition 0 contains the rest of the tape. If mt_count is zero, the tape is formatted into one partition. From kernel version 4.6, a negative mt_count specifies the size of partition 0 and the rest of the tape contains partition 1. The physical ordering of partitions depends on the drive. This command is not allowed for a drive unless the partition support is enabled for the drive (see MT_ST_CAN_PARTITIONS below).

MTNOP
    No op.—vuelca el búfer del manejador como efecto colateral. Debería emplearse antes de leer el estado con MTIOCGET.

MTOFFL
    Rebobina y apaga la unidad.

MTRESET
    Pone la unidad en el estado inicial.

MTRETEN
    Retensiona la cinta.

MTREW
    Rebobina.

MTSEEK
    Busca y va al número de bloque especificado en mt_count. Esta operación requiere bien una unidad SCSI-2 que admita la orden LOCATE (dirección específica del dispositivo), bien una unidad SCSI-1 compatible con Tandberg (Tandberg, Archive Viper, Wangtek, ... ). El número de bloque debería ser uno previamente devuelto por MTIOCPOS si se utilizan direcciones específicas del dispositivo.

MTSETBLK
    Establece la longitud de bloque de la unidad al valor especificado en mt_count. Una longitud de bloque cero pone la unidad en modo de tamaño de bloque variable.

MTSETDENSITY
    Pone la densidad de la cinta según el código en mt_count. Los códigos de densidad soportados por una unidad se pueden encontrar en la documentación de la unidad.

MTSETPART
    La partición activa se cambia a mt_count. Las particiones se numeran a partir de cero. Esta orden no se permite para una unidad a menos que se habilite el soporte de particiones para la unidad (ver MT_ST_CAN_PARTITIONS más abajo).

MTUNLOAD
    Ejecuta la orden SCSI de descarga (no expulsa la cinta).

MTUNLOCK
    Desbloquea la puerta de la unidad de cinta.

MTWEOF
    Escribe mt_count marcas de fichero.

MTWSM
    Escribe mt_count marcas de conjunto.

Operaciones de Cinta Magnética para configurar las opciones del dispositivo (a realizar por el superusuario):

MTSETDRVBUFFER
    Set various drive and driver options according to bits encoded in mt_count. These consist of the drive's buffering mode, a set of Boolean driver options, the buffer write threshold, defaults for the block size and density, and timeouts (only in kernels 2.1 and later). A single operation can affect only one item in the list below (the Booleans counted as one item.)

    Un valor que tenga ceros en los 4 bits más altos se empleará para establecer el modo de tamponamiento de la unidad. Los modos de tamponamiento son:

    0   La unidad no informará del estado GOOD en órdenes de escritura hasta que los bloques de datos se escriban realmente en el material magnético.

    1   La unidad puede devolver un estado GOOD en órdenes de escritura tan pronto como todos los datos se hayan transferido al búfer interno de la unidad.

    2   La unidad puede devolver un estado GOOD en órdenes de escritura tan pronto como (a) todos los datos se hayan transferido al búfer interno del manejador, y (b) todos los datos en búferes, provinientes de iniciadores diferentes, hayan sido bien escritos en el material magnético.

    To control the write threshold the value in mt_count must include the constant MT_ST_WRITE_THRESHOLD bitwise ORed with a block count in the low 28 bits. The block count refers to 1024-byte blocks, not the physical block size on the tape. The threshold cannot exceed the driver's internal buffer size (see DESCRIPTION, above).

    Para activar y desactivar las opciones booleanas el valor en mt_count debe incluir una de las constantes MT_ST_BOOLEANS, MT_ST_SETBOOLEANS, MT_ST_CLEARBOOLEANS o MT_ST_BOOLEANS operada con un O lógico inclusivo a nivel de bits con cualquier combinación de las siguientes opciones, según se desee. Usando MT_ST_BOOLEANS se pueden asignar a las opciones los valores definidos en los bits correspondientes. Con MT_ST_SETBOOLEANS se pueden configurar las opciones de forma selectiva y selectivamente borradas con MT_ST_DEFBOOLEANS.

    Las opciones por defecto para un dispositivo de cinta se configuran con MT_ST_DEFBOOLEANS. Un dispositivo de cinta no activo (por ejemplo, un dispositivo con número menor 32 o 160) se activa cuando sus opciones por defecto se definen por primera vez. Un dispositivo activado herenda del dispositivo activado durante el arranque las opciones no configuradas explícitamente.

    Las opciones booleanas son:

    MT_ST_BUFFER_WRITES (Por omisión: verdad)
        Todas las operaciones de escritura van a través de búferes en el modo de bloque fijo. Si esta opción es falsa y la unidad emplea un tamaño de bloque fijo, entonces todas las operaciones de escritura deben ser un múltiplo del tamaño de bloque. Esta opción debe ponerse como falsa para escribir confiablemente archivos multivolúmenes.

    MT_ST_ASYNC_WRITES (Por omisión: verdad)
        Cuando esta opción es verdad, las operaciones de escritura regresan inmediatamente sin esperar que los datos se transfieran a la unidad si los datos caben en el búfer del manejador. El umbral de escritura determina cuán lleno debe estar el búfer antes de que se dé una nueva orden de escritura SCSI. Cualquier error devuelto por la unidad se mantendrá en espera hasta la siguiente operación. Esta opción debe ponerse como falsa para escribir confiablemente archivos multivolúmenes.

    MT_ST_READ_AHEAD (Por omisión: verdad)
        Esta opción hace que el manejador proporcione un búfer para la lectura, y lectura por adelantado en el modo de bloque fijo. Si esta opción es falsa y la unidad emplea un tamaño de bloque fijo, entonces todas las operaciones de lectura deben ser para un múltiplo del tamaño de bloque.

    MT_ST_TWO_FM (Por omisión: falso)
        Esta opción modifica el comportamiento del manejador cuando un fichero se cierra. La acción normal es escribir una simlpe marca de fichero. Si la opción es verdad el manejador escribirá dos marcas de fichero y hará un espacio atrás sobre el segundo.

        Nota: Esta opción no debería ponerse a verdad para unidades de cinta QIC puesto que son incapaces de sobreescribir una marca de fichero. Estas unidades detectan el fin de datos grabados mirando si hay cinta en blanco en vez de dos marcas de fichero consecutivas. La mayoría de las otras unidades actuales también detectan el final de los datos grabados y el uso de dos marcas de fichero es normalmente necesario sólo al intercambiar cintas con algunos otros sistemas.

    MT_ST_DEBUGGING (Por omisión: falso)
        Esta opción activa varios mensajes de depuración del manejador (sólo es efectiva si se compiló la unidad con DEBUG definida a un valor no cero).

    MT_ST_FAST_EOM (Por omisión: falso)
        Esta opción hace que la operación MTEOM se envíe directamente a la unidad, acelerando potencialmente la operación pero haciendo que el manejador pierda la pista del número de fichero en curso normalmente devuelto por la petición MTIOCGET. Si MT_ST_FAST_EOM es falso el manejador responderá a una petición MTEOM saltando hacia adelante sobre los ficheros.

    MT_ST_AUTO_LOCK (Por omisión: falso)
        When this option is true, the drive door is locked when the device file is opened and unlocked when it is closed.

    MT_ST_DEF_WRITES (Por omisión: falso)
        Las opciones de cinta (tamaño de bloque, modo, compresión, etc.) pueden cambiar al cambiar de un dispositivo ligado a una unidad a otro dispositivo ligado a la misma unidad dependiendo de cómo se definan los dispositivos. Esta opción define cuándo es el manejador el que fuerza los cambios usando órdenes SCSI y cúando se confía en las capacidades del autodetección de las unidades. Si esta opción es falsa, el manejador envía inmediatamente órdenes SCSI cuando se cambia el dispositivo. Si la opción es verdad, no se envían órdenes SCSI hasta que se solicite una escritura. En este caso se permite al firmware de la unidad detectar la estructura de la cinta al leer y sólo se usan las órdenes SCSI para asegurarse de que una cinta se escribe según la especificación correcta.

    MT_ST_CAN_BSR (Por omisión: falso)
        When read-ahead is used, the tape must sometimes be spaced backward to the correct position when the device is closed and the SCSI command to space backward over records is used for this purpose. Some older drives can't process this command reliably and this option can be used to instruct the driver not to use the command. The end result is that, with read-ahead and fixed-block mode, the tape may not be correctly positioned within a file when the device is closed. With 2.6 kernel, the default is true for drives supporting SCSI-3.

    MT_ST_NO_BLKLIMS (Por omisión: falso)
        Algunas unidades no aceptan la orden SCSI READ BLOCK LIMITS. Si se usa esto, el manejador no usará la orden. El inconveniente es que el manejador no puede comprobar antes de enviar órdenes si el tamaño de bloque seleccionado es aceptable por la unidad.

    MT_ST_CAN_PARTITIONS (Por omisión: falso)
        Esta opción habilita el soporte de varias particiones dentro de una cinta. La opción se aplica a todos los dispositivos ligados a la unidad.

    MT_ST_SCSI2LOGICAL (Por omisión: falso)
        Esta opción obliga al manejador a usar las direcciones lógicas de bloques definidas en el estándar SCSI-2 al realizar la búsqueda y comunicar operaciones (tanto con la órden MTSEEK como con MTIOCPOS y al cambiar la partición de la cinta). En otro caso, se usan las direcciones específicas del dispositivo. Es muy recomendable activar esta opción si la unidad soporta direcciones lógicas ya que también cuentan marcas de fichero. Hay algunos dispositivos que sólo soportan direcciones lógicas de bloque.

    MT_ST_SYSV (Por omisión: falso)
        Cuando se habilita esta opción, los dispositivos de cinta usan la semántica de System V. En caso contrario, se usa la semántica BSD. La diferencia más importante entre ambas semánticas es qué ocurre cuando un dispositivo utilizado para lectura se cierra: en la semántica System V la cinta se avanza hasta pasar la siguiente marca de fichero si esto no ha ocurrido ya al usar el dispositivo. En la semántica BSD la posición de la cinta no cambia.

    MT_NO_WAIT (Por omisión: falso)
        Enables immediate mode (i.e., don't wait for the command to finish) for some commands (e.g., rewind).

    An example:

        struct mtop mt_cmd;
        mt_cmd.mt_op = MTSETDRVBUFFER;
        mt_cmd.mt_count = MT_ST_BOOLEANS |
                MT_ST_BUFFER_WRITES | MT_ST_ASYNC_WRITES;
        ioctl(fd, MTIOCTOP, mt_cmd);

    El tamaño de bloque por defecto para un dispositivo se puede configurar con MT_ST_DEF_BLKSIZE y el código de densidad por defecto se puede configurar con MT_ST_DEFDENSITY. Los valores para los parámetros se operan con un O lógico con el código de operación.

    Con los núcleos 2.1.x y posteriores, los valores de los plazos de tiempo (timeout) se pueden configurar con la suborden MT_ST_SET_TIMEOUT operado con un O lógico con el plazo de tiempo en segundos. El plazo largo de tiempo (usado para los rebobinados y otras órdenes que pueden tardar mucho tiempo) se puede configurar con MT_ST_SET_LONG_TIMEOUT. Los valores por defecto del núcleo son muy grandes para asegurarse de que una órden exitosa no será cancelada para ninguna unidad. Debido a esto, el manejador puede parecer atascado aun cuando sólo esté esperando a que se cumpla el plazo de tiempo. Estas órdenes se pueden usar para configurar más valores útiles para una unidad específica. Los plazos de tiempo configurados para un dispostivo se aplican a todos los dispositivos ligados a la misma unidad.

    Starting from kernels 2.4.19 and 2.5.43, the driver supports a status bit which indicates whether the drive requests cleaning. The method used by the drive to return cleaning information is set using the MT_ST_SEL_CLN subcommand. If the value is zero, the cleaning bit is always zero. If the value is one, the TapeAlert data defined in the SCSI-3 standard is used (not yet implemented). Values 2–17 are reserved. If the lowest eight bits are >= 18, bits from the extended sense data are used. The bits 9–16 specify a mask to select the bits to look at and the bits 17–23 specify the bit pattern to look for. 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.

  MTIOCGET — obtiene el estado

Esta petición toma un argumento de tipo (struct mtget *).

    /* estructura para MTIOCGET - orden estado de cinta mag */
    struct mtget {
        long     mt_type;
        long     mt_resid;
        /* los ss. registros son dependientes del dispositivo */
        long     mt_dsreg;
        long     mt_gstat;
        long     mt_erreg;
        /* Los ss. 2 campos no se usan siempre */
        daddr_t  mt_fileno;
        daddr_t  mt_blkno;
    };

mt_type
    El fichero de cabecera define muchos valores para mt_type, pero el manejador actual informa sólo de los tipos genéricos MT_ISSCSI1 (cinta genérica SCSI-1) y MT_ISSCSI2 (cinta genérica SCSI-2).

mt_resid
    contiene el número de partición actual de la cinta.

mt_dsreg
    informa de los valores actuales de la unidad para el tamaño de bloque (en los 24 bits más bajos) y para la densidad (en los 8 bits más altos). Estos campos están definidos por MT_ST_BLKSIZE_SHIFT, MT_ST_BLKSIZE_MASK, MT_ST_DENSITY_SHIFT y MT_ST_DENSITY_MASK.

mt_gstat
    da información de estado genérica (independiente del dispositivo). El fichero de cabecera define macros para comprobar estos bits de estado:

    GMT_EOF(x): La cinta está posicionada justo tras una marca de fichero (siempre falso tras una operación MTSEEK).

    GMT_BOT(x): La cinta está posicionada al principio del primer fichero (siempre falso tras una operación MTSEEK).

    GMT_EOT(x): Una operación de cinta ha alcanzado el Final de Cinta físico.

    GMT_SM(x): La cinta está posicionada actualmente en una marca de conjunto (siempre falso tras una operación MTSEEK).

    GMT_EOD(x): La cinta está posicionada al final de datos grabados.

    GMT_WR_PROT(x): La unidad está protegida de escritura. Para algunas unidades esto también puede significar que no admite escribir en el tipo de medio físico actual.

    GMT_ONLINE(x): El último open(2) encontró a la unidad con una cinta puesta y lista para la operación.

    GMT_D_6250(x), GMT_D_1600(x), GMT_D_800(x): Esta información de estado “genérica” informa de la densidad actual para unidades de cinta de 9 pistas y ½ in. solamente.

    GMT_DR_OPEN(x): La unidad no tiene una cinta puesta.

    GMT_IM_REP_EN(x): Modo de informe inmediato. Este bit se activa si no hay garantías de que los datos se hayan escrito físicamente en la cinta cuando la llamada de escritura termina. Se le asigna el valor cero sólo cuando el manejador no usa buffers para los datos y la unidad no está configurada para usar buffers de datos.

    GMT_CLN(x): The drive has requested cleaning. Implemented in kernels since 2.4.19 and 2.5.43.

mt_erreg
    El único campo definido en mt_erreg es el número de errores recuperados en los 16 bits de más bajo orden (como se define por MT_ST_SOFTERR_SHIFT y MT_ST_SOFTERR_MASK). Debido a inconsistencias en la forma en que las unidades informan de errores recuperados, este número a menudo no es mantenido (la mayoría de las unidades no informan, por defecto, de errores leves pero esto se puede cambiar con una orden SCSI MODE SELECT).

mt_fileno
    devuelve el número de fichero actual (empezando por cero). Este valor se pone a -1 cuando el número de fichero se desconoce (p. ej. después de MTBSS o MTSEEK).

mt_blkno
    da el número de bloque (empezando por cero) dentro del fichero actual. Este valor se pone a -1 cuando el número de bloque se desconoce (p. ej. después de MTBSF, MTBSS o MTSEEK).

  MTIOCPOS — obtener la posición en la cinta

Esta petición toma un argumento de tipo (struct mtpos *) y devuelve la noción que tiene el manejador del número de bloque de cinta actual, que no es el mismo que mt_blkno devuelto por MTIOCGET. Esta unidad debe ser de tipo SCSI-2 y debe admitir la orden READ POSITION (dirección específica del dispositivo) o una unidad SCSI-1 compatible Tandberg (Tandberg, Archive Viper, Wangtek, ... ).

    /* estructura para MTIOCPOS - orden obtener posición cinta mag. */
    struct mtpos {
        long mt_blkno;    /* número de bloque en curso */
    };

VALOR DEVUELTO

EACCES
    Se intentó escribir o borrar una cinta protegida para escritura. (Este error no se detecta durante open(2).)

EBUSY
    El dispositivo ya está en uso o el manejador ha sido incapaz de reservar un búfer.

EFAULT
    Los parámetros de la orden apuntan a memoria que no pertenece al proceso invocador.

EINVAL
    An ioctl(2) had an invalid argument, or a requested block size was invalid.

EIO La operación pedida no ha podido completarse.

ENOMEM
    The byte count in read(2) is smaller than the next physical block on the tape. (Before 2.2.18 and 2.4.0 the extra bytes have been silently ignored.)

ENOSPC
    Una operación de escritura no pudo completarse porque la cinta llegó al final del material magnético.

ENOSYS
    ioctl(2) desconocido.

ENXIO
    Durante la apertura, el dispositivo de cinta no existe.

EOVERFLOW
    Se ha intentado leer o escribir un bloque de longitud variable que es mayor que el búfer interno del manejador.

EROFS
    Se ha intentado realizar una operación `open' con O_WRONLY o O_RDWR cuando la cinta de la unidad está protegida contra escritura.

ARCHIVOS

/dev/st*
    dispositivos de cinta SCSI con autorebobinado

/dev/nst*
    dispositivos de cinta SCSI sin rebobinado

NOTAS

1.  Cuando se intercambian datos entre sistemas, ambos sistemas deben coincidir en el tamaño físico del bloque de la cinta. Los parámetros de una unidad después del arranque no son, con frecuencia, los que la mayoría de los sistemas operativos usan con estos dispositivos. La mayoría de los sistemas usan unidades en modo de bloque variable si la unidad soporta ese modo. Esto es aplicable a la mayoría de las unidades modernas, incluyendo DATs, unidades de recorrido helicoidal de 8mm, DLTs, etc. Puede ser aconsejable usar estas unidades en modo variable también en Linux (es decir, use MTSETBLK o MTSETDEFBLK en el arranque del sistema para establecer el modo), al menos cuando se intercambien datos con sistemas externos. El inconveniente de esto es que se debe usar un tamaño de bloque de cinta bastante largo para obtener tasas de transferencia de datos aceptables sobre el bus SCSI.

2.  Muchos programas (por ejemplo, tar(1)) permiten al usuario especificar el tamaño de bloque en la línea de órdenes. Dese cuenta que esto determina el tamaño físico del bloque en la cinta sólo en el modo de bloque variable.

3.  Para usar unidades de cinta SCSI, el manejador básico de SCSI, el manejador de un adaptador SCSI y el manejador de cintas SCSI deben estar bien configurados dentro del núcleo o cargados como módulos. Si el manejador de cintas SCSI no está presente, se reconoce la unidad pero el soporte de cinta descrito en esta página no está disponible.

4.  El manejador escribe los mensajes de error a la consola/registro(log). Los códigos SENSE escritos en algunos mensajes se traducen automática a texto si se han habilitado en la configuración del núcleo los mensajes SCSI prolijos.

5.  The driver's internal buffering allows good throughput in fixed-block mode also with small read(2) and write(2) byte counts. With direct transfers this is not possible and may cause a surprise when moving to the 2.6 kernel. The solution is to tell the software to use larger transfers (often telling it to use larger blocks). If this is not possible, direct transfers can be disabled.

VÉASE TAMBIÉN
mt(1)

El fichero drivers/scsi/README.st o Documentation/scsi/st.txt (núcleo >= 2.6) de los fuentes del núcleo contiene la información más reciente del manejador y sus posibilidades de configuración.

COLOFÓN
Esta página es parte de la versión 5.10 del proyecto Linux man-pages. Puede encontrar una descripción del proyecto, información sobre cómo informar errores y la última versión de esta página en https://www.kernel.org/doc/man-pages/.

TRADUCCIÓN
La traducción al español de esta página del manual fue creada por Gerardo Aburruzaga García <gerardo.aburruzaga@uca.es> y Juan Piernas <piernas@ditec.um.es> Esta traducción es documentación libre; lea la GNU General Public License Version 3 (https://www.gnu.org/licenses/gpl-3.0.html) o posterior con respecto a las condiciones de copyright. No existe NINGUNA RESPONSABILIDAD. Si encuentra algún error en la traducción de esta página del manual, envíe un correo electrónico a debian-l10n-spanish@lists.debian.org>..