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)

Utilitários de Arquivo GNU 4.0                       11/1998                                            TOUCH(1)