Linux Certif

Toute la documentation sur la certification Linux LPI

alarm

NOM

alarm - Programmer un réveil pour l'émission d'un signal

SYNOPSIS

 #include <unistd.h>
 
 unsigned int alarm(unsigned int nb_sec);
 

DESCRIPTION

alarm() programme une temporisation pour qu'elle envoie un signal SIGALRM au processus en cours dans nb_sec secondes. Si le signal n'est pas bloqué ou intercepté, sa réception terminera le processus.

Si nb_sec vaut zéro, aucune alarme n'est planifiée.

Dans tous les cas, l'appel alarm() annule l'éventuelle programmation précédente.

VALEUR RENVOYÉE

alarm() renvoie le nombre de secondes qu'il restait de la programmation précédente (annulée), ou zéro si aucune alarme n'avait été planifiée auparavant.

CONFORMITÉ

SVr4, POSIX.1-2001, BSD 4.3

NOTES

Les fonctions alarm() et setitimer(2) partagent la même temporisation, aussi l'appel de l'une interfère avec l'utilisation de l'autre.

sleep(3) peut être implémentée en utilisant SIGALRM, aussi il est déconseillé de mélanger les appels alarm() et sleep(3).

Les délais dûs au multitâche peuvent, comme toujours, retarder le déclenchement d'une alarme d'une durée arbitraire.

VOIR AUSSI

gettimeofday(2), pause(2), setitimer(2), sigaction(2), signal(2), select(2), sleep(3), time(7)

TRADUCTION

Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 9 octobre 1996 et révisée le 28 novembre 2007.

L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 2 alarm ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.