128 lines
4.1 KiB
HTML
128 lines
4.1 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of TOUCH</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>TOUCH</H1>
|
|
Section: User Commands (1)<BR>Updated: September 2019<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
touch - change file timestamps
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>touch</B>
|
|
|
|
[<I>,OPTION/</I>]... <I>,FILE/</I>...
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
|
|
<P>
|
|
|
|
Update the access and modification times of each FILE to the current time.
|
|
<P>
|
|
|
|
A FILE argument that does not exist is created empty, unless <B>-c</B> or <B>-h</B>
|
|
is supplied.
|
|
<P>
|
|
|
|
A FILE argument string of - is handled specially and causes touch to
|
|
change the times of the file associated with standard output.
|
|
<P>
|
|
|
|
Mandatory arguments to long options are mandatory for short options too.
|
|
<DL COMPACT>
|
|
<DT id="1"><B>-a</B><DD>
|
|
change only the access time
|
|
<DT id="2"><B>-c</B>, <B>--no-create</B><DD>
|
|
do not create any files
|
|
<DT id="3"><B>-d</B>, <B>--date</B>=<I>,STRING/</I><DD>
|
|
parse STRING and use it instead of current time
|
|
<DT id="4"><B>-f</B><DD>
|
|
(ignored)
|
|
<DT id="5"><B>-h</B>, <B>--no-dereference</B><DD>
|
|
affect each symbolic link instead of any referenced
|
|
file (useful only on systems that can change the
|
|
timestamps of a symlink)
|
|
<DT id="6"><B>-m</B><DD>
|
|
change only the modification time
|
|
<DT id="7"><B>-r</B>, <B>--reference</B>=<I>,FILE/</I><DD>
|
|
use this file's times instead of current time
|
|
<DT id="8"><B>-t</B> STAMP<DD>
|
|
use [[CC]YY]MMDDhhmm[.ss] instead of current time
|
|
<DT id="9"><B>--time</B>=<I>,WORD/</I><DD>
|
|
change the specified time:
|
|
WORD is access, atime, or use: equivalent to <B>-a</B>
|
|
WORD is modify or mtime: equivalent to <B>-m</B>
|
|
<DT id="10"><B>--help</B><DD>
|
|
display this help and exit
|
|
<DT id="11"><B>--version</B><DD>
|
|
output version information and exit
|
|
</DL>
|
|
<P>
|
|
|
|
Note that the <B>-d</B> and <B>-t</B> options accept different time-date formats.
|
|
<A NAME="lbAE"> </A>
|
|
<H2>DATE STRING</H2>
|
|
|
|
|
|
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.
|
|
<A NAME="lbAF"> </A>
|
|
<H2>AUTHOR</H2>
|
|
|
|
Written by Paul Rubin, Arnold Robbins, Jim Kingdon,
|
|
David MacKenzie, and Randy Smith.
|
|
<A NAME="lbAG"> </A>
|
|
<H2>REPORTING BUGS</H2>
|
|
|
|
GNU coreutils online help: <<A HREF="https://www.gnu.org/software/coreutils/">https://www.gnu.org/software/coreutils/</A>>
|
|
<BR>
|
|
|
|
Report touch translation bugs to <<A HREF="https://translationproject.org/team/">https://translationproject.org/team/</A>>
|
|
<A NAME="lbAH"> </A>
|
|
<H2>COPYRIGHT</H2>
|
|
|
|
Copyright © 2018 Free Software Foundation, Inc.
|
|
License GPLv3+: GNU GPL version 3 or later <<A HREF="https://gnu.org/licenses/gpl.html">https://gnu.org/licenses/gpl.html</A>>.
|
|
<BR>
|
|
|
|
This is free software: you are free to change and redistribute it.
|
|
There is NO WARRANTY, to the extent permitted by law.
|
|
<A NAME="lbAI"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
Full documentation at: <<A HREF="https://www.gnu.org/software/coreutils/touch">https://www.gnu.org/software/coreutils/touch</A>>
|
|
<BR>
|
|
|
|
or available locally via: info '(coreutils) touch invocation'
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="12"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="13"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="14"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="15"><A HREF="#lbAE">DATE STRING</A><DD>
|
|
<DT id="16"><A HREF="#lbAF">AUTHOR</A><DD>
|
|
<DT id="17"><A HREF="#lbAG">REPORTING BUGS</A><DD>
|
|
<DT id="18"><A HREF="#lbAH">COPYRIGHT</A><DD>
|
|
<DT id="19"><A HREF="#lbAI">SEE ALSO</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:28 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|