touch − altera o rótulo de tempo do arquivo
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...
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.
−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.
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.
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.
−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.
−−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. |
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.
POSIX 1003.2 descreve a sintaxe para o argumento da opção −t que difere da usada pela implemetação GNU.
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.
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 AT cwi DOT nl. Relatório de problemas no programa para fileutils-bugs AT gnu DOT ai DOT mit DOT edu.
André L. Fassone Canova <lonelywolf AT blv DOT com DOT br> (tradução) Ricardo C.O. Freitas <english DOT quest AT best-service DOT com> (revisão)