mirror of git://git.suckless.org/sbase
67 lines
1.2 KiB
Groff
67 lines
1.2 KiB
Groff
.Dd February 9, 2015
|
|
.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-2008
|
|
specification, except from fractional seconds in the
|
|
.Op Fl d
|
|
argument.
|
|
.Pp
|
|
The
|
|
.Op Fl T
|
|
flag is an extension to that specification.
|