Provided by: manpages-pt_20040726-4_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_referncia, 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_referncia
              Usa  o  rótulo  de tempo correspondente do arquivo_de_referncia
              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)