.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH WATCH 1 2021\-04\-24 procps\-ng "Comandos de usuário"
.SH NOME
watch \- executa um programa periodicamente, mostrando saída em tela cheia
.SH SINOPSE
\fBwatch\fP [\fIopções\fP] \fIcomando\fP
.SH DESCRIÇÃO
\fBwatch\fP executa \fIcomando\fP repetidamente, exibindo a saída e os erros (o
primeiro de tela inteira). Isso permite que você acompanhe a mudança da
saída do programa ao longo do tempo. Por padrão, \fIcomando\fP é executado a
cada 2 segundos e \fBwatch\fP será executado até ser interrompido.
.SH OPÇÕES
.TP 
\fB\-d\fP, \fB\-\-differences\fP[=\fIpermanente\fP]
Realça as diferenças entre as atualizações sucessivas. Se o argumento
\fIpermanente\fP opcional for especificado, \fBwatch\fP vai mostrar todas as
alterações desde a primeira iteração.
.TP 
\fB\-n\fP, \fB\-\-interval\fP \fIsegundos\fP
Especifica o intervalo de atualização. O comando não permitirá um intervalo
mais rápido do que 0,1 segundo, no qual os valores menores são
convertidos. Ambos "." e "," funcionam para qualquer localidades. O ambiente
WATCH_INTERVAL pode ser usado para definir persistentemente um intervalo não
padrão (seguindo as mesmas regras e formatação).
.TP 
\fB\-p\fP, \fB\-\-precise\fP
Faz o \fBwatch\fP tentar executar o \fIcomando\fP a cada \fB\-\-interval\fP
\fIsegundos\fP. Experimente com \fBntptime\fP (se disponível) e perceba como os
segundos fracionários permanecem (quase) os mesmos, em oposição ao modo
normal onde aumentam continuamente.
.TP 
\fB\-t\fP, \fB\-\-no\-title\fP
Desligue o cabeçalho mostrando o intervalo, comando e tempo atual na parte
superior da tela, bem como a seguinte linha em branco.
.TP 
\fB\-b\fP, \fB\-\-beep\fP
Apita se o comando tem uma saída anormal, com código não zero.
.TP 
\fB\-e\fP, \fB\-\-errexit\fP
Congela atualizações quando houver um erro no comando, e sai após um tecla
ser pressionada.
.TP 
\fB\-g\fP, \fB\-\-chgexit\fP
Sai quando a saída de \fIcomando\fP alterar.
.TP 
\fB\-q\fP, \fB\-\-equexit\fP <cycles>
Exit when output of \fIcommand\fP does not change for the given number of
cycles.
.TP 
\fB\-c\fP, \fB\-\-color\fP
Interpreta cores ANSI e sequências de estilo.
.TP 
\fB\-x\fP, \fB\-\-exec\fP
Passa \fIcomando\fP para \fBexec\fP(2) em vez de \fBsh \-c\fP, o que reduz a
necessidade de usar aspas extras para obter o efeito desejado.
.TP 
\fB\-w\fP, \fB\-\-no\-wrap\fP
Desativa quebra de linha. Linhas longas serão truncadas em vez de quebradas
para a próxima linha.
.TP 
\fB\-h\fP, \fB\-\-help\fP
Exibe um texto de ajuda e sai.
.TP 
\fB\-v\fP, \fB\-\-version\fP
Exibe informação da versão e sai.
.SH "STATUS DE SAÍDA"
.PP
.RS
.PD 0
.TP 
\fB0\fP
Sucesso.
.TP 
\fB1\fP
Várias falhas.
.TP 
\fB2\fP
O fork do processo a ser assistido falhou.
.TP 
\fB3\fP
Substituição da stdout (saída padrão) do processo filho com pipe lateral de
escrita falhou.
.TP 
\fB4\fP
Execução do comando falhou.
.TP 
\fB5\fP
Encerramento do pipe de escrita do processo filho falhou.
.TP 
\fB7\fP
Criação de pipe IPC falhou.
.TP 
\fB8\fP
Obtenção de valor de retorno de processo filho com \fBwaitpid\fP(2) falhou, ou
o comando saiu com um erro.
.TP 
\fBoutro\fP
O watch vai propagar o status de saída do comando como status de saída de
filho.
.SH AMBIENTE
O comportamento de \fBwatch\fP é afetado pelas seguintes variáveis de ambiente.

.TP 
\fBWATCH_INTERVAL\fP
Intervalo de atualização, segue as mesmas regras da opção de linha de
comando \fB\-\-interval\fP.
.SH NOTAS
O processamento de opções POSIX é usado, ou seja, o processamento de opções
interrompe no primeiro argumento sem opção. Isso significa que as opções
após \fIcomando\fP não são interpretadas pelo próprio \fBwatch\fP.
.SH ERROS
Após o redimensionamento do terminal, a tela não será redesenhada
corretamente até a próxima atualização agendada. Todos os realces de
\fB\-\-differences\fP são perdidas nessa atualização também.

Caracteres não imprimíveis são removidos da saída do programa. Use \fBcat \-v\fP
como parte do pipeline de comando se você quiser vê\-los.

Caracteres de Combinação que devem ser exibidos no caractere na última
coluna na tela podem ser exibidos uma coluna antes ou podem não ser
exibidos.

Caracteres de Combinação nunca contam como diferente no modo
\fI\-\-differences\fP. Apenas só caracteres base contam.

As linhas em branco diretamente após uma linha que termina na última coluna
não são exibidas.

O modo \fI\-\-precise\fP ainda não possui tecnologia de distorção temporal
avançada para compensar um \fIcomando\fP que leva mais de \fB\-\-interval\fP
\fIsegundos\fP para executar. \fBwatch\fP também pode entrar em um estado no qual
ele dispara rapidamente tantas execuções do \fIcomando\fP quanto possível para
recuperar as execuções anteriores que funcionam por mais tempo que
\fB\-\-interval\fP (por exemplo, \fBnetstat\fP levando muito tempo em uma pesquisa
de DNS).
.SH EXEMPLOS
.PP
Para monitorar por correio, você pode fazer
.IP
watch \-n 60 from
.PP
Para assistir o conteúdo de um diretório mudar, você pode usar
.IP
watch \-d ls \-l
.PP
Se você está interessado apenas em arquivos pertencentes ao usuário fulano,
você pode usar
.IP
watch \-d 'ls \-l | fgrep fulano'
.PP
Para ver os efeitos das aspas, tente esses aqui
.IP
watch echo $$
.br
watch echo '$$'
.br
watch echo "'"'$$'"'"
.PP
Para ver o efeito da manutenção da precisão do tempo, tente adicionar \fB\-p\fP
a
.IP
watch \-n 10 sleep 1
.PP
Você pode assistir seu administrador para instalar o kernel mais recente com
.IP
watch uname \-r
.PP
(Note que não há garantia de que \fB\-p\fP funcione entre reinicializações,
especialmente em face de \fBntpdate\fP (se disponível) ou outros mecanismos de
mudança de tempo quando da inicialização)