alarm − Programmer un réveil pour l’émission d’un signal.

#include <unistd.h>

unsigned int alarm(unsigned int nb_sec);

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.

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.

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

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

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

SVr4, POSIX.1-2001, BSD 4.3

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

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 14 août 2006.

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.