coreutils

.TH TOUCH 1 2022-03-06 "OMKOV coreutils" "General Commands Manual"

.SH NAME

touch \(em change file access and modify times

.SH SYNOPSYS

\fBtouch\fR [-acm] [-d \fItime\fR|-r \fIfile\fR|-t \fItime\fR] \fIfile\fR...

.SH DESCRIPTION

Update the access and modification times of one or more files.

.SH OPTIONS

The following options are supported:

.TP

.B -a

Change the access time only.

.TP

.B -c

Do not create new files.

.TP

.B -d \fItime\fR

Use YYYY-MM-DDThh:mm:SS[.frac][tz] instead of current time.

.TP

.B -m

Change the modification time only.

.TP

.B -r \fIfile\fR

Use a specified files times.

.TP

.B -t \fItime\fR

Use [[CC]YY]MMDDhhmm[.SS] instead of current time.

.TP

.B --help

Display help information.

.TP

.B --version

Display version information.

.SH OPERANDS

The following operand is supported:

.TP

.I file

A pathname of a file.

.SH EXIT STATUS

The following exit values will be returned:

.TP

\ 0

All files were processed successfully.

.TP

>0

An error occurred.

.SH STANDARDS

The \fItouch\fR utility is compliant with the IEEE Std 1003.2-1992 ("POSIX.2")

specification.

.SH COPYRIGHT

.nf

Copyright (C) 2020, Jakob Wakeling

MIT Licence (https://opensource.org/licenses/MIT)

.fi