Provided by: manpages-pt_20040726-4_all bug

NOME

       touch - altera o rotulo de tempo do arquivo

SINOPSE

       touch [-acm][-r ref_file|-t time] file...

       Versao obsoleta:
       touch [-acm][ugly_time] file...

       Versao GNU:
       touch     [-acfm]     [-r    file]    [-t    decimtime]    [-d    time]
       [--time={atime,access,use,mtime,modify}]                  [--date=time]
       [--reference=file] [--no-create] [--help] [--version] [--] file...

DESCRI,C~AO

       touch  altera  o acesso e/ou os rotulos de tempo de modificacao de cada
       arquivo especificado.  Estes rotulos de  tempo  sao  alterados  para  o
       tempo  atual,  a  menos  que a opcao -r option seja especificada, neste
       caso eles sao alterados para os rotulos de tempo  correspondentes  para
       as  do  arquivo arquivo_de_refer^encia, ou se a opcao -t e especificada,
       neste caso eles sao alteradas para  o  tempo  especificado.   Ambas  as
       datas  sao  alteradas  quando  nenhuma  ou  ambas  opcoes  -a  e -m sao
       fornecidas. Somente a data de acesso ou somente a data de alteracao sao
       alteradas  quando  uma da opcoes -a e -m e fornecida.  Se o arquivo nao
       existe ainda, ele e criado (como um arquivo  vazio  com  o  modo  0666,
       modificado pelo bits da umask), a menos que a opcao -c seja fornecida.

OP,C~OES POSIX

       -a     Altera a data de acesso do arquivo.

       -c     Nao cria o arquivo.

       -m     Altera a data de modificacao do arquivo.

       -r arquivo_de_refer^encia
              Usa  o  rotulo  de tempo correspondente do arquivo_de_refer^encia
              como o novo valor para o(s) rotulo(s) de tempo alterado.

       -t time
              Usa a data especificada como novo valor para o(s)  rotulo(s)  de
              tempo alterado.  O argumento e um numero decimal na forma
                  [[CC]YY]MMDDhhmm[.SS]
              com  significado  obvio.  Se CC nao e especificado, o ano CCYY e
              considerado  no  intervalo  de   1969-2068.    SE   SS   nao   e
              especificado,   ele   e   considerado   como  0.  Ele  pode  ser
              especificado no intervalo 0-61 de forma que isto e  possivel  se
              referir  a  saltos de segundos.  A data resultante e considerada
              como a data para o fuso horario especificado  pela  variavel  de
              ambiente TZ. E errado se a data resultante antecede 1 de Janeiro
              de 1970.

DETALHES POSIX

       A segunda forma de se invocar  tem  a  desvantagem  que  existe  alguma
       ambiguidade  se  ugly_time e um tempo ou um argumento do arquivo. Ele e
       considerado como  uma  data  quando  as  opcoes  -r  ou  -t  nao  estao
       presentes,  ha  pelo menos dois arqumentos, e o primeiro argumento e um
       numero inteiro na base octal ou decimal.   O  formato  de  ugly_time  e
       MMDDhhmm[yy],  onde  o  yy  no  intervalo  66-99  denota  um  ano entre
       1969-1999, e um yy sem especificacao denota o ano atual.  Esta forma  e
       obsoleta.

DETALHES GNU

       Se  o  primeiro arquivo fosse um argumento valido para a opcao -t e nao
       nenhum rotulo de tempo fosse fornecido com qualquer das opcoes  -d,  -r
       ou  -t  e  o  argumento  '--'  nao  for  fornecido,  aquele argumento e
       interpretado como a data para os outros arquivos.

       Se alterando a data de acesso e data de modificacao, para o tempo atual
       touch pode alterar a marca de tempo para arquivos que o usuario executa
       mas nao lhe pertencem embora  tenha  permissao  de  escrita.  De  outra
       forma, o usuario tera que ser dono dos arquivos.

OP,C~OES GNU

       -a, --time=atime, --time=accesso, --time=use
              Altera somente a data de acesso.

       -c, --no-create
              Nao cria arquivos que nao existem.

       -d, --date=tempo
              Usa  tempo  no  lugar  do  tempo  atual. Ele pode conter nome de
              meses, fusos horarios, 'am' e 'pm', etc.

       -f     Ignorado; para compatibilidade com as  versoes  BSD  do  comando
              touch(1).

       -m, --time=mtime, --time=modifica,c~ao
              Altera somente a data de modificacao.

       -r arquivo, --reference=arquivo
              Usa a data referenciada no arquivo no lugar do tempo atual.

       -t tempo_decimal
              Aqui  tempo_decimal  tem  o  formato MMDDhhmm[[CC]YY][.ss] Use o
              argumento (meses, dias, horas,  minutos,  seculo  e  opcional  e
              anos,  segundo  e  opcional)  no lugar do tempo atual.  Note que
              este formato viola as especificacoes POSIX.

OP,C~OES PADR~AO GNU

       --help Imprime a mensagem de uso na saida padrao e sai.

       --version
              Imprime a versao na saida padrao e sai.

       --     Encerra a lista de opcao.

AMBIENTE

       A  variavel  TZ  e  usada  para  interpretar  explicitamente  o   tempo
       fornecido.  As variaveis LANG, LC_ALL, LC_CTYPE and LC_MESSAGES tem seu
       significado usual.

DE ACORDO COM

       POSIX 1003.2 descreve a sintaxe para o argumento da opcao -t que difere
       da usada pela implemetacao GNU.

EXEMPLO DE USO

       O  comando  'touch  foo'  ira criar o arquivo foo se ele nao existia, e
       alterara a data da ultima modificacao para agora.  Ele e frequentemente
       usado para guiar acoes do make.

NOTAS

       Esta  pagina  descreve touch como e encontrada no pacote Utilitarios de
       Arquivo 4.0; outras versoes  podem  ser  um  pouco  diferentes.   Envie
       correcoes  e  adicoes  para  aeb@cwi.nl.   Relatorio  de  problemas  no
       programa para fileutils-bugs@gnu.ai.mit.edu.

TRADUZIDO POR LDP-BR em 21/08/2000.

       Andre L. Fassone Canova <lonelywolf@blv.com.br> (traducao) Ricardo C.O.
       Freitas <english.quest@best-service.com> (revisao)

Utilitarios de Arquivo GNU 4.0      11/1998                           TOUCH(1)