Provided by: manpages-fr-dev_4.26.0-1_all 
NOM
timer_settime, timer_gettime - Armer, désarmer et récupérer l'état d'une minuterie POSIX d'un processus
BIBLIOTHÈQUE
Bibliothèque de temps réel (librt, -lrt)
SYNOPSIS
#include <time.h>
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 fonctionnalités pour la glibc (consulter feature_test_macros(7)) :
timer_settime(), timer_gettime():
_POSIX_C_SOURCE >= 199309L
DESCRIPTION
timer_settime() arme et désarme la minuterie indiquée par timerid. Le paramètre 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 définie 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 mesurée en fonction de l'horloge
qui a été indiquée lorsque la minuterie a été créée avec timer_create(2).
Si new_value->it_value indique une valeur non nulle (c'est-à-dire qu'un de ses champs n'est pas nul),
alors timer_settime() arme (démarre) la minuterie, en la configurant pour qu'elle expire au moment donnée
(si la minuterie était déjà armée, sa configuration précédente est remplacée). Si new_value->it_value a
une valeur nulle (c'est-à-dire si ses deux champs sont nuls), alors la minuterie est désarmée.
Le champ new_value->it_interval indique la période de la minuterie, en secondes et nanosecondes. Si ce
champ n'est pas nul alors à chaque fois qu'une minuterie armée expire, la minuterie est rechargée avec la
valeur indiquée 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 défini par it_value est écoulé.
Par défaut, le temps d'expiration initial indiqué par new_value->it_value est interprété par rapport à
l'instant actuel sur l'horloge de la minuterie au moment de l'appel. Ceci peut être modifié en indiquant
TIMER_ABSTIME dans flags, new_value->it_value étant alors interprété comme une valeur absolue mesurée sur
l'horloge de la minuterie ; c'est-à-dire que la minuterie expirera quand la valeur de l'horloge atteint
la valeur indiquée par new_value->it_value. Si le temps absolu indiqué est déjà passé, alors la minuterie
expire immédiatement et le compteur de dépassement (consultez timer_getoverrun(2)) est positionné en
conséquence.
Si la valeur de l'horloge CLOCK_REALTIME est ajustée et qu'une minuterie absolue basée sur cette horloge
est armée, alors l'expiration de cette minuterie sera ajustée en conséquence. Les ajustements de
l'horloge CLOCK_REALTIME n'ont aucun effet sur les minuteries relatives basées sur cette horloge.
Si old_value n'est pas NULL, alors il pointe vers un tampon qui est utilisé pour renvoyer l'intervalle
précédent de la minuterie (dans old_value->it_interval) et la durée qu'il restait avant l'expiration
suivante de la minuterie (dans old_value->it_value).
timer_gettime() renvoie dans le tampon pointé par curr_value le temps restant avant l'expiration suivante
et l'intervalle de la minuterie indiquée par timerid. Le temps restant avant l'expiration suivante est
renvoyé dans curr_value->it_value ; il s'agit toujours d'une valeur relative, que le drapeau
TIMER_ABSTIME soit utilisé ou non lorsque la minuterie est armée. Si la valeur renvoyée dans
curr_value->it_value est nulle, alors la minuterie était désarmée au moment de l'appel. L'intervalle de
la minuterie est renvoyée dans curr_value->it_interval. Si la valeur renvoyée dans
curr_value->it_interval est nulle, alors il s'agit d'une minuterie à un coup.
VALEUR RENVOYÉE
En cas de réussite, timer_settime() et timer_gettime() renvoient zéro. En cas d'erreur, -1 est renvoyé et
errno indique le code d'erreur.
ERREURS
Ces fonctions peuvent échouer 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 échouer avec les erreurs suivantes :
EINVAL new_value.it_value est négatif ; ou new_value.it_value.tv_nsec est négatif ou supérieur à
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 française de cette page de manuel a été créée par Christophe Blaess
<https://www.blaess.fr/christophe/>, Stéphan Rafin <stephan.rafin@laposte.net>, Thierry Vignaud
<tvignaud@mandriva.com>, François Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe Guérard
<fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-luc.coulon@wanadoo.fr>, Julien Cristau
<jcristau@debian.org>, Thomas Huriaux <thomas.huriaux@gmail.com>, Nicolas François
<nicolas.francois@centraliens.net>, Florentin Duneau <fduneau@gmail.com>, Simon Paillard
<simon.paillard@resel.enst-bretagne.fr>, Denis Barbier <barbier@debian.org>, David Prévot
<david@tilapin.org>, Cédric Boutillier <cedric.boutillier@gmail.com>, Frédéric Hantrais
<fhantrais@gmail.com> et Jean-Pierre Giraud <jean-pierregiraud@neuf.fr>
Cette traduction est une documentation libre ; veuillez vous reporter à la GNU General Public License
version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.
Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à
debian-l10n-french@lists.debian.org.
Pages du manuel de Linux 6.9.1 2 mai 2024 timer_settime(2)