Provided by:
manpages-pt_20040726-4_all 
NOME
touch - altera o rotulo de tempo do arquivo
SINOPSE
touch [-acm][-r ref_file|-t time] file...
Versao obsoleta:
touch [-acm][ugly_time] file...
Versao 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,C~AO
touch altera o acesso e/ou os rotulos de tempo de modificacao de cada
arquivo especificado. Estes rotulos de tempo sao alterados para o
tempo atual, a menos que a opcao -r option seja especificada, neste
caso eles sao alterados para os rotulos de tempo correspondentes para
as do arquivo arquivo_de_refer^encia, ou se a opcao -t e especificada,
neste caso eles sao alteradas para o tempo especificado. Ambas as
datas sao alteradas quando nenhuma ou ambas opcoes -a e -m sao
fornecidas. Somente a data de acesso ou somente a data de alteracao sao
alteradas quando uma da opcoes -a e -m e fornecida. Se o arquivo nao
existe ainda, ele e criado (como um arquivo vazio com o modo 0666,
modificado pelo bits da umask), a menos que a opcao -c seja fornecida.
OP,C~OES POSIX
-a Altera a data de acesso do arquivo.
-c Nao cria o arquivo.
-m Altera a data de modificacao do arquivo.
-r arquivo_de_refer^encia
Usa o rotulo de tempo correspondente do arquivo_de_refer^encia
como o novo valor para o(s) rotulo(s) de tempo alterado.
-t time
Usa a data especificada como novo valor para o(s) rotulo(s) de
tempo alterado. O argumento e um numero decimal na forma
[[CC]YY]MMDDhhmm[.SS]
com significado obvio. Se CC nao e especificado, o ano CCYY e
considerado no intervalo de 1969-2068. SE SS nao e
especificado, ele e considerado como 0. Ele pode ser
especificado no intervalo 0-61 de forma que isto e possivel se
referir a saltos de segundos. A data resultante e considerada
como a data para o fuso horario especificado pela variavel de
ambiente TZ. E 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
ambiguidade se ugly_time e um tempo ou um argumento do arquivo. Ele e
considerado como uma data quando as opcoes -r ou -t nao estao
presentes, ha pelo menos dois arqumentos, e o primeiro argumento e um
numero inteiro na base octal ou decimal. O formato de ugly_time e
MMDDhhmm[yy], onde o yy no intervalo 66-99 denota um ano entre
1969-1999, e um yy sem especificacao denota o ano atual. Esta forma e
obsoleta.
DETALHES GNU
Se o primeiro arquivo fosse um argumento valido para a opcao -t e nao
nenhum rotulo de tempo fosse fornecido com qualquer das opcoes -d, -r
ou -t e o argumento '--' nao for fornecido, aquele argumento e
interpretado como a data para os outros arquivos.
Se alterando a data de acesso e data de modificacao, para o tempo atual
touch pode alterar a marca de tempo para arquivos que o usuario executa
mas nao lhe pertencem embora tenha permissao de escrita. De outra
forma, o usuario tera que ser dono dos arquivos.
OP,C~OES GNU
-a, --time=atime, --time=accesso, --time=use
Altera somente a data de acesso.
-c, --no-create
Nao cria arquivos que nao existem.
-d, --date=tempo
Usa tempo no lugar do tempo atual. Ele pode conter nome de
meses, fusos horarios, 'am' e 'pm', etc.
-f Ignorado; para compatibilidade com as versoes BSD do comando
touch(1).
-m, --time=mtime, --time=modifica,c~ao
Altera somente a data de modificacao.
-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, seculo e opcional e
anos, segundo e opcional) no lugar do tempo atual. Note que
este formato viola as especificacoes POSIX.
OP,C~OES PADR~AO GNU
--help Imprime a mensagem de uso na saida padrao e sai.
--version
Imprime a versao na saida padrao e sai.
-- Encerra a lista de opcao.
AMBIENTE
A variavel TZ e usada para interpretar explicitamente o tempo
fornecido. As variaveis 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 opcao -t que difere
da usada pela implemetacao GNU.
EXEMPLO DE USO
O comando 'touch foo' ira criar o arquivo foo se ele nao existia, e
alterara a data da ultima modificacao para agora. Ele e frequentemente
usado para guiar acoes do make.
NOTAS
Esta pagina descreve touch como e encontrada no pacote Utilitarios de
Arquivo 4.0; outras versoes podem ser um pouco diferentes. Envie
correcoes e adicoes para aeb@cwi.nl. Relatorio de problemas no
programa para fileutils-bugs@gnu.ai.mit.edu.
TRADUZIDO POR LDP-BR em 21/08/2000.
Andre L. Fassone Canova <lonelywolf@blv.com.br> (traducao) Ricardo C.O.
Freitas <english.quest@best-service.com> (revisao)
Utilitarios de Arquivo GNU 4.0 11/1998 TOUCH(1)