sbase

suckless unix tools
git clone git://git.2f30.org/sbase
Log | Files | Refs | README | LICENSE

touch.1 (1161B)


      1 .Dd 2015-10-08
      2 .Dt TOUCH 1
      3 .Os sbase
      4 .Sh NAME
      5 .Nm touch
      6 .Nd set file timestamps
      7 .Sh SYNOPSIS
      8 .Nm
      9 .Op Fl acm
     10 .Op Fl d Ar time | Fl r Ar ref_file | Fl T Ar time | Fl t Ar time
     11 .Ar file ...
     12 .Sh DESCRIPTION
     13 .Nm
     14 sets the access and modification time of each
     15 .Ar file
     16 to the current time of day. If
     17 .Ar file
     18 doesn't exist, it is created with default permissions.
     19 .Sh OPTIONS
     20 .Bl -tag -width Ds
     21 .It Fl a | Fl m
     22 Set the access | modification time of
     23 .Ar file.
     24 .It Fl c
     25 Don't create
     26 .Ar file
     27 if it doesn't exist, not affecting exit status.
     28 .It Fl d Ar time
     29 Set the
     30 .Ar time
     31 of the format YYYY-MM-DDThh:mm:SS[Z] used for
     32 .Op Fl am .
     33 .It Fl r Ar ref_file
     34 Set the
     35 .Ar time
     36 used for
     37 .Op Fl am
     38 to the modification time of
     39 .Ar ref_file .
     40 .It Fl T Ar time
     41 Set the
     42 .Ar time
     43 used for
     44 .Op Fl am
     45 given as the number of seconds since the
     46 Unix epoch 1970-01-01T00:00:00Z.
     47 .It Fl t Ar time
     48 Set the
     49 .Ar time
     50 of the format [[CC]YY]MMDDhhmm[.SS] used for
     51 .Op Fl am .
     52 .El
     53 .Sh SEE ALSO
     54 .Xr date 1
     55 .Sh STANDARDS
     56 The
     57 .Nm
     58 utility is compliant with the
     59 .St -p1003.1-2013
     60 specification except from fractional seconds with
     61 .Op Fl d .
     62 .Pp
     63 The
     64 .Op Fl T
     65 flag is an extension to that specification.