.\" -*- nroff-*- .\" Copyright Andries Brouwer, Ragnar Hojland Espinosa and A. Wik, 1998. .\" .\" This file may be copied under the conditions described .\" in the LDP GENERAL PUBLIC LICENSE, Version 1, September 1998 .\" that should have been distributed together with this file. .\" .TH TOUCH 1 "11/1998" "Utilitários de Arquivo GNU 4.0" .SH NOME touch \- altera o rótulo de tempo do arquivo .SH SINOPSE .B touch .BI "[\-acm][\-r " ref_file "|\-t " time "] " file... .sp Versão obsoleta: .br .B touch .BI "[\-acm][" ugly_time "] " file... .sp Versão GNU: .br .B touch .BI "[\-acfm] [\-r " file "] [\-t " decimtime ] .BI "[\-d " time "] [\-\-time={atime,access,use,mtime,modify}]" .BI "[\-\-date=" time "] [\-\-reference=" file ] .BI "[\-\-no\-create] [\-\-help] [\-\-version] [\-\-] " file... .SH DESCRIÇÃO .B touch altera o acesso e/ou os rótulos de tempo de modificação de cada .IR 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 .IR arquivo_de_referência , ou se a opção \-t é especificada, neste caso eles são alteradas para o .IR 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. .SH "OPÇÕES POSIX" .TP .B \-a Altera a data de acesso do .IR arquivo . .TP .B \-c Não cria o .IR arquivo . .TP .B \-m Altera a data de modificação do .IR arquivo . .TP .BI "\-r " arquivo_de_referência Usa o rótulo de tempo correspondente do .I arquivo_de_referência como o novo valor para o(s) rótulo(s) de tempo alterado. .TP .BI "\-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 .br .nf [[CC]YY]MMDDhhmm[.SS] .br .fi 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. .SH "DETALHES POSIX" A segunda forma de se invocar tem a desvantagem que existe alguma ambigüidade se .I 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 .I 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. .SH "DETALHES GNU" Se o primeiro .I arquivo fosse um argumento válido para a opção .B "\-t" e não nenhum rótulo de tempo fosse fornecido com qualquer das opções .BR "\-d" , .BR "\-r" ou .B "\-t" e o argumento '\-\-' não for fornecido, aquele argumento é interpretado como a data para os outros arquivos. .PP Se alterando a data de acesso e data de modificação, para o tempo atual .B 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. .SH "OPÇÕES GNU" .TP .B "\-a, \-\-time=atime, \-\-time=accesso, \-\-time=use" Altera somente a data de acesso. .TP .B "\-c, \-\-no\-create" Não cria arquivos que não existem. .TP .BI "\-d, \-\-date=" tempo Usa .I tempo no lugar do tempo atual. Ele pode conter nome de meses, fusos horários, 'am' e 'pm', etc. .TP .B "\-f" Ignorado; para compatibilidade com as versões BSD do comando .BR touch (1). .TP .B "\-m, \-\-time=mtime, \-\-time=modificação" Altera somente a data de modificação. .TP .BI "\-r " arquivo ", \-\-reference=" arquivo Usa a data referenciada no .I arquivo no lugar do tempo atual. .TP .BI "\-t " tempo_decimal Aqui .I 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. .SH "OPÇÕES PADRÃO GNU" .TP .B "\-\-help" Imprime a mensagem de uso na saída padrão e sai. .TP .B "\-\-version" Imprime a versão na saída padrão e sai. .TP .B "\-\-" Encerra a lista de opção. .SH 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. .SH "DE ACORDO COM" POSIX 1003.2 descreve a sintaxe para o argumento da opção \-t que difere da usada pela implemetação GNU. .SH "EXEMPLO DE USO" O comando '\fItouch foo\fP' irá criar o arquivo \fIfoo\fP se ele não existia, e alterará a data da última modificação para agora. Ele é freqüentemente usado para guiar ações do .BR make . .SH NOTAS Esta página descreve .B 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. .SH TRADUZIDO POR LDP-BR em 21/08/2000. \&\fR\&\f(CWAndré L. Fassone Canova (tradução)\fR \&\fR\&\f(CWRicardo C.O. Freitas (revisão)\fR