You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

67 lines
1.1 KiB

.Dd 2015-10-08
.Dt TOUCH 1
.Os sbase
.Sh NAME
.Nm touch
.Nd set file timestamps
.Sh SYNOPSIS
.Nm
.Op Fl acm
.Op Fl d Ar time | Fl r Ar ref_file | Fl T Ar time | Fl t Ar time
.Ar file ...
.Sh DESCRIPTION
.Nm
sets the access and modification time of each
.Ar file
to the current time of day.
If
.Ar file
doesn't exist, it is created with default permissions.
.Sh OPTIONS
.Bl -tag -width Ds
.It Fl a | Fl m
Set the access | modification time of
.Ar file.
.It Fl c
Don't create
.Ar file
if it doesn't exist, not affecting exit status.
.It Fl d Ar time
Set the
.Ar time
of the format YYYY-MM-DDThh:mm:SS[Z] used for
.Op Fl am .
.It Fl r Ar ref_file
Set the
.Ar time
used for
.Op Fl am
to the modification time of
.Ar ref_file .
.It Fl T Ar time
Set the
.Ar time
used for
.Op Fl am
given as the number of seconds since the
Unix epoch 1970-01-01T00:00:00Z.
.It Fl t Ar time
Set the
.Ar time
of the format [[CC]YY]MMDDhhmm[.SS] used for
.Op Fl am .
.El
.Sh SEE ALSO
.Xr date 1
.Sh STANDARDS
The
.Nm
utility is compliant with the
.St -p1003.1-2013
specification except from fractional seconds with
.Op Fl d .
.Pp
The
.Op Fl T
flag is an extension to that specification.