carta
sigisemptyset(3)

sigisemptyset3

Manipulate signal sets

Part of sigaddset(3).

Usage

int

int

int

int

int

int

int

int

Library

Standard C Library (libc, -lc)

Overview

These functions manipulate signal sets stored in a sigset_t. Either sigemptyset() or sigfillset() must be called for every object of type sigset_t before any other use of the object.

The sigemptyset() function initializes a signal set to be empty.

The sigfillset() function initializes a signal set to contain all signals.

The sigaddset() function adds the specified signal signo to the signal set.

The sigandset() function sets the specified set to the logical AND of all signals from the left and right signal sets.

The sigdelset() function deletes the specified signal signo from the signal set.

The sigisemptyset() function returns whether the specified set is empty or not.

The sigismember() function returns whether a specified signal signo is contained in the signal set.

The sigorset() function sets the specified set to the logical OR of all signals from the left and right signal sets.

Return values

The sigisemptyset() function returns 1 if the set is empty, 0 otherwise.

The sigismember() function returns 1 if the signal is a member of the set, 0 otherwise.

The other functions return 0 upon success. A -1 return value indicates an error occurred and the global variable errno is set to indicate the reason.

Errors

These functions could fail if one of the following occurs:

[EINVAL]

signo has an invalid value.

History

  • FreeBSD 16.0-CURRENT (2026-10-27) to FreeBSD 15.0-RELEASE: the text shown here
  • FreeBSD 14.5-RELEASE to FreeBSD 13.3-RELEASE
  • FreeBSD 13.2-RELEASE to FreeBSD 13.0-RELEASE
  • FreeBSD 12.4-RELEASE
  • FreeBSD 12.3-RELEASE
  • FreeBSD 12.2-RELEASE
  • FreeBSD 11.4-RELEASE

Standards

The sigandset(), sigisemptyset(), and sigorset() functions are FreeBSD extensions, compatible with functions of the same name provided by both musl libc and GNU libc.

The rest of these functions are defined by IEEE Std 1003.1-1988 (“POSIX.1”).

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's mdoc source.