sys_timer_create  [kernel/posix-timers.c]


Create a POSIX interval timer clock.

Arguments

eax 259
ebx Clock type:
CLOCK_REALTIME System-wide realtime clock.
CLOCK_MONOTONIC Represents monotonic time. Cannot be set.
CLOCK_PROCESS_CPUTIME_ID High resolution per-process timer.
CLOCK_THREAD_CPUTIME_ID Thread-specific timer.
ecx

Pointer to a properly initialized sigevent structure. If ecx is 0 then no notification occurs when timer expires.

struc sigevent
{
.sigev_value    sigval
.sigev_signo    rd 1
.sigev_notify   rd 1
._tid:          ;rd 1
._sigev_thread: ;sigev_thread
._pad           rd 13
}

struc sigev_thread
{
._function  rd 1
._attribute rd 1
}

struc sigval
{
.sival_int: ;rd 1
.sival_ptr  rd 1
}

sigevent members:

sigev_value
Data passed with notification.
sigev_signo
Notification signal.
sigev_notify
Notification method. If sigev_notify is a non-NULL pointer, then sys_mq_notify registers the calling process to receive message notification. If sigev_notify is NULL, and the calling process is currently registered to receive notifications for this message queue, then the registration is removed; another process can then register to receive a message notification for this queue.
Following notification are supported:
SIGEV_NONE A "null" notification: the calling process is registered as the target for notification, but when a message arrives, no notification is sent.
SIGEV_SIGNAL Notify the process by sending the signal specified in sigev_signo. If the signal is caught with a signal handler that was registered using the sys_sigaction SA_SIGINFO flag, then the following fields are set in the siginfo_t structure that is passed as the second argument of the handler: si_code is set to SI_MESGQ; si_signo is set to the signal number; si_value is set to the value specified in sigev_value; si_pid is set to the PID of the process that sent the message; and si_uid is set to the real user ID of the sending process.
SIGEV_THREAD Deliver notification by invoking _function as the start function of a new thread. The function is invoked with sigev_value as its sole argument. If _attribute is not NULL, then it should point to a pthread_attr_t structure that defines attributes for the thread.
pthread_attr_t defined as follows:
_tid
*to be documented*
_function
Pointer to the function for thread notification.
_attribute
Pointer to the thread function attributes.
edx Pointer to a 4 bytes long buffer which will receive the timer ID.

Return values

If the system call succeeds the return value is 0.
If the system call fails the return value is one of the following errno values:

-EINVAL An invalid value in ebx was specified.
-EAGAIN The system could not process the request.
-EFAULT ecx points to an invalid location.

Remarks

n/a

Compatibility

n/a