'\" t
.\" Copyright (c) 1994,1995 Mike Battersby <mib@deakin.edu.au>
.\" and Copyright 2004, 2005 Michael Kerrisk <mtk.manpages@gmail.com>
.\" based on work by faith@cs.unc.edu
.\"
.\" Permission is granted to make and distribute verbatim copies of this
.\" manual provided the copyright notice and this permission notice are
.\" preserved on all copies.
.\"
.\" Permission is granted to copy and distribute modified versions of this
.\" manual under the conditions for verbatim copying, provided that the
.\" entire resulting derived work is distributed under the terms of a
.\" permission notice identical to this one.
.\"
.\" Since the Linux kernel and libraries are constantly changing, this
.\" manual page may be incorrect or out-of-date.  The author(s) assume no
.\" responsibility for errors or omissions, or for damages resulting from
.\" the use of the information contained herein.  The author(s) may not
.\" have taken the same level of care in the production of this manual,
.\" which is licensed free of charge, as they might when working
.\" professionally.
.\"
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\"
.\" Modified, aeb, 960424
.\" Modified Fri Jan 31 17:31:20 1997 by Eric S. Raymond <esr@thyrsus.com>
.\" Modified Thu Nov 26 02:12:45 1998 by aeb - add SIGCHLD stuff.
.\" Modified Sat May  8 17:40:19 1999 by Matthew Wilcox
.\"	add POSIX.1b signals
.\" Modified Sat Dec 29 01:44:52 2001 by Evan Jones <ejones@uwaterloo.ca>
.\"	SA_ONSTACK
.\" Modified 2004-11-11 by Michael Kerrisk <mtk.manpages@gmail.com>
.\"	Added mention of SIGCONT under SA_NOCLDSTOP
.\"	Added SA_NOCLDWAIT
.\" Modified 2004-11-17 by Michael Kerrisk <mtk.manpages@gmail.com>
.\"	Updated discussion for POSIX.1-2001 and SIGCHLD and sa_flags.
.\"	Formatting fixes
.\" 2004-12-09, mtk, added SI_TKILL + other minor changes
.\" 2005-09-15, mtk, split sigpending(), sigprocmask(), sigsuspend()
.\"	out of this page into separate pages.
.\"
.\" Japanese Version Copyright (c) 1997 HANATAKA Shinya all rights reserved.
.\" Translated 1997-03-03, HANATAKA Shinya <hanataka@abyss.rim.or.jp>
.\" Modified 2000-10-02, HANATAKA Shinya <hanataka@abyss.rim.or.jp>
.\" Modified 2001-10-18, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
.\" Updated 2005-03-15, Akihiro MOTOKI
.\" Updated 2005-10-05, Akihiro MOTOKI
.\" Updated 2007-09-08, Akihiro MOTOKI, LDP v2.64
.\"
.\"WORD:	signal			ʥ
.\"WORD:	process			ץ
.\"WORD:	signal handler		ʥϥɥ
.\"WORD:	pointer			ݥ󥿡
.\"WORD:	mask			ޥ
.\"WORD:	block			ػ(block)
.\"WORD:	suspend			(suspend)
.\"WORD:	stop			(stop)
.\"WORD:	catch			(catch)
.\"WORD:	architecture		ƥ㡼
.\"WORD:	compatible		ߴ
.\"WORD:	pottable		ܿ
.\"
.TH SIGACTION 2 2007-07-08 "Linux" "Linux Programmer's Manual"
.SH ̾
sigaction \- ʥưγǧѹ
.SH 
.nf
.B #include <signal.h>
.sp
.BI "int sigaction(int " signum ", const struct sigaction *" act ,
.BI "              struct sigaction *" oldact );
.fi
.SH 
.BR sigaction ()
ƥॳϡΥʥݤ
ץưѹΤ˻Ѥ롣
.PP
.I signum
ˤϡ
.B SIGKILL

.B SIGSTOP
ʳͭʥʥɤǤǤ롣
.PP
.I act
 NULL ʳǤСʥ
.I signum
οư (action) Ȥ
.I act
ꤵ롣
.I oldact
 NULL ǤʤСޤǤư
