隧道仰拱开挖图片:Linux 信号signal处理函数

1. alarm（设置信号传送闹钟）
相关函数: signal，sleep
表头文件: #include
定义函数: unsigned int alarm(unsigned int seconds);
函数说明: alarm()用来设置信号SIGALRM在经过参数seconds指定的秒数后传送给目前的进程。如果参数seconds 为0，则之前设置的闹钟会被取消，并将剩下的时间返回。
返回值 : 返回之前闹钟的剩余秒数，如果之前未设闹钟则返回0。

范例
#include
#include
void handler()
{
printf("hello\n");
}

main()
{
int i;
signal(SIGALRM,handler);
alarm(5);
for(i=1;i<7;i++)
{
   printf("sleep %d ...\n",i);
   sleep(1);
}
}

执行
sleep 1 ...
sleep 2 ...
sleep 3 ...
sleep 4 ...
sleep 5 ...
hello
sleep 6 ...

kill（传送信号给指定的进程）
相关函数: raise，signal

表头文件: #include
                #include

定义函数: int kill(pid_t pid,int sig);

函数说明: kill()可以用来送参数sig指定的信号给参数pid指定的进程。参数pid有几种情况:
pid>0 将信号传给进程识别码为pid 的进程。
pid=0 将信号传给和目前进程相同进程组的所有进程
pid=-1 将信号广播传送给系统内所有的进程
pid<0 将信号传给进程组识别码为pid绝对值的所有进程
参数sig代表的信号编号可参考附录D

返回值 : 执行成功则返回0，如果有错误则返回-1。

错误代码 EINVAL 参数sig 不合法
ESRCH 参数pid 所指定的进程或进程组不存在
EPERM 权限不够无法传送信号给指定进程

范例
#include
#include
#include
#include
main()
{
pid_t pid;
int status;
if(!(pid= fork()))
{
   printf("Hi I am child process!\n");
   sleep(10);
   return;
}
else
{
   printf("send signal to child process (%d) \n",pid);
   sleep(1);
   kill(pid ,SIGABRT);
   wait(&status);
   if(WIFSIGNALED(status))
    printf("chile process receive signal %d\n",WTERMSIG(status));
}
}

执行
sen signal to child process(3170)
Hi I am child process!
child process receive signal 6

　
pause（让进程暂停直到信号出现）
相关函数: kill，signal，sleep
表头文件: #include
定义函数: int pause(void);
函数说明: pause()会令目前的进程暂停（进入睡眠状态），直到被信号(signal)所中断。
返回值 : 只返回-1。
错误代码: EINTR 有信号到达中断了此函数。

　
sigaction（查询或设置信号处理方式）
相关函数: signal，sigprocmask，sigpending，sigsuspend
表头文件: #include
定义函数: int sigaction(int signum,const struct sigaction *act ,struct sigaction *oldact);
函数说明: sigaction()会依参数signum指定的信号编号来设置该信号的处理函数。参数signum可以指定SIGKILL和SIGSTOP以外的所有信号。

如参数结构sigaction定义如下
struct sigaction
{
void (*sa_handler) (int );
sigset_t sa_mask;
int sa_flags;
void (*sa_restorer) (void);
}

sa_handler此参数和signal()的参数handler相同，代表新的信号处理函数，其他意义请参考signal()。
sa_mask 用来设置在处理该信号时暂时将sa_mask 指定的信号搁置。
sa_restorer 此参数没有使用。
sa_flags 用来设置信号处理的其他相关操作，下列的数值可用。
OR 运算（|）组合
A_NOCLDSTOP : 如果参数signum为SIGCHLD，则当子进程暂停时并不会通知父进程
SA_ONESHOT/SA_RESETHAND:当调用新的信号处理函数前，将此信号处理方式改为系统预设的方式。
SA_RESTART:被信号中断的系统调用会自行重启
SA_NOMASK/SA_NODEFER:在处理此信号未结束前不理会此信号的再次到来。
如果参数oldact不是NULL指针，则原来的信号处理方式会由此结构sigaction 返回。

返回值 : 执行成功则返回0，如果有错误则返回-1。

错误代码: EINVAL 参数signum 不合法，或是企图拦截SIGKILL/SIGSTOPSIGKILL信号
EFAULT 参数act，oldact指针地址无法存取。
EINTR 此调用被中断

范例
#include
#include
void show_handler(struct sigaction * act)
{
switch (act->sa_flags)
{
case SIG_DFL:
   printf("Default action\n");break;
case SIG_IGN:
   printf("Ignore the signal\n");break;
default:
   printf("0x%x\n",act->sa_handler);
}
}
main()
{
int i;
struct sigaction act,oldact;
act.sa_handler = show_handler;
act.sa_flags = SA_ONESHOT|SA_NOMASK;
sigaction(SIGUSR1,&act,&oldact);
for(i=5;i<15;i++)
{
   printf("sa_handler of signal %2d =".i);
   sigaction(i,NULL,&oldact);
}
}

