STIME(2)                                                 STIME(2)

     NAME
          stime, settod - set time

     SYNOPSIS
          stime(tp)
          long *tp;

          long settod(toy)
          long toy;

     DESCRIPTION
          Stime sets the system's idea of the time and date.  Time,
          pointed to by tp, is measured in seconds from 0000 GMT Jan
          1, 1970.

          Settod sets the VAX hardware time-of-year clock to toy, and
          returns the previous value.  When the system is booted, the
          system's time is set from the time-of-year clock; while the
          system is running, the time-of-year clock is examined peri-
          odically, and the system's time adjusted slowly if necessary
          to make the two agree.

          Only the super-user may use these calls.

     SEE ALSO
          date(1), time(2), ctime(3)

     DIAGNOSTICS
          Zero is returned if the time was set; -1 if user is not the
          super-user.