.I oldact
˳Ǽ롣
.PP
.I sigaction
¤ΤϰʲΤ褦ʴ롣
.sp
.in +4n
.nf
struct sigaction {
    void     (*sa_handler)(int);
    void     (*sa_sigaction)(int, siginfo_t *, void *);
    sigset_t   sa_mask;
    int        sa_flags;
    void     (*sa_restorer)(void);
};
.fi
.in
.PP
ƥˤäƤ϶ (union) ѤƤꡢξˤ
.I sa_handler

.I sa_sigaction
ξƱ˳Ƥ뤳ȤϤǤʤ
.PP
.I sa_restorer
ǤѻͽǤѤ٤ǤϤʤ
POSIX ˤ
.I sa_restorer
Ǥ˴ؤ뵬Ϥʤ
.PP
.I sa_handler

.I signum
бưꤹΤǡ
ǥեȤưԤ
.BR SIG_DFL 
Υʥ̵뤹
.BR SIG_IGN 
ʥϥɥؿؤΥݥ󥿤Ǥ롣
ʥϥɥؿΰϰĤǤꡢʥֹ椬Ȥ
Ϥ롣
.PP
.I sa_flags

.B SA_SIGINFO
ꤵ줿硢
.RI ( sa_handler
ǤϤʤ)
.I sa_sigaction
ˤ
.I signum
б륷ʥϥɥؿꤵ롣
ꤵؿϡǽΰȤƥʥֹ
ܤΰȤ
.I siginfo_t
ؤΥݥ󥿤򡢻ܤΰȤ (void * ˥㥹Ȥ)
.I ucontext_t
ؤΥݥ󥿤Ȥ롣
.PP
.I sa_mask
ϡʥ롦ϥɥ¹˶ػ (block) 륷ʥΥޥɽ
ˡ
.B SA_NODEFER
ե饰ꤵƤʤϡϥɥư뤭äȤʤ
ʥˤ
.I sa_mask
ŬѤ롣
.PP
.I sa_flags
ϥʥ롦ϥɥưѹ뤿Υե饰νꤹ롣
.I sa_flags
ˤϡʲ˼ե饰 (0 İʾ) ¤ȤäΤꤹ롣
.RS 4
.TP
.B SA_NOCLDSTOP
.I signum

.B SIGCHLD
ξ硢
ҥץߤ
(ҥץ
.BR SIGSTOP ", " SIGTSTP ", " SIGTTIN ", " SIGTTOU
Ȥ) Ƴ (ҥץ
.B SIGCONT
Ȥ) Ȥ
.B SIGCHLD
Τʤ
.TP
.B SA_NOCLDWAIT
(Linux 2.6 ʹ)
.\" Τˤ Linux 2.5.60 ʹ -- MTK
.I signum

.B SIGCHLD
ξ硢ҥץλȤ
ҥץ򥾥ӥץѲʤ
.RB ( waitpid (2)
⻲)
.TP
.B SA_RESETHAND
ʥϥɥ餬ƤФ٤ˡʥưǥեȤ᤹
.B SA_ONESHOT
ϤΥե饰Ʊ̣ѻߤƤꡢɸǤ롣
.TP
.B SA_ONSTACK
.BR sigaltstack (2)
󶡤̤Υʥ롦åǥʥϥɥƤӽФ
̤Υʥ롦åѲǽǤʤСǥեȤΥå
Ѥ롣
.TP
.B SA_RESTART
ĤΥƥॳ򥷥ʥΤǺƳǤ褦ˤơ
BSD ʥ (semantics) ȸߴΤư󶡤롣
.TP
.B SA_NODEFER
켫ȤΥʥ롦ϥɥ顼ˤǤ
Υʥޥʤ褦ˤ롣
.B SA_NOMASK
ϤΥե饰Ʊ̣ѻߤƤꡢɸǤ롣
.TP
.B SA_SIGINFO
ʥϥɥϰĤǤϤʤĤΰġξ
.I sa_handler
Τ
.I sa_sigaction
ꤷʤФʤʤ
.RI ( sa_sigaction
եɤ Linux 2.1.86 ɲä줿)
.RE
.PP
.I sa_sigaction
Υѥ᡼
.I siginfo_t
ϰʲǤŤΤǤ:
.sp
.in +4n
.nf
siginfo_t {
.\" FIXME si_tid and si_overrun are not documented.
.\" FIXME si_trapno is not documented; is it actually used?
    int      si_signo;    /* Signal number */
    int      si_errno;    /* An errno value */
    int      si_code;     /* Signal code */
    pid_t    si_pid;      /* Sending process ID */
    uid_t    si_uid;      /* Real user ID of sending process */
    int      si_status;   /* Exit value or signal */
    clock_t  si_utime;    /* User time consumed */
    clock_t  si_stime;    /* System time consumed */
    sigval_t si_value;    /* Signal value */
    int      si_int;      /* POSIX.1b signal */
    void    *si_ptr;      /* POSIX.1b signal */
    void    *si_addr;     /* Memory location which caused fault */
    int      si_band;     /* Band event */
    int      si_fd;       /* File descriptor */
}
.fi
.in

