| Skip Navigation Links | |
| Exit Print View | |
![]() | man pages section 3: Basic Library Functions Oracle Solaris 11 Information Library |
enable_extended_FILE_stdio(3C)
posix_spawnattr_getschedparam(3C)
posix_spawnattr_getschedpolicy(3C)
posix_spawnattr_getsigdefault(3C)
posix_spawnattr_getsigignore_np(3C)
posix_spawnattr_getsigmask(3C)
posix_spawnattr_setschedparam(3C)
posix_spawnattr_setschedpolicy(3C)
posix_spawnattr_setsigdefault(3C)
posix_spawnattr_setsigignore_np(3C)
posix_spawnattr_setsigmask(3C)
posix_spawn_file_actions_addclose(3C)
posix_spawn_file_actions_addclosefrom_np(3C)
posix_spawn_file_actions_adddup2(3C)
posix_spawn_file_actions_addopen(3C)
posix_spawn_file_actions_destroy(3C)
posix_spawn_file_actions_init(3C)
pthread_attr_getdetachstate(3C)
pthread_attr_getinheritsched(3C)
pthread_attr_getschedparam(3C)
pthread_attr_getschedpolicy(3C)
pthread_attr_setdetachstate(3C)
pthread_attr_setinheritsched(3C)
pthread_attr_setschedparam(3C)
pthread_attr_setschedpolicy(3C)
pthread_barrierattr_destroy(3C)
pthread_barrierattr_getpshared(3C)
pthread_barrierattr_setpshared(3C)
pthread_condattr_getpshared(3C)
pthread_condattr_setpshared(3C)
pthread_cond_reltimedwait_np(3C)
pthread_key_create_once_np(3C)
pthread_mutexattr_getprioceiling(3C)
pthread_mutexattr_getprotocol(3C)
pthread_mutexattr_getpshared(3C)
pthread_mutexattr_getrobust(3C)
pthread_mutexattr_setprioceiling(3C)
pthread_mutexattr_setprotocol(3C)
pthread_mutexattr_setpshared(3C)
pthread_mutexattr_setrobust(3C)
pthread_mutex_getprioceiling(3C)
pthread_mutex_reltimedlock_np(3C)
pthread_mutex_setprioceiling(3C)
pthread_rwlockattr_destroy(3C)
pthread_rwlockattr_getpshared(3C)
pthread_rwlockattr_setpshared(3C)
pthread_rwlock_reltimedrdlock_np(3C)
pthread_rwlock_reltimedwrlock_np(3C)
pthread_rwlock_timedrdlock(3C)
pthread_rwlock_timedwrlock(3C)
rctlblk_get_enforced_value(3C)
- create a timer
#include <signal.h>#include <time.h>inttimer_create(clockid_tclock_id,struct sigevent *restrictevp,timer_t *restricttimerid);
Thetimer_create() function creates a timer using the specified clock,clock_id, asthe timing base. Thetimer_create() function returns, in the location referenced bytimerid, a timer ID of typetimer_t used to identify the timer intimer requests. This timer ID will be unique within the calling processuntil the timer is deleted. The particular clock,clock_id, is defined in<time.h>. The timer whose ID is returned will be in a disarmed stateupon return fromtimer_create().
Theevp argument, if non-null, points to asigevent structure. This structure,allocated by the application, defines the asynchronous notification that will occur whenthe timer expires (seesignal.h(3HEAD) for event notification details). If theevpargument isNULL, the effect is as if theevp argument pointedto asigevent structure with thesigev_notify member having the valueSIGEV_SIGNAL,thesigev_signo having the valueSIGALARM, and thesigev_value member having thevalue of the timer ID.
The system defines a set of clocks that can be used astiming bases for per-process timers. The following values forclock_id are supported:
wall clock
user CPU usage clock
user and system CPU usage clock
non-adjustable, high-resolution clock
For timers created with aclock_id ofCLOCK_HIGHRES, the system will attemptto use an optimal hardware source. This may include, but is notlimited to, per-CPU timer sources. The actual hardware source used istransparent to the user and may change over the lifetime of the timer.For example, if the caller that created the timer were to changeits processor binding or its processor set, the system may elect todrive the timer with a hardware source that better reflects thenew binding. Timers based on aclock_id ofCLOCK_HIGHRES are ideally suitedfor interval timers that have minimal jitter tolerance.
Timers are not inherited by a child process across afork(2) andare disarmed and deleted by a call to one of theexecfunctions (seeexec(2)).
Upon successful completion,timer_create() returns0 and updates the location referenced bytimerid to atimer_t, which can be passed to the per-process timercalls. If an error occurs, the function returns-1 and setserrnoto indicate the error. The value oftimerid is undefined if anerror occurs.
Thetimer_create() function will fail if:
The system lacks sufficient signal queuing resources to honor the request, or the calling process has already created all of the timers it is allowed by the system.
The specified clock ID,clock_id, is not defined.
The specified clock ID,clock_id, isCLOCK_HIGHRES and the {PRIV_PROC_CLOCK_HIGHRES} is not asserted in the effective set of the calling process.
Seeattributes(5) for descriptions of the following attributes:
|
exec(2),fork(2),time(2),clock_settime(3C),signal(3C),signal.h(3HEAD),timer_delete(3C),timer_settime(3C),attributes(5),privileges(5),standards(5)
Copyright © 2011, Oracle and/or its affiliates. All rights reserved.Legal Notices | ![]() ![]() |