date(1) [bsd man page]

DATE(1) 						      General Commands Manual							   DATE(1)

NAME

       date - print and set the date

SYNOPSIS

       date [-nu] [-d dst] [-t timezone] [yymmddhhmm [.ss] ]

DESCRIPTION

       If  no arguments are given, the current date and time are printed.  Providing an argument will set the desired date; only the superuser can
       set the date.  The -d and -t flags set the kernel's values for daylight savings time and minutes west of GMT.  If dst is  non-zero,  future
       calls to gettimeofday(2) will return a non-zero tz_dsttime.  Timezone provides the number of minutes returned by future calls to gettimeof-
       day(2) in tz_minuteswest.  The -u flag is used to display or set the date in GMT (universal) time.  yy represents the last  two	digits	of
       the  year; the first mm is the month number; dd is the day number; hh is the hour number (24 hour system); the second mm is the minute num-
       ber; .ss is optional and represents the seconds.  For example:

	      date 8506131627

       sets the date to June 13 1985, 4:27 PM.	The year, month and day may be omitted; the default values will be the current ones.   The  system
       operates in GMT.  Date takes care of the conversion to and from local standard and daylight-saving time.

       If  timed(8)  is  running  to synchronize the clocks of machines in a local area network, date sets the time globally on all those machines
       unless the -n option is given.

FILES

       /usr/adm/wtmp to record time-setting.  In /usr/adm/messages, date records the name of the user setting the time.

SEE ALSO

       gettimeofday(2), utmp(5), timed(8),
       TSP: The Time Synchronization Protocol for UNIX 4.3BSD, R. Gusella and S. Zatti

DIAGNOSTICS

       Exit status is 0 on success, 1 on complete failure to set the date, and 2 on successfully setting the local date but failing globally.

       Occasionally, when timed synchronizes the time on many hosts, the setting of a new time value may require more  than  a	few  seconds.	On
       these occasions, date prints: `Network time being set'.	The message `Communication error with timed' occurs when the communication between
       date and timed fails.

BUGS

       The system attempts to keep the date in a format closely compatible with VMS.  VMS, however, uses local time (rather than GMT) and does not
       understand daylight-saving time.  Thus, if you use both UNIX and VMS, VMS will be running on GMT.

4th Berkeley Distribution					  March 24, 1987							   DATE(1)

TIMED(8)						      System Manager's Manual							  TIMED(8)

NAME

       timed - time server daemon

SYNOPSIS

       timed [ -t ] [ -M ] [ -n network ] [ -i network ]

DESCRIPTION

       Timed is the time server daemon and is normally invoked at boot time from the rc(8) file.  It synchronizes the host's time with the time of
       other machines in a local area network running timed(8).  These time servers will slow down the clocks of some machines and  speed  up  the
       clocks  of  others  to bring them to the average network time.  The average network time is computed from measurements of clock differences
       using the ICMP timestamp request message.

       The service provided by timed is based  on a master-slave scheme.  When timed(8) is started on a machine, it asks the master for  the  net-
       work  time  and	sets  the  host's clock to that time.  After that, it accepts synchronization messages periodically sent by the master and
       calls adjtime(2) to perform the needed corrections on the host's clock.

       It also communicates with date(1) in order to set the date globally, and with timedc(8), a timed control program.  If the  machine  running
       the  master  crashes,  then  the slaves will elect a new master from among slaves running with the -M flag.  A timed running without the -M
       flag will remain a slave.  The -t flag enables timed to trace the messages it receives in the  file  /usr/adm/timed.log.   Tracing  can	be
       turned on or off by the program timedc(8).  Timed normally checks for a master time server on each network to which it is connected, except
       as modified by the options described below.  It will request synchronization service from the first master server located.  If permitted by
       the  -M	flag,  it  will  provide  synchronization service on any attached networks on which no current master server was detected.  Such a
       server propagates the time computed by the top-level master.  The -n flag, followed by the name of a network which the host is connected to
       (see  networks(5)), overrides the default choice of the network addresses made by the program.  Each time the -n flag appears, that network
       name is added to a list of valid networks.  All other networks are ignored.  The -i flag, followed by the name of a network  to	which  the
       host  is  connected  (see  networks(5)),  overrides the default choice of the network addresses made by the program.  Each time the -i flag
       appears, that network name is added to a list of networks to ignore.  All other networks are used by the time daemon.  The -n and -i  flags
       are meaningless if used together.

FILES

       /usr/adm/timed.log	    tracing file for timed
       /usr/adm/timed.masterlog     log file for master timed

SEE ALSO

       date(1), adjtime(2), gettimeofday(2), icmp(4P), timedc(8),
       TSP: The Time Synchronization Protocol for UNIX 4.3BSD, R. Gusella and S. Zatti

4.3 Berkeley Distribution					 November 17, 1996							  TIMED(8)