wire / wire-format / signalfd-siginfo

signalfd siginfo structure

A signalfd file descriptor delivers signals as structured data. Each read(2) returns one or more signalfd_siginfo structures (128 bytes), containing the signal number, sender PID/UID, faulting address, timer ID, etc.

wire-format kind wire-format status standard verification verified tier B wire-format@1

aka: signalfd siginfo structure

wire format

spec: Linux kernel (signalfd)

A signalfd file descriptor delivers signals as structured data. Each read(2) returns one or more signalfd_siginfo structures (128 bytes), containing the signal number, sender PID/UID, faulting address, timer ID, etc.

fieldsizemeaning
ssi_signo4 bytes (__u32)Signal number.
ssi_errno4 bytes (__s32)Error number (for SIGSEGV/SIGBUS/SIGFPE/SIGTRAP).
ssi_code4 bytes (__s32)Signal code (SI_USER, SI_KERNEL, SI_QUEUE, SI_TIMER, SI_MESGQ, SI_ASYNCIO, SI_SIGIO, SI_TKILL, ...).
ssi_pid4 bytes (__u32)Sending process ID.
ssi_uid4 bytes (__u32)Sending user ID.
ssi_fd4 bytes (__s32)File descriptor (for SIGIO/SIGPOLL).
ssi_tid4 bytes (__u32)Kernel timer ID (for SIGEV_THREAD_ID timers).
ssi_band4 bytes (__u32)Band event (for SIGIO/SIGPOLL).
ssi_overrun4 bytes (__u32)Overrun count (for timers).
ssi_trapno4 bytes (__u32)Trap number (for SIGTRAP/SIGSEGV).
ssi_status4 bytes (__s32)Exit status (for SIGCHLD).
ssi_int4 bytes (__s32)Integer sent by sigqueue(3).
ssi_ptr8 bytes (void *)Pointer sent by sigqueue(3).
ssi_utime8 bytes (__u64)User CPU time consumed (SIGCHLD).
ssi_stime8 bytes (__u64)System CPU time consumed (SIGCHLD).
ssi_addr8 bytes (void *)Faulting address (SIGSEGV/SIGBUS/SIGFPE/SIGTRAP/SIGILL).
ssi_addr_lsb2 bytes (__u16)LSB of the faulting address.
ssi_syscall2 bytes (__s16)Syscall number that triggered (seccomp).
ssi_call_addr8 bytes (void *)Address of the syscall instruction (seccomp).
ssi_arch4 bytes (__u32)Architecture (seccomp).
paddingto 128 bytesPadding to 128 bytes.

example:

02 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00

signalfd_siginfo for SIGINT (signal 2) from a user process


provenance

agent: curl -H 'accept: application/json' wire.phall.io/wire-format/signalfd-siginfo or /wire-format/signalfd-siginfo.json