[BACK]Return to signal.7 CVS log [TXT][DIR] Up to [cvs.NetBSD.org] / src / share / man / man7

Annotation of src/share/man/man7/signal.7, Revision 1.11

1.11    ! martin      1: .\"    $NetBSD: signal.7,v 1.10 2006/03/28 19:13:04 wiz Exp $
1.1       jdolecek    2: .\"
                      3: .\" Copyright (c) 1999 The NetBSD Foundation, Inc.
                      4: .\" All rights reserved.
                      5: .\"
                      6: .\" Redistribution and use in source and binary forms, with or without
                      7: .\" modification, are permitted provided that the following conditions
                      8: .\" are met:
                      9: .\" 1. Redistributions of source code must retain the above copyright
                     10: .\"    notice, this list of conditions and the following disclaimer.
                     11: .\" 2. Redistributions in binary form must reproduce the above copyright
                     12: .\"    notice, this list of conditions and the following disclaimer in the
                     13: .\"    documentation and/or other materials provided with the distribution.
                     14: .\"
                     15: .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
                     16: .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
                     17: .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
                     18: .\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
                     19: .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
                     20: .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
                     21: .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
                     22: .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
                     23: .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
                     24: .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
                     25: .\" POSSIBILITY OF SUCH DAMAGE.
                     26: .\"
1.9       yamt       27: .Dd March 28, 2006
1.1       jdolecek   28: .Dt SIGNAL 7
                     29: .Os
                     30: .Sh NAME
                     31: .Nm signal
                     32: .Nd signal facilities
                     33: .Sh DESCRIPTION
                     34: The
                     35: .Aq Pa signal.h
                     36: header file defines the following signals:
                     37: .Pp
1.9       yamt       38: .Bl -column "99" "SIGVTALARM" "terminate process" -compact
                     39: .It Em "Value" Ta Em "Name" Ta Em "Default Action" Ta Em "Description"
                     40: .It 1 Ta Li SIGHUP Ta "terminate process" Ta "terminal line hangup"
                     41: .It 2 Ta Li SIGINT Ta "terminate process" Ta "interrupt program"
                     42: .It 3 Ta Li SIGQUIT Ta "create core image" Ta "quit program"
                     43: .It 4 Ta Li SIGILL Ta "create core image" Ta "illegal instruction"
                     44: .It 5 Ta Li SIGTRAP Ta "create core image" Ta "trace trap"
                     45: .It 6 Ta Li SIGABRT Ta "create core image" Ta Xr abort 3
1.1       jdolecek   46: call (formerly
                     47: .Dv SIGIOT )
1.9       yamt       48: .It 7 Ta Li SIGEMT Ta "create core image" Ta "emulate instruction executed"
                     49: .It 8 Ta Li SIGFPE Ta "create core image" Ta "floating-point exception"
                     50: .It 9 Ta Li SIGKILL Ta "terminate process" Ta "kill program (cannot be caught or ignored)"
                     51: .It 10 Ta Li SIGBUS Ta "create core image" Ta "bus error"
                     52: .It 11 Ta Li SIGSEGV Ta "create core image" Ta "segmentation violation"
                     53: .It 12 Ta Li SIGSYS Ta "create core image" Ta "invalid system call argument"
                     54: .It 13 Ta Li SIGPIPE Ta "terminate process" Ta "write to a pipe with no reader"
                     55: .It 14 Ta Li SIGALRM Ta "terminate process" Ta "real-time timer expired"
                     56: .It 15 Ta Li SIGTERM Ta "terminate process" Ta "software termination signal"
                     57: .It 16 Ta Li SIGURG Ta "discard signal" Ta "urgent condition present on socket"
                     58: .It 17 Ta Li SIGSTOP Ta "stop process" Ta "stop (cannot be caught or ignored)"
                     59: .It 18 Ta Li SIGTSTP Ta "stop process" Ta "stop signal generated from keyboard"
                     60: .It 19 Ta Li SIGCONT Ta "discard signal" Ta "continue after stop"
                     61: .It 20 Ta Li SIGCHLD Ta "discard signal" Ta "child status has changed"
                     62: .It 21 Ta Li SIGTTIN Ta "stop process" Ta "background read attempted from control terminal"
                     63: .It 22 Ta Li SIGTTOU Ta "stop process" Ta "background write attempted to control terminal"
                     64: .It 23 Ta Li SIGIO Ta "discard signal" Ta "I/O is possible on a descriptor (see"
