Nom

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

Résumé

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

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.

Notes

Les fonctions alarm et 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.

Conformité

SVr4, SVID, POSIX, X/OPEN, BSD 4.3

Voir aussi

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

Traduction

Christophe Blaess, 1996-2003.