usr/src/lib/libast/common/man/touch.3

   1 .fp 5 CW
   2 .de Af
   3 .ds ;G \\*(;G\\f\\$1\\$3\\f\\$2
   4 .if !\a\\$4\a\a .Af \\$2 \\$1 "\\$4" "\\$5" "\\$6" "\\$7" "\\$8" "\\$9"
   5 ..
   6 .de aF
   7 .ie \a\\$3\a\a .ft \\$1
   8 .el \{\
   9 .ds ;G \&
  10 .nr ;G \\n(.f
  11 .Af "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6" "\\$7" "\\$8" "\\$9"
  12 \\*(;G
  13 .ft \\n(;G \}
  14 ..
  15 .de L
  16 .aF 5 \\n(.f "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6" "\\$7"
  17 ..
  18 .de LR
  19 .aF 5 1 "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6" "\\$7"
  20 ..
  21 .de RL
  22 .aF 1 5 "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6" "\\$7"
  23 ..
  24 .de EX          \" start example
  25 .ta 1i 2i 3i 4i 5i 6i
  26 .PP
  27 .RS
  28 .PD 0
  29 .ft 5
  30 .nf
  31 ..
  32 .de EE          \" end example
  33 .fi
  34 .ft
  35 .PD
  36 .RE
  37 .PP
  38 ..
  39 .TH TOUCH 3
  40 .SH NAME
  41 touch \- set file access and modify times
  42 .SH SYNOPSIS
  43 .L "#include <ast.h>"
  44 .sp
  45 .L "int touch(const char* path, time_t atime, time_t mtime, int force);"
  46 .SH DESCRIPTION
  47 .L touch
  48 sets the access and modify times of the file named by
  49 .LR path .
  50 If
  51 .L "force != 0"
  52 then the file is created if it doesn't exist;
  53 otherwise the file is not created and
  54 .L \-1
  55 is returned.
  56 If
  57 .L "force < 0"
  58 then
  59 .L atime
  60 and
  61 .L mtime
  62 are taken verbatim; otherwise
  63 .L "(time_t)(-1)"
  64 retains the current value for the file and
  65 .L "(time_t)(0)"
  66 uses the current time.
  67 .SH CAVEATS
  68 By default the change time is always changed to the current time.