stime(2)                   DG/UX 4.30                    stime(2)



     NAME
          stime - Set time.

     SYNOPSIS
          int   stime  (seconds)
          long *          seconds;

     PARAMETERS
          seconds        Address of an initialized longword
                         interpreted as the new system time.

     DESCRIPTION
          Stime sets the system's notion of the current Greenwich time
          to the value contained in the longword at the location
          specified by <seconds>.

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

          The time value specified is interpreted as Greenwich time
          expressed in seconds since midnight January 1, 1970.

          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:


          EPERM          Permission to change the system time is
                         denied to the calling process.


          EFAULT         The <seconds> argument references invalid
                         memory.

     SEE ALSO
          The related manual section:  time(2).







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