Return to date.1 CVS log

Up to [CSRG BSD Unix] / 43BSDTahoe / man / man1

Annotation of 43BSDTahoe/man/man1/date.1, revision 1.1.1.1

1.1       root        1: .\" Copyright (c) 1980 Regents of the University of California.
                      2: .\" All rights reserved.  The Berkeley software License Agreement
                      3: .\" specifies the terms and conditions for redistribution.
                      4: .\"
                      5: .\"    @(#)date.1      6.6 (Berkeley) 4/1/87
                      6: .\"
                      7: .TH DATE 1 "April 1, 1987"
                      8: .UC 4
                      9: .SH NAME
                     10: date \- print and set the date
                     11: .SH SYNOPSIS
                     12: .B date
                     13: .RB "[-nu] [-d dst] [-t minutes_west] [yymmddhhmm [" . "ss] ]"
                     14: .SH DESCRIPTION
                     15: If no arguments are given, the current date and time are
                     16: printed.  Providing an argument will set the desired date;
                     17: only the superuser can set the date. The \fI-d\fP and \fI-t\fP
                     18: flags set the kernel's values for daylight savings time and
                     19: minutes west of GMT.  If \fIdst\fP is non-zero, future calls
                     20: to \fIgettimeofday\fP(2) will return a non-zero \fItz_dsttime\fP.
                     21: \fIMinutes_west\fP provides the number of minutes returned
                     22: by future calls to \fIgettimeofday\fP(2) in \fItz_minuteswest\fP.  The
                     23: \fI-u\fP flag is used to display or set the date in GMT (universal) time.
                     24: .I yy
                     25: represents the last two digits of the year;
                     26: the first
                     27: .I mm
                     28: is the month number;
                     29: .I dd
                     30: is the day number;
                     31: .I hh
                     32: is the hour number (24 hour system);
                     33: the second
                     34: .I mm
                     35: is the minute number;
                     36: .BI . ss
                     37: is optional and represents the seconds.
                     38: For example:
                     39: .IP
                     40: date 8506131627
                     41: .PP
                     42: sets the date to June 13 1985, 4:27 PM.  The year, month and day may
                     43: be omitted; the default values will be the current ones.  The system
                     44: operates in GMT.  \fIDate\fP takes care of the conversion to and from
                     45: local standard and daylight-saving time.
                     46: .PP
                     47: If 
                     48: .I timed(8)
                     49: is running to synchronize the clocks of machines in a local
                     50: area network, \fIdate\fP sets the time globally on all those
                     51: machines unless the
                     52: .B \-n
                     53: option is given.
                     54: .SH FILES
                     55: /usr/adm/wtmp to record time-setting.
                     56: In /usr/adm/messages, \fIdate\fP records the name of the user
                     57: setting the time.
                     58: .SH SEE ALSO
                     59: gettimeofday(2), utmp(5), timed(8),
                     60: .br
                     61: \fITSP: The Time Synchronization Protocol for UNIX 4.3BSD\fP, 
                     62: R. Gusella and S. Zatti
                     63: .SH DIAGNOSTICS
                     64: Exit status is 0 on success, 1 on complete failure to set the date,
                     65: and 2 on successfully setting the local date but failing globally.
                     66: .PP
                     67: Occasionally, when \fItimed\fP synchronizes the time on many hosts, 
                     68: the setting of a new time value may require more than a few seconds.
                     69: On these occasions, \fIdate\fP prints: `Network time being set'.
                     70: The message `Communication error with timed' occurs when the communication
                     71: between \fIdate\fP and \fItimed\fP fails.
                     72: .SH BUGS
                     73: The system attempts to keep the date in a format closely compatible
                     74: with VMS.  VMS, however, uses local time (rather than GMT) and does
                     75: not understand daylight-saving time.  Thus, if you use both UNIX
                     76: 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.