Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
ualarm(3C)		 Standard C Library Functions		    ualarm(3C)

NAME
       ualarm -	schedule signal	after interval in microseconds

SYNOPSIS
       #include	<unistd.h>

       useconds_t ualarm(useconds_t useconds, useconds_t interval);

DESCRIPTION
       The ualarm() function causes the	SIGALRM	signal to be generated for the
       calling process after the number	of real-time microseconds specified by
       the  useconds argument has elapsed.  When the interval argument is non-
       zero, repeated timeout notification occurs with a period	 in  microsec-
       onds  specified	by  the	interval argument. If the notification signal,
       SIGALRM,	is not caught or ignored, the calling process is terminated.

       Because of scheduling delays, resumption	of execution when  the	signal
       is caught may be	delayed	an arbitrary amount of time.

       Interactions  between  ualarm()	and  either  alarm(2) or sleep(3C) are
       unspecified.

RETURN VALUES
       The ualarm() function returns the number	of microseconds	remaining from
       the  previous ualarm() call.  If	no timeouts are	pending	or if ualarm()
       has not previously been called, ualarm()	returns	0.

ERRORS
       No errors are defined.

USAGE
       The ualarm() function is	a simplified interface	to  setitimer(2),  and
       uses the	ITIMER_REAL interval timer.

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE	TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+

SEE ALSO
       alarm(2), setitimer(2), sighold(3C), signal(3C),	sleep(3C), usleep(3C),
       attributes(5), standards(5)

SunOS 5.10			  14 Aug 2002			    ualarm(3C)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | USAGE | ATTRIBUTES | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=ualarm&sektion=3c&manpath=SunOS+5.10>

home | help