home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / prgramer / unix / doc / touch.man < prev    next >
Text File  |  1993-06-13  |  3KB  |  133 lines
  1.  
  2.  
  3.  
  4. TOUCH(1L)                                               TOUCH(1L)
  5.  
  6.  
  7. NAME
  8.        touch - change file timestamps
  9.  
  10. SYNOPSIS
  11.        touch     [-acfm]    [-r    reference-file]    [-t    MMD-
  12.        Dhhmm[[CC]YY][.ss]]               [-d                time]
  13.        [--time={atime,access,use,mtime,modify}]     [--date=time]
  14.        [--file=reference-file] [--no-create] [--help] [--version]
  15.        file...
  16.  
  17. DESCRIPTION
  18.        This  manual  page  documents  the  GNU  version of touch.
  19.        touch changes the access and modification  times  of  each
  20.        given  file  to the current time.  Files that do not exist
  21.        are created empty.  If the first file name given would  be
  22.        a  valid  argument  to  the  -t option and no timestamp is
  23.        given with any of the -d, -r, or -t  options  and  the  --
  24.        argument is not given, that argument is interpreted as the
  25.        time for the other files instead of as a filename.
  26.  
  27.        If changing both the access and modification times to  the
  28.        current  time,  touch  can change the timestamps for files
  29.        that the user running it does not own but has  write  per-
  30.        mission for.  Otherwise, the user must own the files.
  31.  
  32.    OPTIONS
  33.        -a, --time=atime, --time=access, --time=use
  34.               Change the access time only.
  35.  
  36.        -c, --no-create
  37.               Do not create files that do not exist.
  38.  
  39.        -d, --date time
  40.               Use  time  (which can be in various common formats)
  41.               instead of the current time.  It can contain  month
  42.               names, timezones, `am' and `pm', etc.
  43.  
  44.        -f     Ignored;  for  compatibility  with  BSD versions of
  45.               touch.
  46.  
  47.        -m, --time=mtime, --time=modify
  48.               Change the modification time only.
  49.  
  50.        -r, --file reference-file
  51.               Use the times of reference-file instead of the cur-
  52.               rent time.
  53.  
  54.        -t MMDDhhmm[[CC]YY][.ss]
  55.               Use  the  argument  (months,  days, hours, minutes,
  56.               optional  century  and  years,  optional   seconds)
  57.               instead of the current time.
  58.  
  59.        --help Print a usage message and exit with a non-zero sta-
  60.               tus.
  61.  
  62.  
  63.  
  64. FSF                     GNU File Utilities                      1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. TOUCH(1L)                                               TOUCH(1L)
  71.  
  72.  
  73.        --version
  74.               Print version information on  standard  error  then
  75.               exit.
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130. FSF                     GNU File Utilities                      2
  131.  
  132.  
  133.