![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to date.1 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [CSRG BSD Unix] / 43BSDReno / bin / date|
Return to date.1 CVS log | Up to [CSRG BSD Unix] / 43BSDReno / bin / date |
1.1 root 1: .\" Copyright (c) 1980, 1990 The Regents of the University of California.
2: .\" All rights reserved.
3: .\"
4: .\" Redistribution and use in source and binary forms are permitted provided
5: .\" that: (1) source distributions retain this entire copyright notice and
6: .\" comment, and (2) distributions including binaries display the following
7: .\" acknowledgement: ``This product includes software developed by the
8: .\" University of California, Berkeley and its contributors'' in the
9: .\" documentation or other materials provided with the distribution and in
10: .\" all advertising materials mentioning features or use of this software.
11: .\" Neither the name of the University nor the names of its contributors may
12: .\" be used to endorse or promote products derived from this software without
13: .\" specific prior written permission.
14: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
15: .\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
16: .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
17: .\"
18: .\" @(#)date.1 6.8 (Berkeley) 7/24/90
19: .\"
20: .Dd July 24, 1990
21: .Dt DATE 1
22: .Os BSD 4.4
23: .Sh NAME
24: .Nm date
25: .Nd Display or set date and time
26: .Sh SYNOPSIS
27: .Nm date
28: .Op Fl nu
29: .Op Fl d Ar dst
30: .Op Fl t Ar minutes_west
31: .Op yymmddhhmm [\&.ss]
32: .Sh DESCRIPTION
33: .Nm Date
34: displays today's date and time when invoked without
35: arguments. Providing an argument will set the desired date;
36: only the superuser can set the date.
37: .Pp
38: Options are:
39: .Pp
40: .Tw Ds
41: .Tp Fl d
42: Set the kernel's values for daylight savings time.
43: If
44: .Ar dst
45: is non-zero, future calls
46: to
47: .Xr gettimeofday 2
48: will return a non-zero
49: .Ql tz_dsttime .
50: .Tp Fl t
51: Set the kernel's values for minutes west of GMT.
52: .Ar Minutes_west
53: provides the number of minutes returned by future calls to
54: .Xr gettimeofday 2
55: in
56: .Ql tz_minuteswest .
57: .Tp Fl u
58: Display or set the date in GMT (universal) time.
59: .Tp
60: .Pp
61: The canonical representation for setting the date and time:
62: .Dw Ds
63: .Dp Ar yy
64: Year in abbreviated form (.e.g 89 for 1989).
65: .Dp Ar mm
66: Numeric month.
67: A number from 01 to 12.
68: .Dp Ar dd
69: Day, a number from 01 to 31.
70: .Dp Ar hh
71: Hour, a number from 00 to 24.
72: .Dp Ar mm
73: Minutes, a number from 00 to 60.
74: .Dp Ar .ss
75: Seconds, a number from 00 to 60.
76: .Dp
77: The command:
78: .Pp
79: .Dl date 8506131627
80: .Pp
81: sets the date to June 13 1985, 4:27 PM.
82: .Pp
83: To reset today's time, the incantation can be shortened
84: to just the hours and minutes:
85: .Pp
86: .Dl date 1432
87: .Pp
88: sets the time to 2:32 PM, unaffecting the date.
89: .Pp
90: Providing a system stays running, date will handle
91: time changes for daylight/standards savings time and leap times.
92: .Pp
93: If
94: .Xr timed 8
95: is running to synchronize the clocks of machines in a local
96: area network,
97: .Nm date
98: sets the time globally on all those
99: machines unless the
100: .Fl n
101: option is given.
102: .Sh FILES
103: .Dw /var/log/messages
104: .Di L
105: .Dp Pa /var/log/wtmp
106: A record of date resets and time changes.
107: .Dp Pa /var/log/messages
108: A record of the name of the user
109: setting the time.
110: .Sh SEE ALSO
111: .Xr gettimeofday 2 ,
112: .Xr utmp 5 ,
113: .Xr timed 8
114: .br
115: .Em TSP:\ The\ Time\ Synchronization Protocol
116: .Em for UNIX 4.3BSD ,
117: R. Gusella
118: and\ S.\ Zatti
119: .Sh HISTORY
120: .Nm Date
121: appeared in Version 6 AT&T UNIX.
122: .Sh DIAGNOSTICS
123: Exit status is 0 on success, 1 on complete failure to set the date,
124: and 2 on successfully setting the local date but failing globally.
125: .Pp
126: Occasionally, when
127: .Xr timed
128: synchronizes the time on many hosts,
129: the setting of a new time value may require more than a few seconds.
130: On these occasions,
131: .Nm date
132: prints: `Network time being set'.
133: The message `Communication error with timed' occurs when the communication
134: between
135: .Nm date
136: and
137: .Xr timed
138: fails.
139: .Sh BUGS
140: The system attempts to keep the date in a format closely compatible
141: with VMS. VMS, however, uses local time (rather than GMT) and does
142: not understand daylight-saving time. Thus, if you use both UNIX
143: and VMS, VMS will be running on GMT.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.