| .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. |