Return to alarm.2 CVS log

Up to [Research Unix] / researchv10dc / man / adm / man2

Annotation of researchv10dc/man/adm/man2/alarm.2, revision 1.1.1.1

1.1       root        1: .TH ALARM 2
                      2: .CT 2 time_man
                      3: .SH NAME
                      4: alarm, nap, pause \(mi schedule timing delays
                      5: .SH SYNOPSIS
                      6: .nf
                      7: .B unsigned alarm(seconds)
                      8: .B unsigned seconds;
                      9: .PP
                     10: .B void nap(ticks)
                     11: .PP
                     12: .B void pause()
                     13: .fi
                     14: .SH DESCRIPTION
                     15: .I Alarm
                     16: causes signal
                     17: .BR SIGALRM ,
                     18: see
                     19: .IR signal (2),
                     20: to be sent to the invoking process
                     21: in the number of seconds given by the argument.
                     22: Unless caught or ignored, the signal terminates the process.
                     23: .PP
                     24: Alarm requests are not stacked;
                     25: successive calls reset the alarm clock.
                     26: If the argument is 0,
                     27: any alarm request is canceled.
                     28: Because the clock has a one second resolution,
                     29: the signal may occur up to one second early;
                     30: because of scheduling delays,
                     31: resumption of execution of when the signal is
                     32: caught may be delayed an arbitrary amount.
                     33: .PP
                     34: The return value is the amount of time
                     35: previously remaining in the alarm clock.
                     36: .PP
                     37: .I Nap
                     38: suspends execution of
                     39: the current process
                     40: for 
                     41: the specified number of clock ticks.
                     42: If
                     43: .I ticks
                     44: is negative,
                     45: it is taken to be zero;
                     46: if it is greater than two seconds,
                     47: it is taken to be two seconds.
                     48: .PP
                     49: .I Pause
                     50: only returns upon termination of a signal handler started during the
                     51: .IR pause .
                     52: It is used to give up control while waiting for
                     53: a signal,
                     54: usually from
                     55: .I kill
                     56: (see
                     57: .IR signal (2)),
                     58: .IR alarm (2),
                     59: or the terminal driver
                     60: .IR ttyld (4).
                     61: .SH "SEE ALSO"
                     62: .IR kill (1), 
                     63: .IR signal (2), 
                     64: .IR setjmp (3), 
                     65: .IR sleep (3)
                     66: .SH BUGS
                     67: If the argument to
                     68: .I alarm
                     69: is greater than 65535,
                     70: it is treated as 65535.
                     71: .br
                     72: If the alarm clock expires
                     73: during a call to
                     74: .IR alarm ,
                     75: the return value will be 0,
                     76: and the signal will be delivered
                     77: immediately after the system call returns.
                     78: If the routine calling
                     79: .I alarm
                     80: saves the return value
                     81: and later restores it,
                     82: it will disable any alarm
                     83: set by the signal handler.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.