|
|
1.1 root 1: .TH CHDATE 1
2: .CT 1 files dirs
3: .SH NAME
4: touch, chdate \- set modification or access date of a file
5: .SH SYNOPSIS
6: .B touch
7: [
8: .B -c
9: ]
10: .I file ...
11: .PP
12: .B chdate
13: [
14: .B -am
15: ]
16: .I date file ...
17: .SH DESCRIPTION
18: .I Touch
19: attempts to set the modification time of the
20: .I files
21: to the current time.
22: If a
23: .I file
24: does not exist,
25: it will be created unless option
26: .B -c
27: is present.
28: .PP
29: .I Chdate
30: sets the access and modification times of
31: .I files.
32: The
33: .I date
34: comprises two or more arguments: a month (3 letters or more),
35: a day number, an optional time in hour:min[:sec] form, and an
36: optional year.
37: A missing year means a time in the last 12 months.
38: The options are
39: .TP
40: .B -a
41: Change the access time only.
42: .TP
43: .B -m
44: Change the modification time only.
45: .PP
46: .I Chdate
47: knows how to carry between fields of a date.
48: Only a file's owner or the super-user can change its date.
49: .SH EXAMPLES
50: .EX
51: .ta \w'chdate jul 4 12:00 1976 independence 'u
52: chdate jul 4 12:00 1976 independence
53: chdate jul -3 1976 independence # backdate one week
54: .EE
55: .SH SEE ALSO
56: .IR ls (1),
57: .IR utime
58: in
59: .IR chmod (2),
60: .IR stat (2),
61: .IR timec (3),
62: .IR chmod (1),
63: .IR chown (8)
64: .SH DIAGNOSTICS
65: .I Chdate
66: returns the number of files on which the date
67: could not be changed.
68: .SH BUGS
69: .I Touch
70: will not touch directories.
71: .PP
72: The first
73: .I file
74: name for
75: .I chdate
76: cannot begin with a digit.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.