comando tctl

Propósito

Dá subcomandos a um dispositivo de fita de streaming.

Sintaxe

tctl [ -b BlockSize ] [ -f Dispositivo ] [ -p BufferSize ] [ -v ] [ -n ] [ -B ] { read | write }

Descrição

O comando tctl dá subcomandos a um dispositivo de fita de streaming. Se você não especificar a variável Dispositivo com a sinalização -f , a variável de ambiente TAPE é usada. Se a variável de ambiente não existir, o comando tctl usa o dispositivo /dev/rmt0.1 . (Quando o comando tctl dá o subcomando status , o dispositivo padrão é /dev/rmt0.) A variável Dispositivo deve especificar um dispositivo de fita cru (não bloco). O parâmetro Contagem especifica o número de marcadores de final de arquivo, número de marcas de arquivos ou número de registros. Se o parâmetro Contagem não for especificado, a contagem padrão será 1.

Subcomandos

Item	Descrição
eof ou weof	Grava o número de marcadores de final de arquivo especificados pelo parâmetro Count na posição atual na fita. Em uma unidade de fita 8 mm, um marcador de fim de arquivo pode ser escrito em três lugares: Antes da fita em branco Antes de uma marca de arquivo estendido Na marca de início-de-fita Em uma unidade de fita de 9 faixas, o marcador de fim de fita pode ser escrito em qualquer local da fita. No entanto, este subcomando não suporta sobrescretar blocos únicos de dados.
fsf	Move a fita para frente o número de marcas de arquivo especificado pelo parâmetro Contagem e posiciona-o no lado de fim de fita (EOT) da marca de arquivo.
bsf	Move a fita para trás o número de marcas de arquivo especificado pelo parâmetro Contagem e posiciona-a no lado início-de-fita (BOT) da marca de arquivo.
	Se o subcomando bsf move a fita passado o início, a fita rebate, e o comando tctl retorna EIO.
fsr	Move a fita para frente o número de registros especificados pelo parâmetro Count .
bsr	Move a fita para trás o número de registros especificados pelo parâmetro Contagem .
Rebobinar	Rebate a fita. O parâmetro Count é ignorado.
offline ou rewoffl	Rebobina a fita e torna a unidade de fita offline. Isso descarregará a fita quando apropriado. A fita deve ser reinserida para que o dispositivo possa ser usado novamente.
erase	Apaga todo o conteúdo na fita e rebate-a.
ler	Lê-se a partir do dispositivo de fita especificado (usando o tamanho de bloco especificado) até que o buffer interno esteja cheio e, em seguida, grava os dados na saída padrão, continuando a ler e a escrever desta forma até que uma marca de fim de arquivo (EOF) seja atingida.
reset	Envia um reset de dispositivo de barramento (BDR) para o dispositivo de fita. O BDR só será enviado se o dispositivo não puder ser aberto e não estiver ocupado.
retensão	Move a fita para o início, depois para o final, e depois volta para o início da fita. Se você tiver erros de leitura excessivos durante uma operação de restauração, você deverá executar o subcomando retensão . Se a fita tiver sido exposta a extremos ambientais, você deverá executar o subcomando retensão antes de gravar em fita. A unidade de fita 8 mm não responderá a este comando.
status	Imprime informações de status sobre o dispositivo de fita especificado.
gravar	Abre o dispositivo de fita, lê a partir de entrada padrão, e grava os dados no dispositivo de fita.

Dica: Quando você especificar o subcomando read ou write , o comando tctl abre o dispositivo de fita e configura o tamanho do bloco de fita conforme especificado pelo sinalizador -b ou -n . Se nenhuma bandeira for especificada, o comando tctl usa um tamanho de bloco padrão de 512 bytes.

Restrições:

O -b, -n, -p, e as bandeiras -v aplicam-se apenas ao usar os subcomandos read e write .
A sinalização -B se aplica apenas ao usar o subcomando read .

Sinalizações

Item	Descrição
-b BlockSize	Especifica, em bytes, o tamanho de buffer usado para ler e escrever para o dispositivo de fita, e também especifica, na ausência da sinalização -n , o tamanho do bloco de fita. Se o tamanho do bloco for 0, blocos de comprimento variável são usados e o tamanho do buffer de fita é 32.768. Se a sinalização -b não for especificada, o tamanho do bloco padrão e o tamanho do buffer de fita será 512 bytes.
-B	Grava o conteúdo do amortecedor a cada vez que a fita é lida. Configure esta sinalização ao ler registros de comprimento variável que não sejam de um tamanho regular e consistente.
-f Dispositivo	Especifica o dispositivo de fita.
-p BufferSize	Especifica o tamanho do buffer a ser usado na entrada padrão e na saída padrão. O tamanho do buffer padrão é 32.768 bytes. O valor BufferSize deve ser um múltiplo do tamanho do bloco de fita.
-v	Detalhado. Imprime os tamanhos de cada leitura e escreva para erro padrão.
-n	Especifica registros de comprimento variável ao ler ou escrever para fita com o subcomando read ou write .

Status de saída

Esse comando retorna os valores de saída a seguir:

Item	Descrição
0	Conclusão bem-sucedida.
>0	Ocorreu um erro.

Exemplos

Para rebobar o dispositivo de fita rmt1 , digite:
tctl -f /dev/rmt1 rewind
Para mover para frente duas marcas de arquivo no dispositivo de fita padrão, digite:
tctl fsf 2
Para escrever dois marcadores de final de arquivo na fita em /dev/rmt0.6, digite:
tctl -f /dev/rmt0.6 weof 2
Para ler um dispositivo de fita formatado em blocos de 80-byte bits e colocar o resultado em um arquivo, digite:
tctl -b 80 read > file
Para ler registros de comprimento variável a partir de um dispositivo de fita formatado em blocos de 80-byte bits e colocar o resultado em um arquivo, digite:
tctl -b 80 -n read > file
Para gravar registros de comprimento variável a um dispositivo de fita usando um tamanho de buffer de 1024 byes, digite:
cat file | tctl -b 1024 -n -f/dev/rmt1 write
Para gravar em um dispositivo de fita em blocos de 512-byte bits e usar um buffer de 5120-byte para entrada padrão, digite:
cat file | tctl -v -f /dev/rmt1 -p 5120 -b 512 write

Nota: Os únicos tamanhos de blocos válidos para unidades de fita de quartas de polegada (QIC) são 0 e 512.
Para escrever sobre um de vários backups em uma fita de 8 mm bits, posicione a fita no início do arquivo de backup e emita estes comandos:
tctl bsf 1 tctl eof 1

O primeiro comando move a fita para o lado de início de fita da marca de arquivo. O segundo comando reescreve a marca de arquivo, pois a escrita é permitida antes de marcas de arquivo estendidas. O cabeçote apagador da unidade apaga dados antes que a cabeça de gravação o atinja, assim, as subroutines write podem gravar sobre dados já na fita. No entanto, todos os dados antigos a seguir são perdidos porque seus marcadores de arquivo são sem sentido.

Nota: As subroutines write não podem escrever sobre uma curta marca de arquivo a menos que a fita em branco siga a marca de arquivo curto. Para escrever sobre os dados existentes, como no caso deste exemplo, a fita deve ser escrita com marcas de arquivo estendidas (conforme especificado através da interface SMIT).

Arquivos

Item	Descrição
/dev/rmt n	Especifica a interface de fita de streaming bruta.
/usr/bin/tctl	Contém o comando tctl .