NOM

       ualarm - Programmer un signal après un nombre donné de microsecondes

BIBLIOTHÈQUE

       Bibliothèque C standard (libc, -lc)

SYNOPSIS

       #include <unistd.h>

       useconds_t ualarm(useconds_t usecs, useconds_t intervalle);

   Exigences de macros de test de fonctionnalités pour la glibc (consulter feature_test_macros(7)) :

       ualarm() :
           Depuis la glibc 2.12 :
               (_XOPEN_SOURCE >= 500) && ! (_POSIX_C_SOURCE >= 200809L)
                   || /* glibc >= 2.19 : */ _DEFAULT_SOURCE
                   || /* glibc <= 2.19 : */ _BSD_SOURCE
           Avant la glibc 2.12 :
               _BSD_SOURCE || _XOPEN_SOURCE >= 500

DESCRIPTION

       La  fonction  ualarm() programme le signal SIGALRM pour qu'il soit envoyé au processus appelant après (au
       moins) usecs microsecondes. Le délai peut être légèrement allongé par la charge  système,  par  le  temps
       passé à traiter l'appel système, ou par la granularité des timers système.

       À moins d'être capturé ou ignoré, le signal SIGALRM terminera le processus.

       Si  l'argument  intervalle  est  non  nul,  d'autres signaux SIGALRM seront envoyés toutes les intervalle
       microsecondes après le premier.

VALEUR RENVOYÉE

       Cette fonction renvoie le nombre de microsecondes restant pour toute alarme définie précédemment, ou zéro
       si aucune alarme n'est en attente.

ERREURS

       EINTR  Interruption par un signal ; consultez signal(7).

       EINVAL usecs ou intervalle est plus grand que 1 000 000 (1 seconde) (sur  les  systèmes  qui  considèrent
              qu'il s'agit d'une erreur).

ATTRIBUTS

       Pour une explication des termes utilisés dans cette section, consulter attributes(7).
       ┌──────────────────────────────────────────────────────────────────────┬──────────────────────┬─────────┐
       │ Interface                                                            │ Attribut             │ Valeur  │
       ├──────────────────────────────────────────────────────────────────────┼──────────────────────┼─────────┤
       │ ualarm()                                                             │ Sécurité des threads │ MT-Safe │
       └──────────────────────────────────────────────────────────────────────┴──────────────────────┴─────────┘

STANDARDS

       BSD 4.3,  POSIX.1-2001.  POSIX.1-2001 marque ualarm() comme obsolète. POSIX.1-2008 supprime la spécifica‐
       tion de ualarm(). 4.3BSD, SUSv2 et POSIX ne définissent pas d'erreurs.

NOTES

       POSIX.1-2001 ne spécifie pas ce qui se passe si le paramètre usecs vaut 0. Sur Linux (et probablement  la
       plupart des autres systèmes), l'effet est d'annuler toute alarme en attente.

       Le type useconds_t est un entier non signé capable de contenir des entiers dans l'intervalle [0,1000000].
       Dans  l'implémentation  BSD  d'origine  et  dans  la glibc avant la glibc 2.1, les paramètres de ualarm()
       étaient des unsigned int. Les programmes gagneront en portabilité en évitant de mentionner le  type  use‐
       conds_t explicitement.

       L'interaction  entre  cette  fonction et les autres fonctions de temporisations comme alarm(2), sleep(3),
       nanosleep(2), setitimer(2), timer_create(2), timer_delete(2), timer_getoverrun(2), timer_gettime(2),  ti‐
       mer_settime(2), usleep(3) n'est pas spécifiée.

       Cette  fonction est obsolète. Utilisez setitimer(2) ou des temporisations POSIX (timer_create(2), etc.) à
       la place.

VOIR AUSSI

       alarm(2), getitimer(2), nanosleep(2), select(2), setitimer(2), usleep(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 <tvi‐
       gnaud@mandriva.com>, François Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe  Guérard  <fe‐
       vrier@tigreraye.org>,  Jean-Luc Coulon (f5ibh) <jean-luc.coulon@wanadoo.fr>, Julien Cristau <jcristau@de‐
       bian.org>,  Thomas  Huriaux  <thomas.huriaux@gmail.com>,   Nicolas   François   <nicolas.francois@centra‐
       liens.net>, Florentin Duneau <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-bretagne.fr>,
       Denis Barbier <barbier@debian.org> et David Prévot <david@tilapin.org>

       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 à  de‐
       bian-l10n-french@lists.debian.org.

Pages du manuel de Linux 6.03                    5 février 2023                                        ualarm(3)