1.1       jdolecek   65: .Xr fcntl 2 )
1.9       yamt       66: .It 24 Ta Li SIGXCPU Ta "terminate process" Ta "CPU time limit exceeded (see"
1.1       jdolecek   67: .Xr setrlimit 2 )
1.9       yamt       68: .It 25 Ta Li SIGXFSZ Ta "terminate process" Ta "file size limit exceeded (see"
1.1       jdolecek   69: .Xr setrlimit 2 )
1.9       yamt       70: .It 26 Ta Li SIGVTALRM Ta "terminate process" Ta "virtual time alarm (see"
1.1       jdolecek   71: .Xr setitimer 2 )
1.9       yamt       72: .It 27 Ta Li SIGPROF Ta "terminate process" Ta "profiling timer alarm (see"
1.1       jdolecek   73: .Xr setitimer 2 )
1.9       yamt       74: .It 28 Ta Li SIGWINCH Ta "discard signal" Ta "window size change"
                     75: .It 29 Ta Li SIGINFO Ta "discard signal" Ta "status request from keyboard"
                     76: .It 30 Ta Li SIGUSR1 Ta "terminate process" Ta "user-defined signal 1"
                     77: .It 31 Ta Li SIGUSR2 Ta "terminate process" Ta "user-defined signal 2"
                     78: .It 32 Ta Li SIGPWR Ta "discard signal" Ta "power failure/restart"
1.1       jdolecek   79: .El
1.6       lha        80: .Pp
1.7       kleink     81: A function that is async-signal-safe is either reentrant or
1.8       jmmv       82: non-interruptible by signals.
                     83: This means that they can be used in
1.6       lha        84: signal handlers
                     85: and in the child of threaded programs after doing
                     86: .Xr fork 2 .
                     87: .Pp
1.8       jmmv       88: The following functions are async-signal-safe.
                     89: Any function not listed
1.6       lha        90: below is unsafe to use in signal handlers.
                     91: .Pp
                     92: .Xr _Exit 2 ,
                     93: .Xr _exit 2 ,
                     94: .Xr abort 3 ,
                     95: .Xr accept 2 ,
                     96: .Xr access 2 ,
1.10      wiz        97: .\" .Xr aio_error
1.6       lha        98: .\" .Xr aio_return
                     99: .\" .Xr aio_suspend
                    100: .Xr alarm 3 ,
                    101: .Xr bind 2 ,
                    102: .Xr cfgetispeed 3 ,
                    103: .Xr cfgetospeed 3 ,
                    104: .Xr cfsetispeed 3 ,
                    105: .Xr cfsetospeed 3 ,
                    106: .Xr chdir 2 ,
                    107: .Xr chmod 2 ,
                    108: .Xr chown 2 ,
                    109: .Xr clock_gettime 2 ,
                    110: .Xr close 2 ,
                    111: .Xr connect 2 ,
                    112: .Xr creat 3 ,
                    113: .Xr dup 2 ,
                    114: .Xr dup2 2 ,
                    115: .Xr execle 3 ,
1.10      wiz       116: .Xr execve 2 ,
1.6       lha       117: .Xr fchmod 2 ,
                    118: .Xr fchown 2 ,
                    119: .Xr fcntl 2 ,
                    120: .Xr fdatasync 2 ,
                    121: .Xr fork 2 ,
                    122: .Xr fpathconf 2 ,
                    123: .Xr fstat 2 ,
                    124: .Xr fsync 2 ,
                    125: .Xr ftruncate 2 ,
                    126: .Xr getegid 2 ,
                    127: .Xr geteuid 2 ,
                    128: .Xr getgid 2 ,
                    129: .Xr getgroups 2 ,
                    130: .Xr getpeername 2 ,
                    131: .Xr getpgrp 2 ,
                    132: .Xr getpid 2 ,
                    133: .Xr getppid 2 ,
                    134: .Xr getsockname 2 ,
                    135: .Xr getsockopt 2 ,
                    136: .Xr getuid 2 ,
                    137: .Xr kill 2 ,
                    138: .Xr link 2 ,
                    139: .Xr listen 2 ,
                    140: .Xr lseek 2 ,
                    141: .Xr lstat 2 ,
                    142: .Xr mkdir 2 ,
                    143: .Xr mkfifo 2 ,
                    144: .Xr open 2 ,
                    145: .Xr pathconf 2 ,
                    146: .Xr pause 3 ,
                    147: .Xr pipe 2 ,
                    148: .Xr poll 2 ,
                    149: .\" .Xr posix_trace_event 2
                    150: .\" .Xr pselect 2
                    151: .Xr raise 3 ,
                    152: .Xr read 2 ,
                    153: .Xr readlink 2 ,
                    154: .Xr recv 2 ,
                    155: .Xr recvfrom 2 ,
                    156: .Xr recvmsg 2 ,
                    157: .Xr rename 2 ,
