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     ! 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.