Caution: This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

settimeofday()

Set the time and date

Synopsis:

#include <sys/time.h>

int settimeofday( const struct timeval *when,
                  void *not_used );

Arguments:

when
A pointer to a timeval structure that specifies the the time that you want to set. The struct timeval contains the following members:
not_used
This pointer must be NULL or the behavior of settimeofday() is unspecified. This argument is provided only for backwards compatibility.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

This function sets the time and date to the values stored in the structure pointed to by when.

Returns:

0, or -1 if an error occurred (errno is set).

Errors:

EFAULT
An error occurred while accessing the when buffer.
EPERM
The calling process doesn't have superuser permissions.

Classification:

Legacy Unix

Safety:
Cancellation point No
Interrupt handler No
Signal handler Yes
Thread Yes

Caveats:

The settimeofday() function is provided for compatibility with existing Unix code. You shouldn't use it in new code — use clock_settime() instead.

See also:

asctime(), asctime_r(), clock_gettime(), clock_settime(), ctime(), ctime_r(), difftime(), gettimeofday(), gmtime(), gmtime_r(), localtime(), localtime_r(), time()