Standard C Library Functions                           ualarm(3C)



NAME
     ualarm - schedule signal after interval in microseconds

SYNOPSIS
     #include 

     usecondst ualarm(usecondst useconds, usecondst interval);


DESCRIPTION
     The ualarm() function causes the SIGALRM signal to  be  gen-
     erated 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 microseconds  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.

ERORS
     No errors are defined.

USAGE
     The ualarm() function is a simplified interface  to  setiti-
     mer(2), and uses the ITIMEREAL interval timer.

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:











SunOS 5.11          Last change: 14 Aug 2002                    1






Standard C Library Functions                           ualarm(3C)



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Standard                    
    


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













































SunOS 5.11          Last change: 14 Aug 2002                    2