ualarm − Programmer un signal après un nombre donné de microsecondes.

/* version BSD */
#include <unistd.h>

unsigned int ualarm(unsigned int usecs, unsigned int interval);

/* version SUSv2 */
#define _XOPEN_SOURCE 500
#include <unistd.h>

useconds_t ualarm(useconds_t usecs, useconds_t interval);

La fonction ualarm() programme le signal SIGALRM pour qu’il soit envoyé au processus appelant après (au moins) usecs micro-secondes. Le délai peut être légèrement allongé par la charge système, par le temps passé à traiter l’appel système, ou par la granularité des timers système.

à moins d’être capturé ou ignoré, ce signal terminera le processus.

Si l’argument interval est non-nul, d’autres signaux SIGALR seront envoyés toutes les interval micro-secondes après le premier.

Cette fonction renvoie le nombre de micro-secondes restant de l’appel précédent, ou zéro si aucune alarme n’est en attente.

EINTR

Interruption par un signal.

EINVAL

usecs ou interval est plus grand que 1 000 000 (1 seconde) (sur les systèmes qui considèrent qu’il s’agit d’une erreur).

BSD 4.3, POSIX.1-2001. BSD 4.3, SUSv2 et POSIX ne définissent pas d’erreurs.

Le type useconds_t est un entier non signé capable de contenir des entiers dans l’intervalle [0,1000000]. Ce type est défini dans <sys/types.h> inclus par <unistd.h> mais glibc ne le définit que si _XOPEN_SOURCE a une valeur supérieure ou égale à 500, ou si _XOPEN_SOURCE et _XOPEN_SOURCE_EXTENDED sont toutes deux définies. Les programmes seront plus portables s’ils évitent d’utiliser ce type.

Les interactions entre cette fonction et les autres temporisations comme alarm(), sleep(), nanosleep(), setitimer(), timer_create(), timer_delete(), timer_getoverrun(), timer_gettime(), timer_settime(), usleep() n’est pas spécifiée.

Cette fonction est obsolète, utilisez nanosleep(2) ou setitimer(2) à sa place.

alarm(2), getitimer(2), nanosleep(2), select(2), setitimer(2), usleep(3), feature_test_macros(7)

Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 30 juillet 2003 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 3 ualarm ». N’hésitez pas à signaler à l’auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.