stime

Purpose

     Sets the time.

Syntax

     int stime (tp)
     long *tp;

Description

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

Return Value

     Upon successful completion, a value of 0 is returned.  If
     the stime  system call fails,  a value of -1  is returned
     and errno is set to indicate the error.

Diagnostics

     The stime system call fails if the following is true:

     EPERM      The effective  user ID of the  calling process
                is not superuser.

Related Information

     In this book:  "time."