timer_settime(2) System Calls Manual timer_settime(2) NOM timer_settime, timer_gettime - Armer, desarmer et recuperer l'etat d'une minuterie POSIX d'un processus BIBLIOTHEQUE Bibliotheque de temps reel (librt, -lrt) SYNOPSIS #include int timer_gettime(timer_t timerid, struct itimerspec *curr_value); int timer_settime(timer_t timerid, int flags, const struct itimerspec *restrict new_value, struct itimerspec *_Nullable restrict old_value); Exigences de macros de test de fonctionnalites pour la glibc (consulter 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 un pointeur vers une structure itimerspec qui indique la nouvelle valeur initiale et le nouvel intervalle pour la minuterie. La structure itimerspec est definie dans itimerspec(3type). Chacune des sous-structures de la structure itimerspec est une structure timespec(3) 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 il pointe vers un tampon qui est utilise pour renvoyer 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 RENVOYEE 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. STANDARDS POSIX.1-2008. HISTORIQUE Linux 2.6. POSIX.1-2001. EXEMPLES Consultez timer_create(2). VOIR AUSSI timer_create(2), timer_getoverrun(2), timespec(3), time(7) TRADUCTION La traduction francaise de cette page de manuel a ete creee par Christophe Blaess , Stephan Rafin , Thierry Vignaud , Francois Micaux, Alain Portal , Jean-Philippe Guerard , Jean-Luc Coulon (f5ibh) , Julien Cristau , Thomas Huriaux , Nicolas Francois , Florentin Duneau , Simon Paillard , Denis Barbier , David Prevot , Cedric Boutillier , Frederic Hantrais et Jean-Pierre Giraud Cette traduction est une documentation libre ; veuillez vous reporter a la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITE LEGALE. Si vous decouvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message a . Pages du manuel de Linux 6.06 31 octobre 2023 timer_settime(2)