ALARM(2)

 .

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 10 décembre 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.