.IR si_signo ", " si_errno ", " si_code
ƤΥʥФƤ
.RI ( si_errno
 Linux ǤϻѤʤ)
¤ΤλĤʬϡ (union) ˤʤäƤ뤫⤷ʤ
ξϳ륷ʥˤựΤեɤΤߤɤ߹
ȤǤ롣
.IP * 2
POSIX.1b ʥ
.B SIGCHLD

.IR si_pid "  " si_uid
ꤹ롣
.BR
.IP *
.B SIGCHLD
Ϥ
.IR si_status ", " si_utime ", " si_stime
ꤹ롣
.IP *
.IR si_int "  " si_ptr
 POSIX.1b ʥԤˤäƻꤵ롣
ܺ٤
.BR sigqueue (2)
򻲾ȤΤȡ
.IP *
.BR SIGILL ,
.BR SIGFPE ,
.BR SIGSEGV ,
.B SIGBUS

.I si_addr
˥顼ȯɥ쥹ꤹ롣
SIGPOLL 
.IR si_band "  " si_fd
ꤹ롣
.PP
.I si_code
ϡΥʥ뤬줿ͳ򼨤ͤǤ (ӥåȥޥǤϤʤ)
ʲΥꥹȤˡɤΥʥξǤ
.I si_code
ꤦͤ򡢥ʥ뤬줿ͳȤȤ˵ܤ롣
.RS 4
.TP 15
.B SI_USER
.BR kill (2)
ޤ
.BR raise (3)
.TP
.B SI_KERNEL
ͥˤ줿
.TP
.B SI_QUEUE
.BR sigqueue (2)
.TP
.B SI_TIMER
POSIX ޤλ
.TP
.B SI_MESGQ
POSIX å塼ξ֤Ѳ (Linux 2.6.6 ʹ)
.BR mq_notify (3) ȡ
.TP
.B SI_ASYNCIO
Ʊ IO (AIO) λ
.TP
.B SI_SIGIO
塼󥰤줿 SIGIO
.TP
.B SI_TKILL
.BR tkill (2)
ޤ
.BR tgkill (2)
(Linux 2.4.19 ʹ)
.\" SI_DETHREAD is defined in 2.6.9 sources, but isn't implemented
.\" It appears to have been an idea that was tried during 2.5.6
.\" through to 2.5.24 and then was backed out.
.RE
.PP
.B SIGILL
ʥξ硢
.I si_code
ˤϰʲͤǤ:
.RS 4
.TP 15
.B ILL_ILLOPC
̿ᥳ (opcode)
.TP
.B ILL_ILLOPN
ʥڥ
.TP
.B ILL_ILLADR
ʥɥå󥰥⡼
.TP
.B ILL_ILLTRP
ʥȥå
.TP
.B ILL_PRVOPC
øɬפ̿ᥳ (opcode)
.TP
.B ILL_PRVREG
øɬפʥ쥸
.TP
.B ILL_COPROC
ץåΥ顼
.TP
.B ILL_BADSTK
å顼
.RE
.PP
.B SIGFPE
ʥξ硢
.I si_code
ˤϰʲͤǤ:
.RS 4
.TP 15
.B FPE_INTDIV
 0 ˤ
