Provided by:
manpages-fr-dev_3.32d0.2p4-1_all 
NOM
timer_settime, timer_gettime - Armer, desarmer et recuperer l'etat
d'une minuterie POSIX d'un processus
SYNOPSIS
#include <time.h>
int timer_settime(timer_t timerid, int flags,
const struct itimerspec *new_value,
struct itimerspec * old_value);
int timer_gettime(timer_t timerid, struct itimerspec *curr_value);
Effectuez l'edition des liens avec l'option -lrt.
Exigences de macros de test de fonctionnalites pour la glibc (consultez
feature_test_macros(7)) :
timer_settime(), timer_gettime(): _POSIX_C_SOURCE >= 199309L
DESCRIPTION
timer_settime() arme et desarme la minuterie indiquee par timerid. Le
parametre new_value est une structure itimerspec qui indique la
nouvelle valeur initiale et le nouvel intervalle pour la minuterie. La
structure itimerspec est definie comme ceci :
struct timespec {
time_t tv_sec; /* Secondes */
long tv_nsec; /* Nanosecondes */
};
struct itimerspec {
struct timespec it_interval; /* Intervalle pour les
minuteries periodiques */
struct timespec it_value; /* Expiration initiale */
};
Chacune des sous-structures de la structure itimerspec est une
structure timespec qui permet d'indiquer une valeur en secondes et en
nanosecondes. Ces valeurs sont mesuree en fonction de l'horloge qui a
ete indiquee lorsque la minuterie a ete creee avec timer_create(2).
Si new_value->it_value indique une valeur non nulle (c'est-a-dire qu'un
de ses champs n'est pas nul), alors timer_settime() arme (demarre) la
minuterie, en la configurant pour qu'elle expire au moment donnee (si
la minuterie etait deja armee, sa configuration precedente est
remplacee). Si new_value->it_value a une valeur nulle (c'est-a-dire si
ses deux champs sont nuls), alors la minuterie est desarmee.
Le champ new_value->it_interval indique la periode de la minuterie, en
secondes et nanosecondes. Si ce champ n'est pas nul alors a chaque fois
qu'une minuterie armee expire, la minuterie est rechargee avec la
valeur indiquee dans new_value->it_interval. Si new_value->it_interval
est nul, alors la minuterie n'expire qu'une fois, une fois que le temps
defini par it_value est ecoule.
Par defaut, le temps d'expiration initial indique par
new_value->it_value est interprete par rapport a l'instant actuel sur
l'horloge de la minuterie au moment de l'appel. Ceci peut etre modifie
en indiquant TIMER_ABSTIME dans flags, new_value->it_value etant alors
interprete comme une valeur absolue mesuree sur l'horloge de la
minuterie ; c'est-a-dire que la minuterie expirera quand la valeur de
l'horloge atteint la valeur indiquee par new_value->it_value. Si le
temps absolu indique est deja passe, alors la minuterie expire
immediatement et le compteur de depassement (consultez
timer_getoverrun(2)) est positionne en consequence.
Si la valeur de l'horloge CLOCK_REALTIME est ajustee et qu'une
minuterie absolue basee sur cette horloge est armee, alors l'expiration
de cette minuterie sera ajustee en consequence. Les ajustements de
l'horloge CLOCK_REALTIME n'ont aucun effet sur les minuteries relatives
basees sur cette horloge.
Si old_value n'est pas NULL, alors elle renvoie l'intervalle precedent
de la minuterie (dans old_value->it_interval) et la duree qu'il restait
avant l'expiration suivante de la minuterie (dans old_value->it_value).
timer_gettime() renvoie dans le tampon pointe par curr_value le temps
restant avant l'expiration suivante et l'intervalle de la minuterie
indiquee par timerid. Le temps restant avant l'expiration suivante est
renvoye dans curr_value->it_value ; il s'agit toujours d'une valeur
relative, que le drapeau TIMER_ABSTIME soit utilise ou non lorsque la
minuterie est armee. Si la valeur renvoyee dans curr_value->it_value
est nulle, alors la minuterie etait desarmee au moment de l'appel.
L'intervalle de la minuterie est renvoyee dans curr_value->it_interval.
Si la valeur renvoyee dans curr_value->it_interval est nulle, alors il
s'agit d'une minuterie a un coup.
VALEUR RENVOY'EE
En cas de reussite, timer_settime() et timer_gettime() renvoient zero.
En cas d'erreur, -1 est renvoye et errno indique le code d'erreur.
ERREURS
Ces fonctions peuvent echouer avec les erreurs suivantes :
EFAULT new_value, old_value ou curr_value n'est pas un pointeur
valable.
EINVAL timerid n'est pas valable
timer_settime() peut echouer avec les erreurs suivantes :
EINVAL new_value.it_value est negatif ; ou new_value.it_value.tv_nsec
est negatif ou superieur a 999,999,999.
VERSIONS
Ces appels systemes sont disponibles depuis Linux 2.6.
CONFORMIT'E
POSIX.1-2001.
EXEMPLE
Consultez timer_create(2).
VOIR AUSSI
timer_create(2), timer_getoverrun(2), time(7)
COLOPHON
Cette page fait partie de la publication 3.32 du projet man-pages
Linux. Une description du projet et des instructions pour signaler des
anomalies peuvent etre trouvees a l'adresse
<URL:http://www.kernel.org/doc/man-pages/>.
TRADUCTION
Depuis 2010, cette traduction est maintenue a l'aide de l'outil po4a
<URL:http://po4a.alioth.debian.org/> par l'equipe de traduction
francophone au sein du projet perkamon
<URL:http://perkamon.alioth.debian.org/>.
Nicolas Francois et l'equipe francophone de traduction de
Debian (2006-2009).
Veuillez signaler toute erreur de traduction en ecrivant a
<debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le
paquet manpages-fr.
Vous pouvez toujours avoir acces a la version anglaise de ce document
en utilisant la commande << man -L C <section> <page_de_man> >>.
Linux 20 fevrier 2009 TIMER_SETTIME(2)