SIGPENDING(2)

✨ NAME ✨

omg bestie, you found the sigpending(2) page — yes, the System Calls Manual one. It's all about getting those pending signals. 💖

sigpending — get pending signals, periodt.

📚 LIBRARY 📚

It lives in the Standard C Library (libc, -lc), no cap. 🎀

📜 SYNOPSIS 📜

#include <signal.h>

int
sigpending(sigset_t *set);

💖 DESCRIPTION 💖

Okay so sigpending() is the system call that returns a mask of the signals pending for delivery to the calling thread or the calling process in the location indicated by set. It literally puts that mask where set points. ✨

Why are signals pending? Maybe because they are currently masked, or just transiently before delivery — although that latter case is not normally detectable, so it's giving sneaky. 👀

🔁 RETURN VALUES 🔁

The sigpending() function returns the value 0 if successful. Otherwise, the value -1 is returned and the global variable errno is set to indicate the error. So yeah: 0 = slay, -1 = check errno, bestie. 💅

💀 ERRORS 💀

The sigpending() system call will fail if:

• [EFAULT] — the set argument specified an invalid address.

👀 SEE ALSO 👀

• sigaction(2)
• sigprocmask(2)
• sigsuspend(2)
• sigsetops(3)

🌈 STANDARDS 🌈

The sigpending() system call is expected to conform to ISO/IEC 9945-1:1990 (“POSIX.1”). Iconic behavior, honestly. ⭐

This page is from Debian, dated September 6, 2013 — SIGPENDING(2), and that's the whole vibe. Byeee 💅🫶