Return to date.1 CVS log

Up to [CSRG BSD Unix] / 43BSDReno / bin / date

Annotation of 43BSDReno/bin/date/date.1, revision 1.1

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.