Provided by: manpages-pt_20040726-2_all bug

NOME
       touch - altera o rótulo de tempo do arquivo


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

       Versão obsoleta:
       touch [-acm][ugly_time] file...

       Versão 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ÇÃO
       touch  altera  o acesso e/ou os rótulos de tempo de modificação de cada
       arquivo especificado.  Estes rótulos de  tempo  são  alterados  para  o
       tempo  atual,  a  menos  que a opção -r option seja especificada, neste
       caso eles são alterados para os rótulos de tempo  correspondentes  para
       as  do  arquivo arquivo_de_referência, ou se a opção -t é especificada,
       neste caso eles são alteradas para  o  tempo  especificado.   Ambas  as
       datas  são  alteradas  quando  nenhuma  ou  ambas  opções  -a  e -m são
       fornecidas. Somente a data de acesso ou somente a data de alteração são
       alteradas  quando  uma da opções -a e -m é fornecida.  Se o arquivo não
       existe ainda, ele é criado (como um arquivo  vazio  com  o  modo  0666,
       modificado  pelo bits da umask), a menos que a opção -c seja fornecida.


OPÇÕES POSIX
       -a     Altera a data de acesso do arquivo.

       -c     Não cria o arquivo.

       -m     Altera a data de modificação do arquivo.

       -r arquivo_de_referência
              Usa o rótulo de tempo  correspondente  do  arquivo_de_referência
              como o novo valor para o(s) rótulo(s) de tempo alterado.

       -t time
              Usa  a  data especificada como novo valor para o(s) rótulo(s) de
              tempo alterado.  O argumento é um número decimal na forma
                  [[CC]YY]MMDDhhmm[.SS]
              com significado óbvio. Se CC não é especificado, o  ano  CCYY  é
              considerado   no   intervalo   de   1969-2068.    SE  SS  não  é
              especificado,  ele  é  considerado  como   0.   Ele   pode   ser
              especificado  no  intervalo 0-61 de forma que isto é possível se
              referir a saltos de segundos.  A data resultante  é  considerada
              como  a  data  para o fuso horário especificado pela variável de
              ambiente TZ. É 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
       ambigüidade se ugly_time é um tempo ou um argumento do arquivo.  Ele  é
       considerado  como  uma  data  quando  as  opções  -r  ou  -t  não estão
       presentes, há pelo menos dois arqumentos, e o primeiro argumento  é  um
       número  inteiro  na  base  octal  ou decimal.  O formato de ugly_time é
       MMDDhhmm[yy], onde  o  yy  no  intervalo  66-99  denota  um  ano  entre
       1969-1999,  e um yy sem especificação denota o ano atual.  Esta forma é
       obsoleta.


DETALHES GNU
       Se o primeiro arquivo fosse um argumento válido para a opção -t  e  não
       nenhum  rótulo  de tempo fosse fornecido com qualquer das opções -d, -r
       ou -t e  o  argumento  ’--’  não  for  fornecido,  aquele  argumento  é
       interpretado como a data para os outros arquivos.

       Se alterando a data de acesso e data de modificação, para o tempo atual
       touch pode alterar a marca de tempo para arquivos que o usuário executa
       mas  não  lhe  pertencem  embora  tenha  permissão de escrita. De outra
       forma, o usuário terá que ser dono dos arquivos.


OPÇÕES GNU
       -a, --time=atime, --time=accesso, --time=use
              Altera somente a data de acesso.

       -c, --no-create
              Não cria arquivos que não existem.

       -d, --date=tempo
              Usa tempo no lugar do tempo  atual.  Ele  pode  conter  nome  de
              meses, fusos horários, ’am’ e ’pm’, etc.

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

       -m, --time=mtime, --time=modificação
              Altera somente a data de modificação.

       -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,  século é opcional e
              anos, segundo é opcional) no lugar do  tempo  atual.   Note  que
              este formato viola as especificações POSIX.


OPÇÕES PADRÃO GNU
       --help Imprime a mensagem de uso na saída padrão e sai.

       --version
              Imprime a versão na saída padrão e sai.

       --     Encerra a lista de opção.


AMBIENTE
       A   variável  TZ  é  usada  para  interpretar  explicitamente  o  tempo
       fornecido.  As variáveis 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 opção -t que difere
       da usada pela implemetação GNU.


EXEMPLO DE USO
       O comando ’touch foo’ irá criar o arquivo foo se  ele  não  existia,  e
       alterará a data da última modificação para agora.  Ele é freqüentemente
       usado para guiar ações do make.


NOTAS
       Esta página descreve touch como é encontrada no pacote  Utilitários  de
       Arquivo  4.0;  outras  versões  podem  ser  um pouco diferentes.  Envie
       correções  e  adições  para  aeb@cwi.nl.   Relatório  de  problemas  no
       programa para fileutils-bugs@gnu.ai.mit.edu.


TRADUZIDO POR LDP-BR em 21/08/2000.
       André L. Fassone Canova <lonelywolf@blv.com.br> (tradução) Ricardo C.O.
       Freitas <english.quest@best-service.com> (revisão)