settimeofday(2)                DG/UX 5.4R3.00                settimeofday(2)


NAME
       settimeofday - set date and time

SYNOPSIS
       #include <sys/time.h>

       int    settimeofday (timevalue, timezone)
       struct timeval * timevalue;
       struct timezone * timezone;

   where:
       timevalue     Address of an initialized structure giving the new
                      current time

       timezone      NULL or address of an initialized structure giving the
                      new time zone

DESCRIPTION
       Settimeofday sets the system's notion of the current Greenwich time
       and the current time zone to the values contained in the structures
       at the locations specified by timevalue and timezone.

       When the time is successfully changed, a log of the change is sent to
       the error logger device.

       If timezone is NULL, the current time zone is not changed.

       The interpretation of the time value and time zone structures are
       discussed in gettimeofday.

       Although not enforced, it is unusual if the time zone correction,
       timezone.tzminuteswest, is not divisible by 60 minutes.

       Setting the system clock may interfere with other timing functions.

ACCESS CONTROL
       Only the superuser may set the time of day.

RETURN VALUE
       0      Completed successfully.

       -1     An error occurred.  errno is set to indicate the error.

DIAGNOSTICS
       Errno may be set to one of the following error codes:

       EFAULT    An argument address referenced invalid memory.

       EPERM     Permission to set the time is denied to the calling
                 process.

SEE ALSO
       date(1), gettimeofday(2), ctime(3C).




Licensed material--property of copyright holder(s)                         1