1
0
mirror of git://git.suckless.org/sbase synced 2024-12-23 07:25:07 +00:00
sbase/touch.1
FRIGN d6b3890af6 Add r-flag to touch(1), refactor manpage and code
and mark it as finished in README.
2015-02-09 00:41:57 +01:00

54 lines
928 B
Groff

.Dd February 9, 2014
.Dt TOUCH 1
.Os sbase
.Sh NAME
.Nm touch
.Nd set file timestamps
.Sh SYNOPSIS
.Nm
.Op Fl acm
.Op Fl r Ar ref_file | t Ar timestamp
.Ar file ...
.Sh DESCRIPTION
.Nm
sets the access or 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 r Ar ref_file
Set the timestamp
to be used with
.Op Fl am
to the modification time of
.Ar ref_file .
.It Fl t Ar timestamp
Set the
.Ar timestamp
to be used with
.Op Fl am
given as the number of seconds since the
Unix epoch 1970-01-01T00:00:00Z.
.El
.Sh SEE ALSO
.Xr date 1
.Sh STANDARDS
The
.Nm
utility is compliant with the
.St -p1003.1-2008
specification except from the
.Ar timestamp
format of the
.Fl t
flag.