1.fp 5 CW 2.de Af 3.ds ;G \\*(;G\\f\\$1\\$3\\f\\$2 4.if !\\$4 .Af \\$2 \\$1 "\\$4" "\\$5" "\\$6" "\\$7" "\\$8" "\\$9" 5.. 6.de aF 7.ie \\$3 .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 41touch \- 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 48sets the access and modify times of the file named by 49.LR path . 50If 51.L "force != 0" 52then the file is created if it doesn't exist; 53otherwise the file is not created and 54.L \-1 55is returned. 56If 57.L "force < 0" 58then 59.L atime 60and 61.L mtime 62are taken verbatim; otherwise 63.L "(time_t)(-1)" 64retains the current value for the file and 65.L "(time_t)(0)" 66uses the current time. 67.SH CAVEATS 68By default the change time is always changed to the current time. 69