1.10      wiz       158: .Xr rmdir 2 ,
1.6       lha       159: .Xr select 2 ,
                    160: .Xr sem_post 3 ,
                    161: .Xr send 2 ,
                    162: .Xr sendmsg 2 ,
                    163: .Xr sendto 2 ,
                    164: .Xr setgid 2 ,
                    165: .Xr setpgid 2 ,
                    166: .Xr setsid 2 ,
                    167: .Xr setsockopt 2 ,
                    168: .Xr setuid 2 ,
                    169: .Xr shutdown 2 ,
                    170: .Xr sigaction 2 ,
                    171: .Xr sigaddset 3 ,
                    172: .Xr sigdelset 3 ,
                    173: .Xr sigemptyset 3 ,
                    174: .Xr sigfillset 3 ,
                    175: .Xr sigismember 3 ,
                    176: .Xr sleep 3 ,
                    177: .Xr signal 3 ,
                    178: .Xr sigpause 3 ,
                    179: .Xr sigpending 2 ,
1.10      wiz       180: .Xr sigprocmask 2 ,
                    181: .\" .Xr sigqueue
1.6       lha       182: .Xr sigset 3 ,
                    183: .Xr sigsuspend 2 ,
1.10      wiz       184: .Xr sockatmark 3 ,
1.6       lha       185: .Xr socket 2 ,
                    186: .Xr socketpair 2 ,
                    187: .Xr stat 2 ,
                    188: .Xr symlink 2 ,
                    189: .Xr sysconf 3 ,
                    190: .Xr tcdrain 3 ,
                    191: .Xr tcflow 3 ,
                    192: .Xr tcflush 3 ,
                    193: .Xr tcgetattr 3 ,
                    194: .Xr tcgetpgrp 3 ,
                    195: .Xr tcsendbreak 3 ,
                    196: .Xr tcsetattr 3 ,
                    197: .Xr tcsetpgrp 3 ,
                    198: .Xr time 3 ,
                    199: .Xr timer_getoverrun 2 ,
                    200: .Xr timer_gettime 2 ,
                    201: .Xr timer_settime 2 ,
                    202: .Xr times 3 ,
                    203: .Xr umask 2 ,
                    204: .Xr uname 3 ,
                    205: .Xr unlink 2 ,
                    206: .Xr utime 3 ,
                    207: .Xr wait 2 ,
                    208: .Xr waitpid 2 ,
                    209: .Xr write 2 .
1.1       jdolecek  210: .Sh STANDARDS
1.2       jhawk     211: These signals conform to
1.1       jdolecek  212: .St -p1003.1-90 ,
                    213: with the exception of
                    214: .Dv SIGTRAP ,
                    215: .Dv SIGEMT ,
                    216: .Dv SIGBUS ,
                    217: .Dv SIGSYS ,
                    218: .Dv SIGURG ,
                    219: .Dv SIGIO ,
                    220: .Dv SIGXCPU ,
                    221: .Dv SIGXFSZ ,
                    222: .Dv SIGVTALRM ,
                    223: .Dv SIGPROF ,
                    224: .Dv SIGWINCH ,
                    225: and
                    226: .Dv SIGINFO
                    227: which are Berkeley extensions (available on most
                    228: .Bx Ns \-derived
1.2       jhawk     229: systems), and
1.1       jdolecek  230: .Dv SIGPWR
1.2       jhawk     231: which comes from System V.
                    232: .Sh HISTORY
1.1       jdolecek  233: .Dv SIGPWR
1.2       jhawk     234: was introduced in
                    235: .Nx 1.4 .
1.1       jdolecek  236: .Sh NOTES
1.2       jhawk     237: The current
                    238: .Nx
                    239: kernel never generates the
1.1       jdolecek  240: .Dv SIGPWR
                    241: signal.
                    242: .Sh SEE ALSO
                    243: .Xr kill 1 ,
                    244: .Xr kill 2 ,
                    245: .Xr ptrace 2 ,
                    246: .Xr sigaction 2 ,
                    247: .Xr sigaltstack 2 ,
                    248: .Xr sigprocmask 2 ,
                    249: .Xr sigstack 2 ,
                    250: .Xr sigsuspend 2 ,
1.4       ross      251: .Xr fpgetmask 3 ,
                    252: .Xr fpsetmask 3 ,
1.1       jdolecek  253: .Xr setjmp 3 ,
                    254: .Xr sigblock 3 ,
                    255: .Xr siginterrupt 3 ,
                    256: .Xr signal 3 ,
                    257: .Xr sigpause 3 ,
                    258: .Xr sigsetmask 3 ,
                    259: .Xr sigsetops 3 ,
                    260: .Xr tty 4

CVSweb <webmaster@jp.NetBSD.org>