.TP
.B FPE_INTOVF
ΥСե
.TP
.B FPE_FLTDIV
ư 0 ˤ
.TP
.B FPE_FLTOVF
ưΥСե
.TP
.B FPE_FLTUND
ưΥե
.TP
.B FPE_FLTRES
ưΤʱ黻 (inexact result)
.TP
.B FPE_FLTINV
ư
.TP
.B FPE_FLTSUB
ϰϳź (subscript)
.RE
.PP
.B SIGSEGV
ʥξ硢
.I si_code
ˤϰʲͤǤ:
.RS 4
.TP 15
.B SEGV_MAPERR
֥Ȥ˥ޥåԥ󥰤Ƥʤɥ쥹
.TP
.B SEGV_ACCERR
ޥåԥ󥰤줿֥ȤФ륢Ĥʤ
.RE
.PP
.B SIGBUS
ʥξ硢
.I si_code
ˤϰʲͤǤ:
.RS 4
.TP 15
.B BUS_ADRALN
ʥɥ쥹饤 (alignment)
.TP
.B BUS_ADRERR
¸ߤʤʪɥ쥹
.TP
.B BUS_OBJERR
֥ȸͭΥϡɥ顼
.RE
.PP
.B SIGTRAP
ʥξ硢
.I si_code
ˤϰʲͤǤ:
.RS 4
.TP 15
.B TRAP_BRKPT
ץΥ֥졼ݥ
.TP
.B TRAP_TRACE
ץΥȥ졼ȥå
.RE
.PP
.B SIGCHLD
ʥξ硢
.I si_code
ˤϰʲͤǤ:
.RS 4
.TP 15
.B CLD_EXITED
ҥץλ (exited)
.TP
.B CLD_KILLED
ҥץ kill 줿
.TP
.B CLD_DUMPED
ҥץ۾ｪλ
.TP
.B CLD_TRAPPED
ȥ졼оݤλҥץȥåפ夲
.TP
.B CLD_STOPPED
ҥץ (stop) 
.TP
.B CLD_CONTINUED
ߤƤҥץƳ (Linux 2.6.9 ʹ)
.RE
.PP
.B SIGPOLL
ʥξ硢
.I si_code
ˤϰʲͤǤ:
.RS 4
.TP 15
.B POLL_IN
ϥǡѲǽ
.TP
.B POLL_OUT
ϥХåեѲǽ
.TP
.B POLL_MSG
ϥåѲǽ
.TP
.B POLL_ERR
I/O 顼
.TP
.B POLL_PRI
ͥϤѲǽ
.TP
.B POLL_HUP
ǥХ³Ƥʤ
.RE
.SH ֤
.BR sigaction ()
 0 ֤顼ʤ \-1 ֤
.SH 顼
.TP
.B EFAULT
.IR act "  " oldact
ؤƤ꤬ץΥɥ쥹֤ˤʤ
.TP
.B EINVAL
̵ʥʥ뤬ꤵ줿­ (catch) ̵뤷Ǥʤ
ʥǤ
.BR SIGKILL "  " SIGSTOP
Фưѹ褦Ȥˤȯ롣
.SH 
POSIX.1-2001, SVr4.
.\" SVr4 ˤ EINTR ˤĤƤεҤϤʤ
.SH 
.PP
POSIX Ǥϡ
.BR kill (2)

.BR raise (3)
ؿǤʤʥ
.BR SIGFPE ,
.BR SIGILL ,
.B SIGSEGV
̵ (ignore) 硢θư̤Ǥ롣
ˤ껻η̤̤Ȥʤ롣
ƥ㡼ˤäƤϡΤȤ
.B SIGFPE
ʥ뤬롣
(Ʊͤκ \-1 dz
.B SIGFPE
뤫⤷ʤ)
Υʥ̵뤹̵¥롼פ˴٤뤫⤷ʤ
.PP
POSIX.1-1990 Ǥ
.B SIGCHLD

