Gets or sets the current value for the specified systemwide timer.
Standard C Library (libc.a)
#include <sys/time.h> #include <sys/types.h>
int gettimer( TimerType, Value)
timer_t TimerType;
struct timestruc_t * Value;
#include <sys/timers.h> #include <sys/types.h>
int gettimer( TimerType, Value)
timer_t TimerType;
struct itimerspec * Value;
int settimer(TimerType, TimePointer)
int TimerType;
const struct timestruc_t *TimePointer;
int restimer(TimerType, Resolution, MaximumValue)
int TimerType;
struct timestruc_t *Resolution, *MaximumValue;
int stime( Tp)
long *Tp;
#include <sys/types.h>
time_t time(Tp) time_t *Tp;
The settimer subroutine is used to set the current value of the TimePointer parameter for the systemwide timer, specified by the TimerType parameter.
When the gettimer subroutine is used with the function prototype in sys/timers.h, then except for the parameters, the gettimer subroutine is identical to the getinterval (getinterval, incinterval, absinterval, resinc, resabs, alarm, ualarm, getitimer or setitimer Subroutine) subroutine. Use of the getinterval subroutine is recommended, unless the gettimer subroutine is required for a standards-conformant application. The description and semantics of the gettimer subroutine are subject to change between releases, pending changes in the draft standard upon which the current gettimer subroutine description is based.
When the gettimer subroutine is used with the function prototype in /sys/timers.h, the gettimer subroutine returns an itimerspec structure to the pointer specified by the Value parameter. The it_value member of the itimerspec structure represents the amount of time in the current interval before the timer (specified by the TimerType parameter) expires, or a zero interval if the timer is disabled. The members of the pointer specified by the Value parameter are subject to the resolution of the timer.
When the gettimer subroutine is used with the function prototype in sys/time.h, the gettimer subroutine returns a timestruc structure to the pointer specified by the Value parameter. This structure holds the current value of the system wide timer specified by the Value parameter.
The resolution of any timer can be obtained by the restimer subroutine. The Resolution parameter represents the resolution of the specified timer. The MaximumValue parameter represents the maximum possible timer value. The value of these parameters are the resolution accepted by the settimer subroutine.
The time subroutine returns the time in seconds since the Epoch (that is, 00:00:00 GMT, January 1, 1970). The Tp parameter points to an area where the return value is also stored. If the Tp parameter is a null pointer, no value is stored.
The stime subroutine is implemented to provide compatibility with older AIX, AT&T System V, and BSD systems. It calls the settimer subroutine using the TIMEOFDAY timer.
The gettimer, settimer, restimer, and stime subroutines return a value of 0 (zero) if the call is successful. A return value of -1 indicates an error occurred, and errno is set.
The time subroutine returns the value of time in seconds since Epoch. Otherwise, a value of ((time_t) - 1) is returned and the errno global variable is set to indicate the error.
If an error occurs in the gettimer, settimer, restimer, or stime subroutine, a return value of - 1 is received and the errno global variable is set to one of the following error codes:
If the time subroutine is unsuccessful, a return value of -1 is received and the errno global variable is set to the following:
EFAULT | A parameter address referenced memory that was not valid. |
The asctime (ctime, localtime, gmtime, mktime, difftime, asctime, or tzset Subroutine) subroutine, clock (clock Subroutine) subroutine, ctime (ctime, localtime, gmtime, mktime, difftime, asctime, or tzset Subroutine) subroutine, difftime (ctime, localtime, gmtime, mktime, difftime, asctime, or tzset Subroutine) subroutine, getinterval (getinterval, incinterval, absinterval, resinc, resabs, alarm, ualarm, getitimer or setitimer Subroutine) subroutine, gmtime (ctime, localtime, gmtime, mktime, difftime, asctime, or tzset Subroutine) subroutine, localtime (ctime, localtime, gmtime, mktime, difftime, asctime, or tzset Subroutine) subroutine, mktime (ctime, localtime, gmtime, mktime, difftime, asctime, or tzset Subroutine) subroutine, strftime subroutine, strptime subroutine, utime subroutine.
List of Time Data Manipulation Services in AIX 5L Version 5.2 System Management Concepts: Operating System and Devices.
Subroutines Overview in AIX 5L Version 5.2 General Programming Concepts: Writing and Debugging Programs.