83 lines
2.8 KiB
Groff
83 lines
2.8 KiB
Groff
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.50.1.
|
|
.TH TOUCH "1" "April 2025" "GNU coreutils 9.7" "User Commands"
|
|
.SH NAME
|
|
touch \- change file timestamps
|
|
.SH SYNOPSIS
|
|
.B touch
|
|
[\fI\,OPTION\/\fR]... \fI\,FILE\/\fR...
|
|
.SH DESCRIPTION
|
|
.\" Add any additional description here
|
|
.PP
|
|
Update the access and modification times of each FILE to the current time.
|
|
.PP
|
|
A FILE argument that does not exist is created empty, unless \fB\-c\fR or \fB\-h\fR
|
|
is supplied.
|
|
.PP
|
|
A FILE argument string of \- is handled specially and causes touch to
|
|
change the times of the file associated with standard output.
|
|
.PP
|
|
Mandatory arguments to long options are mandatory for short options too.
|
|
.TP
|
|
\fB\-a\fR
|
|
change only the access time
|
|
.TP
|
|
\fB\-c\fR, \fB\-\-no\-create\fR
|
|
do not create any files
|
|
.TP
|
|
\fB\-d\fR, \fB\-\-date\fR=\fI\,STRING\/\fR
|
|
parse STRING and use it instead of current time
|
|
.TP
|
|
\fB\-f\fR
|
|
(ignored)
|
|
.TP
|
|
\fB\-h\fR, \fB\-\-no\-dereference\fR
|
|
affect each symbolic link instead of any referenced
|
|
file (useful only on systems that can change the
|
|
timestamps of a symlink)
|
|
.TP
|
|
\fB\-m\fR
|
|
change only the modification time
|
|
.TP
|
|
\fB\-r\fR, \fB\-\-reference\fR=\fI\,FILE\/\fR
|
|
use this file's times instead of current time
|
|
.TP
|
|
\fB\-t\fR [[CC]YY]MMDDhhmm[.ss]
|
|
use specified time instead of current time,
|
|
with a date\-time format that differs from \fB\-d\fR's
|
|
.TP
|
|
\fB\-\-time\fR=\fI\,WORD\/\fR
|
|
specify which time to change:
|
|
access time (\fB\-a\fR): 'access', 'atime', 'use';
|
|
modification time (\fB\-m\fR): 'modify', 'mtime'
|
|
.TP
|
|
\fB\-\-help\fR
|
|
display this help and exit
|
|
.TP
|
|
\fB\-\-version\fR
|
|
output version information and exit
|
|
.SH "DATE STRING"
|
|
.\" NOTE: keep this paragraph in sync with the one in date.x
|
|
The --date=STRING is a mostly free format human readable date string
|
|
such as "Sun, 29 Feb 2004 16:21:42 -0800" or "2004-02-29 16:21:42" or
|
|
even "next Thursday". A date string may contain items indicating
|
|
calendar date, time of day, time zone, day of week, relative time,
|
|
relative date, and numbers. An empty string indicates the beginning
|
|
of the day. The date string format is more complex than is easily
|
|
documented here but is fully described in the info documentation.
|
|
.SH AUTHOR
|
|
Written by Paul Rubin, Arnold Robbins, Jim Kingdon,
|
|
David MacKenzie, and Randy Smith.
|
|
.SH "REPORTING BUGS"
|
|
GNU coreutils online help: <https://www.gnu.org/software/coreutils/>
|
|
.br
|
|
Report any translation bugs to <https://translationproject.org/team/>
|
|
.SH COPYRIGHT
|
|
Copyright \(co 2025 Free Software Foundation, Inc.
|
|
License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
|
|
.br
|
|
This is free software: you are free to change and redistribute it.
|
|
There is NO WARRANTY, to the extent permitted by law.
|
|
.SH "SEE ALSO"
|
|
Full documentation <https://www.gnu.org/software/coreutils/touch>
|
|
.br
|
|
or available locally via: info \(aq(coreutils) touch invocation\(aq
|