Manpages

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 [AT] cwi.nl. Relatório de problemas no programa para fileutils-bugs [AT] gnu.edu.

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

André L. Fassone Canova <lonelywolf [AT] blv.br> (tradução) Ricardo C.O. Freitas <english.quest [AT] best-service.com> (revisão)