NAME

rt_sigqueueinfo, rt_tgsigqueueinfo - 시그널과 데이터를 큐에 넣기

SYNOPSIS

int rt_sigqueueinfo(pid_t tgid, int sig, siginfo_t *info);
int rt_tgsigqueueinfo(pid_t tgid, pid_t tid, int sig, siginfo_t *info);

주의: 이 시스템 호출들에 대한 glibc 래퍼가 없다. NOTES 참고.

DESCRIPTION

rt_sigqueueinfo() 및 rt_tgsigqueueinfo() 시스템 호출은 프로세스나 스레드에게 시그널에 데이터를 더해 보내는 데 사용하는 저수준 인터페이스이다. 수신자에서 sigaction(2) SA_SIGINFO 플래그로 시그널 핸들러를 설정하여 동반 데이터를 얻을 수 있다.

이 시스템 호출들은 응용에서 직접 사용하기 위한 것이 아니라 sigqueue(3)와 pthread_sigqueue(3)를 구현할 수 있도록 제공하는 것이다.

rt_sigqueueinfo() 시스템 호출은 ID가 tgid인 스레드 그룹에게 시그널 sig를 보낸다. ("스레드 그룹"이라는 용어는 "프로세스"와 동의어이며 tid는 전통적인 유닉스 프로세스 ID에 해당한다.) 그 스레드 그룹의 임의 구성원에게 (즉 현재 그 시그널을 막고 있지 않은 스레드들 중 하나에게) 시그널이 전달된다.

info 인자는 시그널에 동반되는 데이터를 나타낸다. 이 인자는 sigaction(2)에 기술된 (그리고 <sigaction.h>를 포함시켜서 정의하는) siginfo_t 타입 구조체의 포인터이다. 호출자가 이 구조체의 다음 필드들을 설정해야 한다.

si_code

리눅스 커널 소스 파일 include/asm-generic/siginfo.h에 있는 SI_* 코드들 중 하나여야 한다. 호출자 자신이 아닌 프로세스로 시그널을 보내려는 경우 다음 제약이 적용된다.

  • 코드가 0보다 크거나 같은 값일 수 없다. 특히 커널에서 kill(2)로 보낸 시그널을 나타내는 데 쓰는 SI_USER일 수 없고, 커널이 생성한 시그널을 나타내는 데 쓰는 SI_KERNEL일 수 없다.

  • (리눅스 2.6.39부터) 코드가 커널에서 tgkill(2)로 보낸 시그널을 나타내는 데 쓰는 SI_TKILL일 수 없다.

si_pid
프로세스 ID로 설정해야 하는데, 보통은 송신자의 프로세스 ID이다.
si_uid
사용자 ID로 설정해야 하는데, 보통은 송신자의 실제 사용자 ID이다.
si_value
이 필드는 시그널에 동반시킬 사용자 데이터를 담는다. 더 자세한 정보는 sigqueue(3)의 마지막(union sigval) 인자 설명을 보라.

커널에서 내부적으로 si_signo 필드를 sig에 지정된 값으로 설정해서 시그널 수신자가 그 필드를 통해서도 시그널 번호를 얻을 수 있도록 한다.

rt_tgsigqueueinfo() 시스템 호출은 rt_sigqueueinfo()와 비슷하되 스레드 그룹 ID tgid와 스레드 그룹 내 스레드 tid의 조합으로 지정한 한 스레드에게 시그널과 데이터를 보낸다.

RETURN VALUE

성공 시 이 시스템 호출들은 0을 반환한다. 오류 시 -1을 반환하며 그 오류를 나타내도록 errno를 설정한다.

ERRORS

EAGAIN
큐에 넣을 수 있는 시그널 개수 한계에 도달했다. (자세한 내용은 signal(7)을 보라.)
EINVAL
sig나 tgid, tid가 유효하지 않다.
EPERM
호출자가 대상에게 시그널을 보낼 권한을 가지고 있지 않다. 필요한 권한에 대해선 kill(2)을 보라.
EPERM
tgid가 호출자 아닌 프로세스를 나타내며 info->si_code가 유효하지 않다.
ESRCH

rt_sigqueueinfo(): tgid에 일치하는 스레드 그룹을 찾을 수 없다.

rt_tgsigqueueinfo(): tgid와 tid에 일치하는 스레드를 찾을 수 없다.

VERSIONS

리눅스 버전 2.2에서 rt_sigqueueinfo() 시스템 호출이 추가되었다. 리눅스 버전 2.6.31에서 rt_tgsigqueueinfo() 시스템 호출이 추가되었다.

CONFORMING TO

이 시스템 호출들은 리눅스 전용이다.

NOTES

이 시스템 호출들은 응용에서 쓰기 위한 것이 아니므로 glibc 래퍼 함수가 없다. 그럴 일은 없겠지만 혹시라도 직접 호출하고 싶은 경우에는 syscall(2)을 이용하면 된다.

kill(2)에서처럼 널 시그널(0)을 사용해서 지정한 프로세스 내지 스레드가 존재하는지 확인할 수 있다.

SEE ALSO

kill(2), pidfd_send_signal(2), sigaction(2), sigprocmask(2), tgkill(2), pthread_sigqueue(3), sigqueue(3), signal(7)

2021-03-22