.\" -*- coding: UTF-8 -*-
.\" Copyright 1995 Robert K. Nichols (Robert.K.Nichols@att.com)
.\" Copyright 1999-2005 Kai Mäkisara (Kai.Makisara@kolumbus.fi)
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH st 4 "31 outubro 2023" "Linux man\-pages 6.06" 
.SH NOME
st \- Dispositivo de Fita SCSI
.SH SINOPSE
.nf
\fB#include <sys/mtio.h>\fP
.P
\fBint ioctl(int \fP\fIfd\fP\fB, int \fP\fIrequest\fP\fB [, (void *)\fP\fIarg3\fP\fB]);\fP
\fBint ioctl(int \fP\fIfd\fP\fB, MTIOCTOP, (struct mtop *)\fP\fImt_cmd\fP\fB);\fP
\fBint ioctl(int \fP\fIfd\fP\fB, MTIOCGET, (struct mtget *)\fP\fImt_status\fP\fB);\fP
\fBint ioctl(int \fP\fIfd\fP\fB, MTIOCPOS, (struct mtpos *)\fP\fImt_pos\fP\fB);\fP
.fi
.SH DESCRIÇÃO
O controlador \fBst\fP provê a interface para vários dispositivos de fita
SCSI. Atualmente, o controlador controla todos os dispositivos detectados do
tipo \[lq]acesso\-seqüencial\[rq]. O controlador \fBst\fP usa o número de
dispositvo principal 9.
.P
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, \fIn\fP, and the \[lq]no\-rewind\[rq] device numbers, (\fIn\fP +
128).  Devices opened using the principal device number will be sent a
\fBREWIND\fP command when they are closed.  Devices opened using the
\[lq]no\-rewind\[rq] 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).
.P
Em cada grupo, quatro números menores estão disponíveis para definir
dispositivos com características diferentes (tamanho do bloco, compressão,
densidade, etc). Quando o sistema inicia, apenas o primeiro dispositivo está
disponível. Os outros três são ativados quando as características padrões
são definidas (veja abaixo). (Alterando as constantes durante a compilação,
é possível mudar o balanço entre o número máximo de unidades de fita e o
número de número de dispositivo secundário para cada unidade. A alocação
padrão permite controlar 32 unidades de fita. Por exemplo, é possível
controlar até 64 unidades com dois números secundários para diferentes
opções).
.P
Os dispositivos são tipicamente criados por:
.P
.in +4n
.EX
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
.EE
.in
.P
Não há dispositivos de bloco correspondentes.
.P
The driver uses an internal buffer that has to be large enough to hold at
least one tape block.  Before Linux 2.1.121, the buffer is allocated as one
contiguous block.  This limits the block size to the largest contiguous
block of memory the kernel allocator can provide.  The limit is currently
128\ kB for 32\-bit architectures and 256\ kB for 64\-bit architectures.  In
newer kernels the driver allocates the buffer in several parts if
necessary.  By default, the maximum number of parts is 16.  This means that
the maximum block size is very large (2\ MB if allocation of 16 blocks of
128\ kB succeeds).
.P
The driver's internal buffer size is determined by a compile\-time constant
which can be overridden with a kernel startup option.  In addition to this,
the driver tries to allocate a larger temporary buffer at run time if
necessary.  However, run\-time allocation of large contiguous blocks of
memory may fail and it is advisable not to rely too much on dynamic buffer
allocation before Linux 2.1.121 (this applies also to demand\-loading the
driver with kerneld or kmod).
.P
O controlador não suporta especificamente qualquer marca ou modelo de
unidade de fita. Depois que o sistema inicia, as opções do dispositivo de
fita são definidas pelo firmware da unidade. Por exemplo, se o 'firmware'
seleciona o modo de blocagem fixa, a unidade de fita usará este modo. As
opções podem ser alteradas com chamadas \fBioctl\fP(2) explícitas e mantidas em
efeito quando o dispositivo é fechado e reaberto. As opções definidas
afetam, tanto os dispositivos com auto\-rebobinamento, quanto os sem
rebobinamento.
.P
Opções diferentes podem ser especificadas para dispositivos diferentes,
dentro de um subgrupo de quatro. As opções fazem efeito quanto o dispositivo
é aberto. Por exemplo, o administrador do sistema pode definir um
dispositivo que grava em blocos fixos com uma certa blocagem e outro que
grava em blocos variáveis (se a unidade suportar ambos os modos).
.P
O controlador suporta \fBpartições\fP se a unidade de fita suportá\-las. (As
partições em fita não tem nada ver com as partições em disco. Uma fita
particionada pode ser vista como várias fitas lógicas.) O suporte a
partições tem que ser habilitado com um \fBioctl\fP(2). A localização da fita é
preservada em cada partição através das alterações na partição. A partição
usada para operações subseqüentes, é selecionada com um \fBioctl\fP(2). A
mudança de partição é executada junto com a próxima operação para evitar
movimento desnecessário da fita. O número máximo de partições um uma fita é
definido por uma constante durante a compilação (originalmente quatro). O
controlador contém um \fBioctl\fP(2) que pode formatar uma fita com uma ou duas
partições.
.P
O dispositivo \fI/dev/tape\fP é geralmente criado como um vínculo símbólico ou
fixo para o dispositivo de fita padrão no sistema.
.P
Starting from Linux 2.6.2, the driver exports in the sysfs directory
\fI/sys/class/scsi_tape\fP the attached devices and some parameters assigned to
the devices.
.SS "Data transfer"
O controlador suporta operações nos modos de blocagem fixa e variável (se
suportado pela unidade). No modo de blocagem fixa a unidade grava blocos de
tamanho específico e o tamanho do bloco não é dependente do contador de
bytes gravados, usado pelas chamadas do sistema. No modo de blocagem
variável, um bloco é gravado para cada chamada de gravação e o contador de
bytes determina o tamanho do bloco. Observe que os blocos na fita, não
contém quaisquer informações sobre o mode de gravação. Durante a leitura, o
importante é usar comandos que aceitam o tamanho dos blocos gravados.
.P
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.
.P
In fixed\-block mode the read byte counts can be arbitrary if buffering is
enabled, or a multiple of the tape block size if buffering is disabled.
Before Linux 2.1.121 allow writes with arbitrary byte count if buffering is
enabled.  In all other cases (before Linux 2.1.121 with buffering disabled
or newer kernel) the write byte count must be a multiple of the tape block
size.
.P
In Linux 2.6, 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.
.P
Um marcador de arquivo é automáticamente gravado na fita se a última
operação na fita antes de fechá\-la foi uma gravação.
.P
Quando um marcador de arquivo é encontrado enquanto lendo, a seguinte é
comcluído. Se houver dados no 'buffer' quando um marcador de arquivo é
encontrado, estes dados serão retornados. A próxima leitura retornará zero
bytes. A leitura seguinte retornará os dados do próximo arquivo. O fim dos
dados gravados é sinalizado pelo retorno de zero bytes durante duas leituras
consecutivas. A terceira leitura retornará um erro.
.SS Ioctls
O controlador suporta três requisitos \fBioctl\fP(2). Os requisitos não
reconhecidos pelo controlador \fBst\fP são passados para o controlador
\fBSCSI\fP. As definições abaixo são do \fI/usr/include/linux/mtio.h\fP:
.SS "MTIOCTOP \[em] executa uma operação de fita"
Este requisito leva um argumento do tipo \fI(struct mtop\ *)\fP. Nem todos as
unidades suportam todas as operações. O controlador retorna um erro \fBEIO\fP
se a unidade rejeitar uma operação.
.P
.in +4n
.EX
/* Structure for MTIOCTOP \- mag tape op command: */
struct mtop {
    short   mt_op;       /* operations defined below */
    int     mt_count;    /* how many of them */
};
.EE
.in
.P
Operações de fita magnéticas para uso normal:
.TP 
\fBMTBSF\fP
Retrocede espaços sobre \fImt_count\fP marcadores de arquivos.
.TP 
\fBMTBSFM\fP
Retrocede espaços sobre \fImt_count\fP marcadores de arquivos. Reposiciona a
fita no lado EOT último marcador de arquivo.
.TP 
\fBMTBSR\fP
Retrocede espaços sobre \fImt_count\fP registros (blocos da fita).
.TP 
\fBMTBSS\fP
Retrocede espaços sobre \fImt_count\fP setmarks.
.TP 
\fBMTCOMPRESSION\fP
Habilita compressão de dados se \fImt_count\fP não for zero e desabilita a
compressão se \fImt_count\fP é zero. Este comando usa o MODO page 15 suportado
pela maioria das fitas DATs.
.TP 
\fBMTEOM\fP
Vai para o final da mídia gravada (para acrescentar arquivos).
.TP 
\fBMTERASE\fP
Erase tape.  With Linux 2.6, short erase (mark tape empty) is performed if
the argument is zero.  Otherwise, long erase (erase all) is done.
.TP 
\fBMTFSF\fP
Avança \fImt_count\fP marcadores de arquivos.
.TP 
\fBMTFSFM\fP
Avança \fImt_count\fP marcadores de arquivos. Reposiciona a fita no lado BOT do
último marcado de arquivo.
.TP 
\fBMTFSR\fP
Avança espaços sobre \fImt_count\fP registro (blocos da fita).
.TP 
\fBMTFSS\fP
Avança espaços sobre \fImt_count\fP setmarks.
.TP 
\fBMTLOAD\fP
Executa o comando load SCSI. Um caso especial está disponível para alguns
carregadores automáticos HP. Se \fImt_count\fP é a constante
\fBMT_ST_HPLOADER_OFFSET\fP mais um número, o número é enviando para a unidade
controlar a carga automática.
.TP 
\fBMTLOCK\fP
Bloqueia a porta da unidade de fita.
.TP 
\fBMTMKPART\fP
.\" commit 8038e6456a3e6f5c4759e0d73c4f9165b90c93e7
Format the tape into one or two partitions.  If \fImt_count\fP is positive, it
gives the size of partition 1 and partition 0 contains the rest of the
tape.  If \fImt_count\fP is zero, the tape is formatted into one partition.
From Linux 4.6, a negative \fImt_count\fP 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
\fBMT_ST_CAN_PARTITIONS\fP below).
.TP 
\fBMTNOP\fP
Nenhuma operação\[em]descarrega o 'buffer' do controlador. Ele pode ser
usado antes de ler o estado com \fBMTIOCGET\fP.
.TP 
\fBMTOFFL\fP
Rebobina a fita e coloca a unidade fora de linha.
.TP 
\fBMTRESET\fP
Reinicia a unidade.
.TP 
\fBMTRETEN\fP
Retensiona a fita.
.TP 
\fBMTREW\fP
Rebobina.
.TP 
\fBMTSEEK\fP
Posiciona no número de bloco especificado em \fImt_count\fP. Esta operação
requer uma unidade SCSI\-2 que suporte o comando \fBLOCATE\fP (endereço de
dispositivo específico) ou uma unidade Tandberg\-compatível SCSI\-1 (Tandberg,
Archive Viper, Wangtek, ... ). O número do bloco deverá ser aquele
previamente retornado pelo \fBMTIOCPOS\fP se o endereço específico do
dispositivo foi usado.
.TP 
\fBMTSETBLK\fP
Define o tamanho do bloco para o valor especificado em \fImt_count\fP. Um
tamanho de zero define o modo de bloco de tamanho variável.
.TP 
\fBMTSETDENSITY\fP
Define a densidade para o código em \fImt_count\fP. O código de densidade
suportado pela unidade pode ser encontrado na documentação da unidade.
.TP 
\fBMTSETPART\fP
A partição é alternada para \fImt_count\fP. As partições são numeradas a partir
de zero. Este comando não é permitido em uma unidade, a menos que o suporte
a partições esteja habilitado (veja \fBMT_ST_CAN_PARTITIONS\fP abaixo).
.TP 
\fBMTUNLOAD\fP
Executa o comando SCSI unload (não ejeta a fita).
.TP 
\fBMTUNLOCK\fP
Desbloqueia a porta da unidade de fita.
.TP 
\fBMTWEOF\fP
Grava \fImt_count\fP marcadores de arquivos.
.TP 
\fBMTWSM\fP
Grava \fImt_count\fP setmarks.
.P
Operações de Fita Magnética para configurar opções de dispositivo
(superusuário):
.TP 
\fBMTSETDRVBUFFER\fP
Set various drive and driver options according to bits encoded in
\fImt_count\fP.  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 since Linux 2.1).  A single operation can affect
only one item in the list below (the Booleans counted as one item.)
.IP
Um valor zero nos 4 bits de alta órdem será usado para definir o modo de
buferização da unidade de fita. Os modos de buferização são:
.RS
.TP 
\fB0\fP
A unidade não informará o estado \fBGOOD\fP nos comandos de gravação até que os
blocos de dados sejam gravados na mídia.
.TP 
\fB1\fP
A unidade informará o estado \fBGOOD\fP nos comandos de gravação assim que
todos os dados tenham sido transferidos do 'buffer' interno da unidade.
.TP 
\fB2\fP
A unidade pode informar o estado \fBGOOD\fP nos comandos de gravação assim que:
(a) os dados foram transferido do 'buffer' interno da unidade e (b) todos os
dados em 'buffer's de inicializadores diferentes foram gravados com sucesso
para a mídia.
.RE
.IP
To control the write threshold the value in \fImt_count\fP must include the
constant \fBMT_ST_WRITE_THRESHOLD\fP 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).
.IP
To set and clear the Boolean options the value in \fImt_count\fP must include
one of the constants \fBMT_ST_BOOLEANS\fP, \fBMT_ST_SETBOOLEANS\fP,
\fBMT_ST_CLEARBOOLEANS\fP, or \fBMT_ST_DEFBOOLEANS\fP bitwise ORed with whatever
combination of the following options is desired.  Using \fBMT_ST_BOOLEANS\fP
the options can be set to the values defined in the corresponding bits.
With \fBMT_ST_SETBOOLEANS\fP the options can be selectively set and with
\fBMT_ST_DEFBOOLEANS\fP selectively cleared.
.IP
As opções padrões para um dispositivo de fita podem ser definidas com
\fBMT_ST_DEFBOOLEANS\fP. Um dispositivo de fita inativo (i.e., um dispositivo
com número menor 32 ou 160) é ativado quando as opções padrões para ele são
definidas na primeira vez. Um dispositivo ativado herda daquele ativado na
inicialização as opções não definidas explicitamente.
.IP
As opções Booleanas são:
.RS
.TP 
\fBMT_ST_BUFFER_WRITES\fP  (Padrão: true)
Coloca no 'buffer' todas as operações de gravação usando a blocagem fixa. Se
esta opção é false e a unidade usa um bloco de tamanho fixo, então todas as
operações de gravação devem usar um múltiplo do tamanho do bloco. Esta opção
deve ser definida como falsa para se obter uma gravação confiável em
sistemas multi\-volumes.
.TP 
\fBMT_ST_ASYNC_WRITES\fP  (Padrão: true)
Quando esta opção é verdadejra, a operação de gravação retorna imediatamente
sem esperar que os dados sejam transferidos para a unidade se os dados estão
ajustados dentro do 'buffer' da unidade. O limite de gravação determina
quando o 'buffer' está cheio mas depois um novo comando de escrita SCSI é
usado. Quaisquer erros relatados pela unidade serão retidos até a próxima
operação. Esta opção deve ser definida como falsa para se obter uma gravação
confiável em sistemas multi\-volumes.
.TP 
\fBMT_ST_READ_AHEAD\fP  (Padrão: true)
Esta opção faz o controlador prover leitura buferizada e leitura a frente em
blocos fixos. Se esta opção é false e a unidade usa um tamanho de bloco
fixo, todas as operações de leitura devem ser múltiplos do tamanho do bloco.
.TP 
\fBMT_ST_TWO_FM\fP  (Padrão: false)
Esta opção modifica as características do controlador quando um arquivo é
fechado. A ação normal é gravar uma marca de arquivo simples. Se esta opção
é true o controlador gravará duas marcas de arquivo e um caracter de
retrocesso sobre a última marca.
.IP
Nota: Esta opção não pode ser true para unidades de fita QIC uma vez que
elas não podem sobrescrever a marca de arquivo. Estas unidades detetam o
final dos dados gravados testando se a fita está em branco. A maioria das
unidades atuais também detetam o final dos dados gravados e o uso das duas
marcas de arquivo são necessária apenas quando há intercambio de fita com
outros sistemas.
.TP 
\fBMT_ST_DEBUGGING\fP  (Padrão: false)
Esta opção ativa várias mensagens de depuração de erros do controlador (só
tem efeito se o controlador foi compilado com \fBDEBUG\fP definido com valor
diferente de zero).
.TP 
\fBMT_ST_FAST_EOM\fP  (Padrão: false)
This option causes the \fBMTEOM\fP operation to be sent directly to the drive,
potentially speeding up the operation but causing the driver to lose track
of the current file number normally returned by the \fBMTIOCGET\fP request.  If
\fBMT_ST_FAST_EOM\fP is false, the driver will respond to an \fBMTEOM\fP request
by forward spacing over files.
.TP 
\fBMT_ST_AUTO_LOCK\fP (Padrão: false)
When this option is true, the drive door is locked when the device file is
opened and unlocked when it is closed.
.TP 
\fBMT_ST_DEF_WRITES\fP (Padrão: false)
As opções da fita (tamanho do bloco, modo, compressão, etc.) pode variar
quando muda\-se de um dispositivo vinculado a uma unidade, para outro
vinculado a mesma unidade dependendo de como os dispositivos estão
definidos. Esta opção define quando as mudanças são forçadas pelo
controlador através de comandos SCSI e quando a unidade auto\-deteta que as
capacidades são confiáveis. Se esta opção é false, o controlador envia os
comandos SCSI imediatamente quando o dispositivo é alterado. Se a opção é
true, os comandos SCSI não são enviados até que uma gravação seja
requisitada. Neste caso o firmware da unidade tem permissão para detetar a
estrutura da fita durante a leitura e os comandos SCSI são usados apenas
para certificar\-se que a fita é gravada de acordo com a especificação
correta.
.TP 
\fBMT_ST_CAN_BSR\fP (Padrão: false)
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 Linux 2.6, the default is true for drives
supporting SCSI\-3.
.TP 
\fBMT_ST_NO_BLKLIMS\fP (Padrão: false)
Algumas unidades não aceitam o comando \fBSCSI READ BLOCK LIMITS\fP. Se ele é
usado, o controlador não usá\-o. A desvantagem é que o controlador não pode
checar antes de enviar os comandos se o tamanho de bloco selecionado é
aceitável pela unidade de fita.
.TP 
\fBMT_ST_CAN_PARTITIONS\fP (Padrão: false)
Esta opção habilita o suporte a várias partições em uma fita. Ela aplica\-se
a todos os dispositivos vinculados à unidade.
.TP 
\fBMT_ST_SCSI2LOGICAL\fP (Padrão: false)
Esta opção instrui o controlador a usar o endereço lógico de bloco definido
no padrão SCSI\-2 durante as operações de procura e ( com os comandos
\fBMTSEEK\fP e \fBMTIOCPOS\fP e durante alterações na partição). Do contrário o
endereço específico do dispositivo é usado. É altamente recomendável definir
esta opção se a unidade suporta os endereços lógicos, porque eles também
contam as marcas de arquivo. Há algumas unidades que só suportam o
endereçamento lógico de bloco.
.TP 
\fBMT_ST_SYSV\fP (Padrão: false)
Quando esta opção é habilitada, o dispositivo de fita usa a semântica do
System V. Do contrário a do BSD é usada. A diferença mais importante entre
as semânticas é o que acontece quando um dispositivo usado para leitura é
fechado: na semântica System V a fita é avançada para a próxima marca de
arquivo se a mesma não foi encontrada durante a utilização do
dispositivo. Na semântica BSD a posição da fita não se altera.
.TP 
\fBMT_ST_NO_BLKLIMS\fP (Padrão: false)
Enables immediate mode (i.e., don't wait for the command to finish) for some
commands (e.g., rewind).
.P
An example:
.P
.in +4n
.EX
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);
.EE
.in
.P
O tamanho padrão do bloco para um dispositivo pode ser definido com
\fBMT_ST_DEF_BLKSIZE\fP e a densidade padrão com \fBMT_ST_DEFDENSITY\fP. Uma
operação OU é executada entre os valores dos parâmetros e o código da
operação.
.P
With Linux 2.1.x and later, the timeout values can be set with the
subcommand \fBMT_ST_SET_TIMEOUT\fP ORed with the timeout in seconds.  The long
timeout (used for rewinds and other commands that may take a long time) can
be set with \fBMT_ST_SET_LONG_TIMEOUT\fP.  The kernel defaults are very long to
make sure that a successful command is not timed out with any drive.
Because of this, the driver may seem stuck even if it is only waiting for
the timeout.  These commands can be used to set more practical values for a
specific drive.  The timeouts set for one device apply for all devices
linked to the same drive.
.P
Starting from Linux 2.4.19 and Linux 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 \fBMT_ST_SEL_CLN\fP
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\[en]17 are reserved.  If the lowest eight bits
are >= 18, bits from the extended sense data are used.  The bits
9\[en]16 specify a mask to select the bits to look at and the bits 17\[en]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.
.RE
.SS "MTIOCGET \[em] obtém o estado"
Esta requisição leva um argumento do tipo \fI(struct mtget\ *)\fP.
.P
.in +4n
.EX
/* structure for MTIOCGET \- mag tape get status command */
struct mtget {
    long     mt_type;
    long     mt_resid;
    /* the following registers are device dependent */
    long     mt_dsreg;
    long     mt_gstat;
    long     mt_erreg;
    /* The next two fields are not always used */
    daddr_t  mt_fileno;
    daddr_t  mt_blkno;
};
.EE
.in
.TP 
\fImt_type\fP
Arquivo cabeçalho define vários valores para \fImt_type\fP, mas o controlador
atual só informa os tipos genéricos \fBMT_ISSCSI\fP (Fita SCSI\-1 genérica) e
\fBMT_ISSCSI\fP (Fita SCSI\-2 genérica).
.TP 
\fImt_resid\fP
contém o número da partição da fita atual.
.TP 
\fImt_dsreg\fP
reports the drive's current settings for block size (in the low 24 bits) and
density (in the high 8 bits).  These fields are defined by
\fBMT_ST_BLKSIZE_SHIFT\fP, \fBMT_ST_BLKSIZE_MASK\fP, \fBMT_ST_DENSITY_SHIFT\fP, and
\fBMT_ST_DENSITY_MASK\fP.
.TP 
\fImt_gstat\fP
dá informações genéricas do estado (independente do dispositivo). O arquivo
cabeçalho define macros para testar estes bits de estado:
.RS
.TP 
\fBGMT_EOF\fP(\fIx\fP)
A fita está posicionada após a marca de arquivo (sempre false após uma
operação \fBMTSEEK\fP).
.TP 
\fBGMT_BOT\fP(\fIx\fP)
A fita está posicionada no inicio do primeiro arquivo (sempre false após uma
operação \fBMTSEEK\fP).
.TP 
\fBGMT_EOT\fP(\fIx\fP)
Uma operação da fita alcançou o final físico da Fita.
.TP 
\fBGMT_SM\fP(\fIx\fP)
A fita está posicionada na setmark (sempre false após uma operação
\fBMTSEEK\fP).
.TP 
\fBGMT_EOD\fP(\fIx\fP)
A fita está posicionada no final do dado gravado.
.TP 
\fBGMT_WR_PROT\fP(\fIx\fP)
A unidade está protegida contra gravação. Para algumas unidades isto pode
significar que a mesma não suporta gravação no tipo mídia atual.
.TP 
\fBGMT_ONLINE\fP(\fIx\fP)
O último \fBopen\fP(2) encontrou uma fita na unidade e pronta para operação.
.TP 
\fBGMT_D_6250\fP(\fIx\fP)
.TQ
\fBGMT_D_1600\fP(\fIx\fP)
.TQ
\fBGMT_D_800\fP(\fIx\fP)
Reporta informações de estado \[lq]genéricas\[rq] sobre a densidade atual
definida em 9\-track \(Apenas para unidades de fita de \(12".
.TP 
\fBGMT_DR_OPEN\fP(\fIx\fP)
A unidade não contém uma fita.
.TP 
\fBGMT_IM_REP_EN\fP(\fIx\fP)
Modo de Informação Imediata. Este bit é definido se não há garantias que os
foram fisicamente gravados na fita quando a chamada de gravação retorna. Ele
é definido zero apenas quando o controlador não buferiza os dados e a
unidade está definida para não colocar os dados no 'buffer'.
.TP 
\fBGMT_CLN\fP(\fIx\fP)
The drive has requested cleaning.  Implemented since Linux 2.4.19 and Linux
2.5.43.
.RE
.TP 
\fImt_erreg\fP
O único campo definido em \fImt_erreg\fP é o contador de erros recuperados, nos
16 bits de baixa órdem (como definido por \fBMT_ST_SOFTERR_SHIFT\fP e
\fBMT_ST_SOFTERR_MASK\fP). Devido a inconsistências na forma como as unidades
informam os erros recuperados, o contador freqüentemente não é mantido (a
maioria das unidades não informam por padrão erros de programas, mas isto
pode ser alterado com o comando SCSI MODE SELECT).
.TP 
\fImt_fileno\fP
Informa o número atual do arquivo (base\-zero). Este valor é \-1 quando o
número do arquivo é desconhecido (por exemplo, depois de \fBMTBSS\fP ou
\fBMTSEEK\fP).
.TP 
\fImt_blkno\fP
Informa o número de bloco (base\-zero) do arquivo atual. Este valor é \-1
quando o número do bloco é desconhecido (por exemplo, depois de \fBMTBSF\fP,
\fBMTBSS\fP, ou \fBMTSEEK\fP).
.SS "MTIOCPOS \[EM] obtém a posição da fita"
This request takes an argument of type \fI(struct mtpos\ *)\fP and reports the
drive's notion of the current tape block number, which is not the same as
\fImt_blkno\fP returned by \fBMTIOCGET\fP.  This drive must be a SCSI\-2 drive that
supports the \fBREAD POSITION\fP command (device\-specific address)  or a
Tandberg\-compatible SCSI\-1 drive (Tandberg, Archive Viper, Wangtek, ... ).
.P
.in +4n
.EX
/* estrutura para MTIOCPOS \- comando para obter a posição da fita */
struct mtpos {
    long mt_blkno;    /* número do bloco atual */
};
.EE
.in
.SH "VALOR DE RETORNO"
.TP 
\fBEACCES\fP
Tentando gravar ou apagar um fita com proteção a gravação. (Este erro não é
detetado durante um \fBopen\fP(2).)
.TP 
\fBEBUSY\fP
O dispositivo já está em uso ou o controlador não conseguiu alocar um
\&'buffer'.
.TP 
\fBEFAULT\fP
Os parâmetros do comando apontam para memória que não pertencem ao processo
chamado.
.TP 
\fBEINVAL\fP
Um \fBioctl\fP(2) tem um argumento ilegal ou o tamanho do bloco requisita é
ilegal.
.TP 
\fBEIO\fP
A operação solicitada não pode ser concluida.
.TP 
\fBENOMEM\fP
.\" Precisely: Linux 2.6.0-test6
The byte count in \fBread\fP(2)  is smaller than the next physical block on the
tape.  (Before Linux 2.2.18 and Linux 2.4.0 the extra bytes have been
silently ignored.)
.TP 
\fBENOSPC\fP
Uma operação de gravação não pode ser concluida porque a fita chegou no
final físico.
.TP 
\fBENOSYS\fP
\fBioctl\fP(2) desconhecido.
.TP 
\fBENXIO\fP
Durante a abertura o dispositivo de fita não existe.
.TP 
\fBEOVERFLOW\fP
Tentou ler ou gravar um bloco de tamanho variável que é maior do que o
\&'buffer' interno da unidade.
.TP 
\fBEROFS\fP
Tentativa de abrir com \fBO_WRONLY\fP ou \fBO_RDWR\fP quando a fita na unidade
está protegida contra gravação.
.SH ARQUIVOS
.TP 
\fI/dev/st*\fP
Dispositivo de fita SCSI com auto\-rebobinamento
.TP 
\fI/dev/nst*\fP
.\" .SH AUTHOR
.\" The driver has been written by Kai M\(:akisara (Kai.Makisara@metla.fi)
.\" starting from a driver written by Dwayne Forsyth.
.\" Several other
.\" people have also contributed to the driver.
Dispositivo de fita SCSI sem auto\-rebobinamento
.SH NOTAS
.IP \[bu] 3
When exchanging data between systems, both systems have to agree on the
physical tape block size.  The parameters of a drive after startup are often
not the ones most operating systems use with these devices.  Most systems
use drives in variable\-block mode if the drive supports that mode.  This
applies to most modern drives, including DATs, 8mm helical scan drives,
DLTs, etc.  It may be advisable to use these drives in variable\-block mode
also in Linux (i.e., use \fBMTSETBLK\fP or \fBMTSETDEFBLK\fP at system startup to
set the mode), at least when exchanging data with a foreign system.  The
drawback of this is that a fairly large tape block size has to be used to
get acceptable data transfer rates on the SCSI bus.
.IP \[bu]
Muitos programas (por exemplo, \fBtar\fP(1)) permitem ao usuário especificar o
fator de bloco na linha de comando. Note que isto determina o tamanho do
bloco físico na fita apenas no modo de bloco variável.
.IP \[bu]
Para poder usar unidades SCSI, o controlador SCSI básico, o controlador da
placa SCSI e o controlador para fita SCSI deve ser compilado no Linux ou
carregado como módulo. Se o controlador para fita SCSI não estiver presente,
a unidade é reconhecida, mas o suporte descrito nesta página não está
disponível.
.IP \[bu]
O controlador grava as mensagens de erro no console/log. Os códigos escritos
em algumas mensagens são automáticamente traduzidos para texto se a exibição
das mensagens SCSI está habilitada na compilação do Linux.
.IP \[bu]
The driver's internal buffering allows good throughput in fixed\-block mode
also with small \fBread\fP(2)  and \fBwrite\fP(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.
.SH "VEJA TAMBÉM"
\fBmt\fP(1)
.P
The file \fIdrivers/scsi/README.st\fP or \fIDocumentation/scsi/st.txt\fP (kernel
>= 2.6) in the Linux kernel source tree contains the most recent
information about the driver and its configuration possibilities
.PP
.SH TRADUÇÃO
A tradução para português brasileiro desta página man foi criada por
Fábio Henrique F. Silva <fabiohfs@mail.com>
e
Carlos Augusto Horylka <horylka@conectiva.com.br>
.
.PP
Esta tradução é uma documentação livre; leia a
.UR https://www.gnu.org/licenses/gpl-3.0.html
Licença Pública Geral GNU Versão 3 
.UE
ou posterior para as condições de direitos autorais.
Nenhuma responsabilidade é aceita.
.PP
Se você encontrar algum erro na tradução desta página de manual,
envie um e-mail para
.MT debian-l10n-portuguese@lists.debian.org
a lista de discussão de tradutores
.ME .