[DOC] Fix signal list

- Signal names can be symbols, as stated above.
- Supported signals and those values are platform dependent.
- Key sequences to send signal are configurable.
- Fix description of signal 0.

Co-authored-by: Peter Zhu <peter@peterzhu.ca>
This commit is contained in:
Nobuyoshi Nakada 2023-09-05 20:36:45 +09:00 committed by GitHub
parent 5b146eb5a1
commit 7c8932365f
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
Notes: git 2023-09-05 11:37:10 +00:00
Merged: https://github.com/ruby/ruby/pull/8367

Merged-By: nobu <nobu@ruby-lang.org>

View File

@ -8682,40 +8682,44 @@ get_PROCESS_ID(ID _x, VALUE *_y)
* with prefixed <tt>'-'</tt>, * with prefixed <tt>'-'</tt>,
* each process group with group ID +id+ is signalled. * each process group with group ID +id+ is signalled.
* *
* The signal non-negative integers and strings are: * The actual signal values are platform dependent, an example of
* signal names which are supported on many platforms are:
* *
* - +0+ (<tt>'SIGEXIT'</tt>): Exit the current process. * - +SIGHUP+: Hang up controlling terminal or process.
* - +1+ (<tt>'SIGHUP'</tt>): Hang up controlling terminal or process. * - +SIGINT+: \Interrupt from keyboard, Ctrl-C by default in general.
* - +2+ (<tt>'SIGINT'</tt>): \Interrupt from keyboard, Ctrl-C. * - +SIGQUIT+: Quit from keyboard, Ctrl-\ by default in general.
* - +3+ (<tt>'SIGQUIT'</tt>): Quit from keyboard, Ctrl-\. * - +SIGILL+: Illegal instruction.
* - +4+ (<tt>'SIGILL'</tt>): Illegal instruction. * - +SIGTRAP+: Breakpoint for debugging.
* - +5+ (<tt>'SIGTRAP'</tt>): Breakpoint for debugging. * - +SIGIOT+: Abnormal termination.
* - +6+ (<tt>'SIGIOT'</tt>): Abnormal termination. * - +SIGBUS+: Bus error.
* - +7+ (<tt>'SIGBUS'</tt>): Bus error. * - +SIGFPE+: Floating-point exception.
* - +8+ (<tt>'SIGFPE'</tt>): Floating-point exception. * - +SIGKILL+: Forced-process termination.
* - +9+ (<tt>'SIGKILL'</tt>): Forced-process termination. * - +SIGUSR1+: Available to processes.
* - +10+ (<tt>'SIGUSR1'</tt>): Available to processes. * - +SIGSEGV+: Invalid memory reference.
* - +11+ (<tt>'SIGSEGV'</tt>): Invalid memory reference. * - +SIGUSR2+: Available to processes.
* - +12+ (<tt>'SIGUSR2'</tt>): Available to processes. * - +SIGPIPE+: Write to pipe with no readers.
* - +13+ (<tt>'SIGPIPE'</tt>): Write to pipe with no readers. * - +SIGALRM+: Real-timer clock.
* - +14+ (<tt>'SIGALRM'</tt>): Real-timer clock. * - +SIGTERM+: \Process termination.
* - +15+ (<tt>'SIGTERM'</tt>): \Process termination. * - +SIGCHLD+: Child process stopped or terminated or got a signal if traced.
* - +17+ (<tt>'SIGCHLD'</tt>): Child process stopped or terminated * - +SIGCONT+: Resume execution, if stopped.
or got a signal if traced. * - +SIGSTOP+: Stop process execution, Ctrl-Z by default in general.
* - +18+ (<tt>'SIGCONT'</tt>): Resume execution, if stopped. * - +SIGTSTP+: Stop process issued from tty.
* - +19+ (<tt>'SIGSTOP'</tt>): Stop process execution, Ctrl-Z. * - +SIGTTIN+: Background process requires input.
* - +20+ (<tt>'SIGTSTP'</tt>): Stop process issued from tty. * - +SIGTTOU+: Background process requires output.
* - +21+ (<tt>'SIGTTIN'</tt>): Background process requires input. * - +SIGURG+: Urgent condition on socket.
* - +22+ (<tt>'SIGTTOU'</tt>): Background process requires output. * - +SIGXCPU+: CPU time limit exceeded.
* - +23+ (<tt>'SIGURG'</tt>): Urgent condition on socket. * - +SIGXFSZ+: File size limit exceeded.
* - +24+ (<tt>'SIGXCPU'</tt>): CPU time limit exceeded. * - +SIGVTALRM+: Virtual timer clock.
* - +25+ (<tt>'SIGXFSZ'</tt>): File size limit exceeded. * - +SIGPROF+: Profile timer clock.
* - +26+ (<tt>'SIGVTALRM'</tt>): Virtual timer clock. * - +SIGWINCH+: Window resizing.
* - +27+ (<tt>'SIGPROF'</tt>): Profile timer clock. * - +SIGPOLL+: I/O now possible.
* - +28+ (<tt>'SIGWINCH'</tt>): Window resizing. * - +SIGPWR+: Power supply failure.
* - +29+ (<tt>'SIGPOLL'</tt>): I/O now possible. * - +SIGSYS+, +SIGUNUSED+: Bad system call.
* - +30+ (<tt>'SIGPWR'</tt>): Power supply failure. *
* - +31+ (<tt>'SIGSYS'</tt>, <tt>'SIGUNUSED'</tt>): Bad system call. * Use `Signal.list` to see which signals are supported, and the
* actual values.
*
* Additionally, signal +0+ is useful to determine if the process exists.
* *
* Example: * Example:
* *