diff options
Diffstat (limited to 'pkg/system/doc/touch.hlp')
-rw-r--r-- | pkg/system/doc/touch.hlp | 71 |
1 files changed, 71 insertions, 0 deletions
diff --git a/pkg/system/doc/touch.hlp b/pkg/system/doc/touch.hlp new file mode 100644 index 00000000..aedb35a0 --- /dev/null +++ b/pkg/system/doc/touch.hlp @@ -0,0 +1,71 @@ +.help touch Jan04 system +.ih +NAME +touch -- change file access and modification times +.ih +USAGE +touch files +.ih +PARAMETERS +.ls files +List of files to be created or touched. +.le +.ls create = yes +If enabled, the file will be created as a zero-length text file if it doesn't +already exist. +.le +.ls atime = yes +Change the access time of the file. Will not change the modification time +unless \fImtime\fR is also set. +.le +.ls mtime = yes +Change the modification time of the file. Will not change the access time +unless \fIatime\fR is also set. +.le +.ls time = "" +Time and date to set for the file. The format of this string may be any +of DD/MM/YY or CCYY-MM-DD (in which case time is assumed to be midnight of +that day), or CCYY-MM-DDTHH:MM:SS[.SSS...] to specify both date and time. +If not specified, the current system time is used unless the \fIref_file\fR +parameter is set. If specified, \fIref_file\fR will be ignored. +.le +.ls ref_file = "" +Use the corresponding times of the specified file for modifying the +times of the \fIinput_files\fR. If not specified, the current time is +used unless the \fItime\fR parameter is set. +.le +.ls verbose = no +Print verbose output of the files and times being reset. +.le +.ih +DESCRIPTION +The \fItouch\fR task sets the access and modification times of each file +in the \fIfiles\fR list. The file will be created if it does not already +exist when the \fIcreate\fR parameter is set. The time used can be +specified by \fItime\fR parameter or by the corresponding fields of the +file specified by \fIref_file\fR, otherwise the current system time will +be used. The task will update both the modification and access times of +the file unless disabled by the \fIatime\fR or \fImtime\fR parameter. + +.ih +EXAMPLES + +1. Update the times of all SPP source files in the current directory: + + cl> touch *.x + +2. Create an empty file on a remode node: + + cl> touch ursa!/data/trigger_file + +3. Reset the file modification time to 2:33:45 pm on June 5, 2003: + + cl> touch nite1.fits time="2003-06-05T14:23:45" + +4. Reset the file modification time to match dev$hosts: + + cl> touch nite1.fits ref_file=dev$hosts + +.ih +SEE ALSO +.endhelp |