.B SIG_IGN
ꤹ뤳ȤǧƤʤ
POSIX.1-2001 ǤǧƤꡢ
.B SIGCHLD
̵뤹뤳Ȥǥӥץɻߤ뤳ȤǤ
.RB ( wait (2)
򻲾)
ˡBSD  SystemV Ǥ
.B SIGCHLD
̵뤷ݤưۤʤäƤ롣
Τᡢ˰ܿˡǡλҥץӤˤʤʤ
ݾڤˤϡ
.B SIGCHLD
ʥ­
.BR wait (2)
ʤɤ¹Ԥ뤷ʤ
.PP
POSIX.1-1990 λͤǤ
.B SA_NOCLDSTOP
ΤߤƤ롣
POSIX.1-2001 Ǥ
.BR SA_NOCLDWAIT ,
.BR SA_RESETHAND ,
.BR SA_NODEFER ,
.B SA_SIGINFO
ɲä줿
Unix θŤưץꥱǡ
¾
.I sa_flags
ե饰ѤȰܿ롣
.PP
.B SA_SIGINFO
ե饰 Linux 2.2 饵ݡȤ褦ˤʤä
.PP
.B SA_RESETHAND
ե饰 SVr4 Ʊ̾Υե饰ȸߴ롣
.PP
.B SA_NODEFER
ե饰 1.3.9 ʹߤΥͥǤƱ̾ SVr4 Υե饰ȸߴ롣
 Linux ͥμǤϡΥե饰ꤷƤ륷ʥ
ǤʤɤΥʥǤ뤳ȤƤ (ºݤˤ
.I sa_mask
ˤ̵ˤǤ)
.\".PP
.\"SVr4 ȸߴ
.\".BR SA_RESETHAND "  " SA_NODEFER
.\"Ȥ̾ϡ饤֥ΥС 3.0.9 ʹߤ¸ߤ롣
.PP
.BR sigaction ()
ܤΰ NULL ꤷƸƤӽФȡߤΥʥϥɥǧ
ȤǤ롣ޤܤȻܤΰ NULL ˤƸƤӽФȤǡ
ꤵ줿ʥ뤬ߤΥޥǻȤ뤫ɤåǤ롣
.PP
.B SIGKILL

.B SIGSTOP

.RI ( sa_mask
˻ꤷ) ػߤ뤳ȤϤǤʤ
ػߤ褦ȤƤۤä̵뤵롣
.PP
ʥ뽸˴ؤܺ٤
.BR sigsetops (3)
򻲾Ȥ뤳ȡ
.PP
ʥϥɥ⤫˸ƤӽФȤǤ롢
async-signal-safe functions (Ʊ󥰥ǰʴؿ) 
ꥹȤˤĤƤ
.BR signal (7)
򻲾ȡ
.SS 
.B SA_SIGINFO
Ƴϡ
.I "struct sigcontext"
ܤΰȰ
.I sa_handler
Ѥ뤳Ȥǡ
Ĥɲäξꤹ뤳ȤǤ
ܺ٤ˤĤƤϥͥ륽δϢʬ򸫤Ƥۤ
ߤϤλˡѻߤƤ롣
.SH Х
2.6.13 ΥͥǤϡ
.I sa_flags

.B SA_NODEFER
ꤷ硢
ϥɥ餬¹줿ʥ뼫ȤޥʤʤǤʤ
.I sa_mask
˻ꤵ줿ʥޥʤʤ롣
ΥХϡͥ 2.6.14 ǽ줿
.SH 
.BR mprotect (2)
ȡ
.SH Ϣ
.BR kill (1),
.BR kill (2),
.BR killpg (2),
.BR pause (2),
.BR sigaltstack (2),
.BR signal (2),
.BR signalfd (2),
.BR sigpending (2),
.BR sigprocmask (2),
.BR sigqueue (2),
.BR sigsuspend (2),
.BR wait (2),
.BR raise (3),
.BR siginterrupt (3),
.BR sigsetops (3),
.BR sigvec (3),
.BR core (5),
.BR signal (7)