stime(S)                       6 January 1993                       stime(S)


 Name

    stime - set time

 Syntax


    cc  . . .  -lc


    int stime (tp)
    long *tp;


 Description

    The stime system call sets the system's idea of the time and date.  tp
    points to the value of time as measured in seconds from 00:00:00 GMT
    January 1, 1970.


    [EPERM]   stime fails if the effective user ID of the calling process is
              not super-user.


 Diagnostics

    Upon successful completion, a value of 0 is returned.  Otherwise, a value
    of -1 is returned, and errno is set to indicate the error.

 See also

    ctime(S), difftime(S), mktime(S), nlcxtime(S), time(S)

 Standards conformance

    stime is conformant with:
    AT&T SVID Issue 2; however, this routine has been withdrawn from XPG3.