alarm(2)                            CLIX                            alarm(2)



  NAME

    alarm - Sets a process alarm clock

  LIBRARY

    Standard C Library (libc.a)

  SYNOPSIS

    int alarm(
      unsigned int seconds );

  PARAMETERS

    seconds   Specifies the number of real-time seconds to delay before
              sending a SIGALRM signal.

  DESCRIPTION

    The alarm() function causes the system to send the calling process a
    SIGALRM signal after the number of real-time seconds specified by seconds
    have elapsed.

    Alarm requests are not stacked-only one SIGALRM generation can be
    scheduled in this manner.  If the SIGALRM has not yet been generated, the
    call will result in rescheduling the time at which the SIGALRM will be
    generated.

    If seconds is 0, any previously-made alarm() request is canceled.

  EXAMPLES

    1.  To arrange to receive a SIGALRM after 1 second:

        alarm(1);


    2.  To cancel any outstanding alarm request:

        alarm(0);


  RETURN VALUES

    The alarm() function returns the amount of time remaining in seconds
    before the system is scheduled to generate the SIGALRM signal, or 0 if
    there is no previous alarm request.

  ERRORS




  2/94 - Intergraph Corporation                                              1

  alarm(2)                            CLIX                            alarm(2)



    This function never sets errno.

  RELATED INFORMATION

    Functions:  pause(2), signal(2), sigaction(2), sigpause(2), sigset(2)

















































  2                                              Intergraph Corporation - 2/94