Provided by:
manpages-fr-dev_3.27fr1.4-1_all 
NOM
timer_getoverrun - Obtenir le nombre de depassements d'une minuterie
POSIX d'un processus
SYNOPSIS
#include <time.h>
int timer_getoverrun(timer_t timerid);
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_getoverrun() : _POSIX_C_SOURCE >= 199309L
DESCRIPTION
timer_getoverrun() renvoie le compteur de depassements pour la
minuterie indiquee par timerid. Une application peut utiliser le
compteur de depassements pour calculer avec precision le nombre
d'expiration qui se seraient ecoulee dans un intervalle de temps donne.
Les depassements de minuterie peuvent survenir lors de la reception
d'une notification par un signal (SIGEV_SIGNAL) ou par un thread
(SIGEV_THREAD).
Quand les notifications d'expiration sont fournies par un signal, les
depassements peuvent survenir de cette facon. Qu'un signal temps reel
soit utilise ou non pour les notifications de la minuterie, le systeme
empile au plus un signal par minuterie. (Il s'agit du comportement
specifie par POSIX.1-2001. L'alternative, empiler un signal pour chaque
expiration de minuterie, pourrait facilement depasser les limites
permises pour l'empilement de signaux sur le systeme.) Pour des raisons
de delais d'ordonnancement, ou parce que le signal peut avoir ete
bloque pendant un moment, il peut y avoir un delai entre le moment ou
le signal de notification est produit et le moment ou il est recu (par
le gestionnaire de signal) ou accepte (par exemple en utilisant
sigwaitinfo(2)). Dans cet intervalle, d'autres expirations de minuterie
peuvent survenir. Le compteur de depassements de la minuterie
correspond au nombre d'expirations supplementaires qui se sont
produites entre le moment ou le signal a ete produit et le moment ou il
a ete recu ou accepte.
Les depassements de minuterie peuvent aussi se produire lorsque les
notifications d'expirations sont fournies par un appel a un thread
puisqu'il peut y avoir un delai arbitraire entre l'expiration de la
minuterie et l'execution du thread de notification et que dans
l'intervalle de ce delai, d'autres expirations de minuterie peuvent se
produire.
VALEUR RENVOY'EE
S'il reussit, timer_getoverrun() renvoie le compteur d'expirations de
la minuterie indiquee ; ce compteur peut valoir 0 si aucune expiration
n'a eu lieu. S'il echoue, il renvoie -1 et ecrit errno en consequence.
ERREURS
EINVAL timerid n'est pas un identifiant de minuterie valable.
VERSIONS
Cet appel systeme est disponible depuis Linux 2.6.
CONFORMIT'E
POSIX.1-2001
NOTES
Lorsque les notifications de minuterie sont fournies par des signaux
(SIGEV_SIGNAL), il est possible sous Linux d'obtenir le compteur de
depassements par le champ si_overrun de la structure siginfo_t
(consultez sigaction(2)). Ce permet a une application d'eviter le
surcout d'un appel systeme pour obtenir le compteur de depassements,
mais est une extension a POSIX.1-2001 non portable.
POSIX.1-2001 ne mentionne les depassements de minuteries que dans le
contexte de notifications de minuteries par des signaux.
BOGUES
POSIX.1-2001 specifie que si le compteur de depassements de la
minuterie est superieur ou egal au maximum defini par l'implementation
(DELAYTIMER_MAX), alors timer_getoverrun() devrait renvoyer
DELAYTIMER_MAX. Cependant Linux n'implemente pas cette fonctionnalite :
a la place, si le nombre de depassements depasse l'entier le plus grand
representable, le compteur redemarre a partir des petites valeurs.
EXEMPLE
Consultez timer_create(2).
VOIR AUSSI
clock_gettime(2), sigaction(2), signalfd(2), sigwaitinfo(2),
timer_create(2), timer_delete(2), timer_settime(2), signal(7), time(7)
COLOPHON
Cette page fait partie de la publication 3.27 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_GETOVERRUN(2)