settimeofday(2)            DG/UX 4.30             settimeofday(2)



     NAME
          settimeofday - Set date and time.

     SYNOPSIS
          #include <sys/time.h>

          int   settimeofday  (time_value, time_zone)
          struct timeval *  time_value;
          struct timezone * time_zone;

     PARAMETERS
          time_value     Address of an initialized structure giving
                         the new current time.


          time_zone      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
          <time_value> and <time_zone>.

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

          If <time_zone> 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, <time_zone.tz_minuteswest>, 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.

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



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

     settimeofday(2)            DG/UX 4.30             settimeofday(2)



          EFAULT         An argument address referenced invalid
                         memory.


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

     SEE ALSO
          The related manual sections:  date(1),
          gettimeofday(2),
          ctime(3).












































     Licensed material--property of copyright holder(s)         Page 2