.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.2.
.TH TOUCH "1" "August 2022" "GNU coreutils 8.32" "User Commands"
.SH NAME
touch \- manual page for touch 8.32
.SH SYNOPSIS
.B touch
[\fI\,OPTION\/\fR]... \fI\,FILE\/\fR...
.SH DESCRIPTION
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 STAMP
use [[CC]YY]MMDDhhmm[.ss] instead of current time
.TP
\fB\-\-time\fR=\fI\,WORD\/\fR
change the specified time:
WORD is access, atime, or use: equivalent to \fB\-a\fR
WORD is modify or mtime: equivalent to \fB\-m\fR
.TP
\fB\-\-help\fR
display this help and exit
.TP
\fB\-\-version\fR
output version information and exit
.PP
Note that the \fB\-d\fR and \fB\-t\fR options accept different time\-date formats.
.PP
GNU coreutils online help: <https://www.gnu.org/software/coreutils/>
Report any translation bugs to <https://translationproject.org/team/>
Full documentation <https://www.gnu.org/software/coreutils/touch>
or available locally via: info '(coreutils) touch invocation'
.SH AUTHOR
Written by Paul Rubin, Arnold Robbins, Jim Kingdon,
David MacKenzie, and Randy Smith.
.SH COPYRIGHT
Copyright \(co 2020 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.