执行
sa_handler of signal 5 = Default action
sa_handler of signal 6= Default action
sa_handler of signal 7 = Default action
sa_handler of signal 8 = Default action
sa_handler of signal 9 = Default action
sa_handler of signal 10 = 0x8048400
sa_handler of signal 11 = Default action
sa_handler of signal 12 = Default action
sa_handler of signal 13 = Default action
sa_handler of signal 14 = Default action

sigaddset（增加一个信号至信号集）
相关函数: sigemptyset，sigfillset，sigdelset，sigismember
表头文件: #include
定义函数: int sigaddset(sigset_t *set,int signum);
函数说明: sigaddset()用来将参数signum 代表的信号加入至参数set 信号集里。
返回值 : 执行成功则返回0，如果有错误则返回-1。
错误代码: EFAULT 参数set指针地址无法存取
EINVAL 参数signum非合法的信号编号

sigdelset（从信号集里删除一个信号）
相关函数: sigemptyset，sigfillset，sigaddset，sigismember
表头文件: #include
定义函数: int sigdelset(sigset_t * set,int signum);
函数说明: sigdelset()用来将参数signum代表的信号从参数set信号集里删除。
返回值 : 执行成功则返回0，如果有错误则返回-1。
错误代码: EFAULT 参数set指针地址无法存取
EINVAL 参数signum非合法的信号编号

sigemptyset（初始化信号集）
相关函数: sigaddset，sigfillset，sigdelset，sigismember
表头文件: #include
定义函数: int sigemptyset(sigset_t *set);
函数说明: sigemptyset()用来将参数set信号集初始化并清空。
返回值 : 执行成功则返回0，如果有错误则返回-1。
错误代码: EFAULT 参数set指针地址无法存取

sigfillset（将所有信号加入至信号集）
相关函数: sigempty，sigaddset，sigdelset，sigismember
表头文件: #include
定义函数: int sigfillset(sigset_t * set);
函数说明: sigfillset()用来将参数set信号集初始化，然后把所有的信号加入到此信号集里。
返回值 : 执行成功则返回0，如果有错误则返回-1。
附加说明: EFAULT 参数set指针地址无法存取

sigismember（测试某个信号是否已加入至信号集里）
相关函数: sigemptyset，sigfillset，sigaddset，sigdelset
表头文件: #include
定义函数: int sigismember(const sigset_t *set,int signum);
函数说明: sigismember()用来测试参数signum 代表的信号是否已加入至参数set信号集里。如果信号集里已有该信号则返回1，否则返回0。
返回值 : 信号集已有该信号则返回1，没有则返回0。如果有错误则返回-1。
错误代码: EFAULT 参数set指针地址无法存取
EINVAL 参数signum 非合法的信号编号

　
signal（设置信号处理方式）
相关函数: sigaction，kill，raise
表头文件: #include
定义函数: void (*signal(int signum,void(* handler)(int)))(int);
函数说明: signal()会依参数signum 指定的信号编号来设置该信号的处理函数。当指定的信号到达时就会跳转到参数handler指定的函数执行。如果参数handler不是函数指针，则必须是下列两个常数之一:
SIG_IGN 忽略参数signum指定的信号。
SIG_DFL 将参数signum 指定的信号重设为核心预设的信号处理方式。
关于信号的编号和说明，请参考附录D
返回值 : 返回先前的信号处理函数指针，如果有错误则返回SIG_ERR(-1)。
附加说明在信号发生跳转到自定的handler处理函数执行后，系统会自动将此处理函数换回原来系统预设的处理方式，如果要改变此操作请改用sigaction()。

范例 参考alarm()或raise()。

sigpending（查询被搁置的信号）
相关函数 signal，sigaction，sigprocmask，sigsuspend

表头文件: #include
定义函数: int sigpending(sigset_t *set);
函数说明: sigpending()会将被搁置的信号集合由参数set指针返回。
返回值执: 行成功则返回0，如果有错误则返回-1。
错误代码: EFAULT 参数set指针地址无法存取
EINTR 此调用被中断。

sigprocmask（查询或设置信号遮罩）
相关函数: signal，sigaction，sigpending，sigsuspend
表头文件: #include
定义函数: int sigprocmask(int how,const sigset_t *set,sigset_t * oldset);
函数说明: sigprocmask()可以用来改变目前的信号遮罩，其操作依参数how来决定
SIG_BLOCK 新的信号遮罩由目前的信号遮罩和参数set 指定的信号遮罩作联集
SIG_UNBLOCK 将目前的信号遮罩删除掉参数set指定的信号遮罩
SIG_SETMASK 将目前的信号遮罩设成参数set指定的信号遮罩。
如果参数oldset不是NULL指针，那么目前的信号遮罩会由此指针返回。
返回值 : 执行成功则返回0，如果有错误则返回-1。
错误代码: EFAULT 参数set，oldset指针地址无法存取。
EINTR 此调用被中断

　
sleep（让进程暂停执行一段时间）
相关函数: signal，alarm
表头文件: #include
定义函数: unsigned int sleep(unsigned int seconds);
函数说明: sleep()会令目前的进程暂停，直到达到参数seconds 所指定的时间，或是被信号所中断。
返回值 : 若进程暂停到参数seconds 所指定的时间则返回0，若有信号中断则返回剩余秒数。