adjtime man page on DigitalUNIX

Man page or keyword search:  
man Server   12896 pages
apropos Keyword Search (all sections)
Output format
DigitalUNIX logo
[printable version]

adjtime(2)							    adjtime(2)

NAME
       adjtime - Correct the time to allow synchronization of the system clock

SYNOPSIS
       #include <sys/time.h>

       int adjtime(
	       struct timeval *delta,
	       struct timeval *old_delta );

PARAMETERS
       Points  to  the	amount of time to be altered.  Points to the number of
       nanoseconds still to be corrected from an earlier call.

DESCRIPTION
       The adjtime() function makes small adjustments to the system  time  (as
       returned by the gettimer() function), advancing or decreasing it by the
       time specified by the delta parameter  of  the  timeval	structure.  If
       delta  is  negative,  the  clock is slowed down by incrementing it more
       slowly than normal until the correction is complete. If delta is	 posi‐
       tive,  a	 larger	 increment than normal is used until the correction is
       complete.

       The skew used to perform the correction is generally a fraction of  one
       percent. Thus, the time is always a monotonically increasing function.

       A time correction from an earlier call to adjtime() may not be finished
       when adjtime() is called again. In this case, the delta remaining  from
       the  original call is replaced by the delta of the current call. If the
       old_delta parameter  is	nonzero,  then	when  the  adjtime()  function
       returns,	 the structure pointed to will contain the time remaining from
       the earlier call.

       This call may be used by time servers that synchronize  the  clocks  of
       computers  in  a	 local area network. Such time servers would slow down
       the clocks of some machines and speed up the clocks of others to	 bring
       them  to the average network time. The adjtime() function is restricted
       to users with the superuser privilege.

NOTES
       In BSD, system time is defined in units of  seconds  and	 microseconds,
       while in POSIX real time extensions, the units are seconds and nanosec‐
       onds.  However, the adjtime()  function	is  not	 specified  by	POSIX.
       Therefore, the existing BSD interface is preserved.

RETURN VALUES
       On  successful  completion, the adjtime() function returns 0 (zero). If
       the adjtime() function fails, it returns -1 and sets errno to  indicate
       the error.

ERRORS
       If the adjtime() function fails, errno may be set to one of the follow‐
       ing  values:  An	 argument  address  referenced	invalid	 memory.   The
       process's effective user ID does not have appropriate system privilege.

SEE ALSO
       Functions: gettimeofday(2), gettimer(3)

								    adjtime(2)
[top]

List of man pages available for DigitalUNIX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net