Annotation of src/usr.bin/touch/touch.1, Revision 1.1.1.1
1.1 deraadt 1: .\" $NetBSD: touch.1,v 1.8 1995/08/31 22:10:05 jtc Exp $
2: .\"
3: .\" Copyright (c) 1991, 1993
4: .\" The Regents of the University of California. All rights reserved.
5: .\"
6: .\" This code is derived from software contributed to Berkeley by
7: .\" the Institute of Electrical and Electronics Engineers, Inc.
8: .\"
9: .\" Redistribution and use in source and binary forms, with or without
10: .\" modification, are permitted provided that the following conditions
11: .\" are met:
12: .\" 1. Redistributions of source code must retain the above copyright
13: .\" notice, this list of conditions and the following disclaimer.
14: .\" 2. Redistributions in binary form must reproduce the above copyright
15: .\" notice, this list of conditions and the following disclaimer in the
16: .\" documentation and/or other materials provided with the distribution.
17: .\" 3. All advertising materials mentioning features or use of this software
18: .\" must display the following acknowledgement:
19: .\" This product includes software developed by the University of
20: .\" California, Berkeley and its contributors.
21: .\" 4. Neither the name of the University nor the names of its contributors
22: .\" may be used to endorse or promote products derived from this software
23: .\" without specific prior written permission.
24: .\"
25: .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
26: .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
27: .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
28: .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
29: .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
30: .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
31: .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
32: .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
33: .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
34: .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
35: .\" SUCH DAMAGE.
36: .\"
37: .\" @(#)touch.1 8.3 (Berkeley) 4/28/95
38: .\"
39: .Dd April 28, 1995
40: .Dt TOUCH 1
41: .Os
42: .Sh NAME
43: .Nm touch
44: .Nd change file access and modification times
45: .Sh SYNOPSIS
46: .Nm touch
47: .Op Fl acfm
48: .Op Fl r Ar file
49: .Op Fl t Ar [[CC]YY]MMDDhhmm[.SS]
50: .Ar file ...
51: .Sh DESCRIPTION
52: The
53: .Nm touch
54: utility sets the modification and access times of files to the
55: current time of day.
56: If the file doesn't exist, it is created with default permissions.
57: .Pp
58: The following options are available:
59: .Bl -tag -width Ds
60: .It Fl a
61: Change the access time of the file.
62: The modification time of the file is not changed unless the
63: .Fl m
64: flag is also specified.
65: .It Fl c
66: Do not create the file if it does not exist.
67: The
68: .Nm touch
69: utility does not treat this as an error.
70: No error messages are displayed and the exit value is not affected.
71: .It Fl f
72: Attempt to force the update, even if the file permissions do not
73: currently permit it.
74: .It Fl m
75: Change the modification time of the file.
76: The access time of the file is not changed unless the
77: .Fl a
78: flag is also specified.
79: .It Fl r
80: Use the access and modifications times from the specified file
81: instead of the current time of day.
82: .It Fl t
83: Change the access and modification times to the specified time.
84: The argument should be in the form
85: .Dq [[CC]YY]MMDDhhmm[.SS]
86: where each pair of letters represents the following:
87: .Pp
88: .Bl -tag -width Ds -compact -offset indent
89: .It Ar CC
90: The first two digits of the year (the century).
91: .It Ar YY
92: The second two digits of the year.
93: If
94: .Dq YY
95: is specified, but
96: .Dq CC
97: is not, a value for
98: .Dq YY
99: between 69 and 99 results in a
100: .Dq CC
101: value of 19.
102: Otherwise, a
103: .Dq CC
104: value of 20 is used.
105: .It Ar MM
106: The month of the year, from 1 to 12.
107: .It Ar DD
108: the day of the month, from 1 to 31.
109: .It Ar hh
110: The hour of the day, from 0 to 23.
111: .It Ar mm
112: The minute of the hour, from 0 to 59.
113: .It Ar SS
114: The second of the minute, from 0 to 61.
115: .El
116: .Pp
117: If the
118: .Dq CC
119: and
120: .Dq YY
121: letter pairs are not specified, the values default to the current
122: year.
123: If the
124: .Dq SS
125: letter pair is not specified, the value defaults to 0.
126: .El
127: .Pp
128: The
129: .Nm touch
130: utility exits 0 on success, and >0 if an error occurs.
131: .Sh SEE ALSO
132: .Xr utimes 2
133: .Sh COMPATIBILITY
134: The obsolescent form of
135: .Nm touch ,
136: where a time format is specified as the first argument, is supported.
137: When no
138: .Fl r
139: or
140: .Fl t
141: option is specified, there are at least two arguments, and the first
142: argument is a string of digits either eight or ten characters in length,
143: the first argument is interpreted as a time specification of the form
144: .Dq MMDDhhmm[YY] .
145: .Pp
146: The
147: .Dq MM ,
148: .Dq DD ,
149: .Dq hh
150: and
151: .Dq mm
152: letter pairs are treated as their counterparts specified to the
153: .Fl t
154: option.
155: If the
156: .Dq YY
157: letter pair is in the range 69 to 99, the year is set to 1969 to 1999,
158: otherwise, the year is set in the 21st century.
159: .Sh HISTORY
160: A
161: .Nm touch
162: utility appeared in
163: .At v7 .
164: .Sh STANDARDS
165: The
166: .Nm touch
167: utility is expected to be a superset of the
168: .St -p1003.2
169: specification.