ualarm(3)                  Library Functions Manual                  ualarm(3)

NOM
       ualarm - Programmer un signal apres un nombre donne de microsecondes

BIBLIOTHEQUE
       Bibliotheque C standard (libc, -lc)

SYNOPSIS
       #include <unistd.h>

       useconds_t ualarm(useconds_t usecs, useconds_t intervalle);

   Exigences de macros de test de fonctionnalites 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 envoye
       au processus appelant apres (au moins) usecs microsecondes. Le delai
       peut etre legerement allonge par la charge systeme, par le temps passe
       a traiter l'appel systeme, ou par la granularite des timers systeme.

       A moins d'etre capture ou ignore, le signal SIGALRM terminera le
       processus.

       Si l'argument intervalle est non nul, d'autres signaux SIGALRM seront
       envoyes toutes les intervalle microsecondes apres le premier.

VALEUR RENVOYEE
       Cette fonction renvoie le nombre de microsecondes restant pour toute
       alarme definie precedemment, ou zero 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 systemes qui considerent qu'il s'agit d'une erreur).

ATTRIBUTS
       Pour une explication des termes utilises dans cette section, consulter
       attributes(7).

       +---------------------------------+--------------------------+---------+
       |Interface                        | Attribut                 | Valeur  |
       +---------------------------------+--------------------------+---------+
       |ualarm()                         | Securite des threads     | MT-Safe |
       +---------------------------------+--------------------------+---------+
STANDARDS
       Aucun.

HISTORIQUE
       4.3BSD, POSIX.1-2001. POSIX.1-2001 le marque obsolete. Supprime dans
       POSIX.1-2008.

       4.3BSD, SUSv2 et POSIX ne definissent aucune erreur.

       POSIX.1-2001 ne specifie pas ce qui se passe si le parametre usecs
       vaut 0. Sur Linux (et probablement la plupart des autres systemes),
       l'effet est d'annuler toute alarme en attente.

       Le type useconds_t est un entier non signe capable de contenir des
       entiers dans l'intervalle [0,1000000]. Dans l'implementation BSD
       d'origine et dans la glibc avant la glibc 2.1, les parametres de
       ualarm() etaient des unsigned int. Les programmes gagneront en
       portabilite en evitant de mentionner le type useconds_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), timer_settime(2), usleep(3) n'est pas specifiee.

       Cette fonction est obsolete. Utilisez setitimer(2) ou des
       temporisations POSIX (timer_create(2), etc.) a la place.

VOIR AUSSI
       alarm(2), getitimer(2), nanosleep(2), select(2), setitimer(2),
       usleep(3), time(7)

TRADUCTION
       La traduction francaise de cette page de manuel a ete creee par
       Christophe Blaess <https://www.blaess.fr/christophe/>, Stephan Rafin
       <stephan.rafin@laposte.net>, Thierry Vignaud <tvignaud@mandriva.com>,
       Francois Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe
       Guerard <fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-
       luc.coulon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas
       Huriaux <thomas.huriaux@gmail.com>, Nicolas Francois
       <nicolas.francois@centraliens.net>, Florentin Duneau
       <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-
       bretagne.fr>, Denis Barbier <barbier@debian.org>, David Prevot
       <david@tilapin.org> et Jean-Pierre Giraud <jean-pierregiraud@neuf.fr>

       Cette traduction est une documentation libre ; veuillez vous reporter a
       la GNU General Public License version 3
       <https://www.gnu.org/licenses/gpl-3.0.html> 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 <debian-l10n-french@lists.debian.org>.

Pages du manuel de Linux 6.06   31 octobre 2023                      ualarm(3)