stime(2) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | ERRORS | CONFORMING TO | NOTES | SEE ALSO | COLOPHON

STIME(2)                  Linux Programmer's Manual                 STIME(2)

NAME         top

       stime - set time

SYNOPSIS         top

       #include <time.h>

       int stime(const time_t *t);

   Feature Test Macro Requirements for glibc (see feature_test_macros(7)):

       stime():
           Since glibc 2.19:
               _DEFAULT_SOURCE
           Glibc 2.19 and earlier:
               _SVID_SOURCE

DESCRIPTION         top

       NOTE: This function is deprecated; use clock_settime(2) instead.

       stime() sets the system's idea of the time and date.  The time,
       pointed to by t, is measured in seconds since the Epoch, 1970-01-01
       00:00:00 +0000 (UTC).  stime() may be executed only by the superuser.

RETURN VALUE         top

       On success, zero is returned.  On error, -1 is returned, and errno is
       set appropriately.

ERRORS         top

       EFAULT Error in getting information from user space.

       EPERM  The calling process has insufficient privilege.  Under Linux,
              the CAP_SYS_TIME privilege is required.

CONFORMING TO         top

       SVr4.

NOTES         top

       Starting with glibc 2.31, this function is no longer available to
       newly linked applications and is no longer declared in <time.h>.

SEE ALSO         top

       date(1), settimeofday(2), capabilities(7)

COLOPHON         top

       This page is part of release 5.09 of the Linux man-pages project.  A
       description of the project, information about reporting bugs, and the
       latest version of this page, can be found at
       https://www.kernel.org/doc/man-pages/.

Linux                            2020-02-09                         STIME(2)

Pages that refer to this page: syscalls(2)aiocb(3)clockid_t(3)clock_t(3)dev_t(3)div_t(3)double_t(3)fenv_t(3)fexcept_t(3)file(3)FILE(3)float_t(3)gid_t(3)id_t(3)imaxdiv_t(3)int16_t(3)int32_t(3)int64_t(3)int8_t(3)intmax_t(3)intn_t(3)intN_t(3)intptr_t(3)lconv(3)ldiv_t(3)lldiv_t(3)off_t(3)pid_t(3)ptrdiff_t(3)regex_t(3)regmatch_t(3)regoff_t(3)siginfo_t(3)sigset_t(3)sigval(3)size_t(3)ssize_t(3)suseconds_t(3)timer_t(3)timespec(3)time_t(3)timeval(3)uid_t(3)uint16_t(3)uint32_t(3)uint64_t(3)uint8_t(3)uintmax_t(3)uintn_t(3)uintN_t(3)uintptr_t(3)va_list(3)void(3)rtc(4)capabilities(7)system_data_types(7)