216 lines
5.6 KiB
Groff
216 lines
5.6 KiB
Groff
.\" $NetBSD: touch.1,v 1.26 2016/12/24 15:49:18 abhinav Exp $
|
|
.\"
|
|
.\" Copyright (c) 1991, 1993
|
|
.\" The Regents of the University of California. All rights reserved.
|
|
.\"
|
|
.\" This code is derived from software contributed to Berkeley by
|
|
.\" the Institute of Electrical and Electronics Engineers, Inc.
|
|
.\"
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
.\" modification, are permitted provided that the following conditions
|
|
.\" are met:
|
|
.\" 1. Redistributions of source code must retain the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer.
|
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer in the
|
|
.\" documentation and/or other materials provided with the distribution.
|
|
.\" 3. Neither the name of the University nor the names of its contributors
|
|
.\" may be used to endorse or promote products derived from this software
|
|
.\" without specific prior written permission.
|
|
.\"
|
|
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
|
|
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
|
|
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
|
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
|
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
|
.\" SUCH DAMAGE.
|
|
.\"
|
|
.\" @(#)touch.1 8.3 (Berkeley) 4/28/95
|
|
.\"
|
|
.Dd December 24, 2016
|
|
.Dt TOUCH 1
|
|
.Os
|
|
.Sh NAME
|
|
.Nm touch
|
|
.Nd change file access and modification times
|
|
.Sh SYNOPSIS
|
|
.Nm
|
|
.Op Fl acfhm
|
|
.Op Fl d Ar human-datetime
|
|
.Op Fl Fl date Ar human-datetime
|
|
.Op Fl r Ar file
|
|
.Op Fl Fl reference Ar file
|
|
.Op Fl t Ar datetime
|
|
.Ar file ...
|
|
.Sh DESCRIPTION
|
|
The
|
|
.Nm
|
|
utility changes the access and modification times of files to the
|
|
current time of day.
|
|
If the file doesn't exist, it is created with default permissions.
|
|
.Pp
|
|
The following options are available:
|
|
.Bl -tag -width "-d human-datetime"
|
|
.It Fl a
|
|
Change the access time of the file.
|
|
The modification time of the file is not changed unless the
|
|
.Fl m
|
|
flag is also specified.
|
|
.It Fl c
|
|
Do not create the file if it does not exist.
|
|
The
|
|
.Nm
|
|
utility does not treat this as an error.
|
|
No error messages are displayed and the exit value is not affected.
|
|
.It Fl d Ar human-datetime
|
|
.It Fl Fl date Ar human-datetime
|
|
Parse
|
|
.Ar human-datetime
|
|
using the human datetime parser
|
|
.Xr parsedate 3 .
|
|
.It Fl f
|
|
This flag has no effect; it is accepted for compatibility reasons.
|
|
.It Fl h
|
|
If
|
|
.Ar file
|
|
is a symbolic link, access and/or modification time of the link is changed.
|
|
This option implies
|
|
.Fl c .
|
|
.It Fl m
|
|
Change the modification time of the file.
|
|
The access time of the file is not changed unless the
|
|
.Fl a
|
|
flag is also specified.
|
|
.It Fl r Ar file
|
|
.It Fl Fl reference Ar file
|
|
Use the access and modifications times from
|
|
.Ar file
|
|
instead of the current time of day.
|
|
.It Fl t Ar datetime
|
|
Change the access and modification times to the specified time.
|
|
The argument
|
|
.Ar datetime
|
|
should be in the form
|
|
.Dq [[CC]YY]MMDDhhmm[.SS]
|
|
where each pair of letters represents the following:
|
|
.Pp
|
|
.Bl -tag -width Ds -compact -offset indent
|
|
.It Ar CC
|
|
The first two digits of the year (the century).
|
|
.It Ar YY
|
|
The second two digits of the year.
|
|
If
|
|
.Dq YY
|
|
is specified, but
|
|
.Dq CC
|
|
is not, a value for
|
|
.Dq YY
|
|
between 69 and 99 results in a
|
|
.Dq CC
|
|
value of 19.
|
|
Otherwise, a
|
|
.Dq CC
|
|
value of 20 is used.
|
|
.It Ar MM
|
|
The month of the year, from 1 to 12.
|
|
.It Ar DD
|
|
The day of the month, from 1 to 31.
|
|
.It Ar hh
|
|
The hour of the day, from 0 to 23.
|
|
.It Ar mm
|
|
The minute of the hour, from 0 to 59.
|
|
.It Ar SS
|
|
The second of the minute, from 0 to 60 (permitting leap seconds).
|
|
If
|
|
.Ar SS
|
|
is 60 and the resulting time,
|
|
as affected by the
|
|
.Ev TZ
|
|
environment variable,
|
|
does not refer to a leap second,
|
|
the resulting time is one second after a time where
|
|
.Ar SS
|
|
is 59.
|
|
If
|
|
.Ar SS
|
|
is not given a value, it is assumed to be zero.
|
|
.El
|
|
.Pp
|
|
If the
|
|
.Dq CC
|
|
and
|
|
.Dq YY
|
|
letter pairs are not specified, the values default to the current
|
|
year.
|
|
If the
|
|
.Dq SS
|
|
letter pair is not specified, the value defaults to 0.
|
|
.El
|
|
.Pp
|
|
The
|
|
.Fl d ,
|
|
.Fl r ,
|
|
and
|
|
.Fl t
|
|
options are mutually exclusive.
|
|
If more than one of these options is present, the last one is used.
|
|
.Sh ENVIRONMENT
|
|
.Bl -tag -width -iTZ
|
|
.It Ev TZ
|
|
The timezone to be used for interpreting the
|
|
.Ar datetime
|
|
argument of the
|
|
.Fl t
|
|
option.
|
|
.El
|
|
.Sh EXIT STATUS
|
|
.Ex -std
|
|
.Sh COMPATIBILITY
|
|
The obsolescent form of
|
|
.Nm ,
|
|
where a time format is specified as the first argument, is supported.
|
|
When no
|
|
.Fl d ,
|
|
.Fl r ,
|
|
or
|
|
.Fl t
|
|
option is specified, there are at least two arguments, and the first
|
|
argument is a string of digits either eight or ten characters in length,
|
|
the first argument is interpreted as a time specification of the form
|
|
.Dq MMDDhhmm[YY] .
|
|
.Pp
|
|
The
|
|
.Dq MM ,
|
|
.Dq DD ,
|
|
.Dq hh
|
|
and
|
|
.Dq mm
|
|
letter pairs are treated as their counterparts specified to the
|
|
.Fl t
|
|
option.
|
|
If the
|
|
.Dq YY
|
|
letter pair is in the range 69 to 99, the year is set to 1969 to 1999,
|
|
otherwise, the year is set in the 21st century.
|
|
.Sh SEE ALSO
|
|
.Xr utimes 2 ,
|
|
.Xr parsedate 3
|
|
.Sh STANDARDS
|
|
The
|
|
.Nm
|
|
utility is expected to be a superset of the
|
|
.St -p1003.2
|
|
specification.
|
|
.Sh HISTORY
|
|
A
|
|
.Nm
|
|
utility appeared in
|
|
.At v7 .
|
|
.Sh BUGS
|
|
A symbolic link can't be a reference file of access and/or modification time.
|