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     ! 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.