Tribblix: manual page: proc

PROC_STR2FLTSET(3PROC) Process Control Library Functions

NAME

proc_str2fltset, proc_str2sigset, proc_str2sysset - convert a string to
a fault, signal, or system call set

LIBRARY

Process Control Library (libproc, -lproc)

SYNOPSIS

#include <libproc.h>

char *
proc_str2fltset(const char *str, const char *delim, int members,
fltset_t *set);

char *
proc_str2sigset(const char *str, const char *delim, int members,
sigset_t *set);

char *
proc_str2sysset(const char *str, const char *delim, int members,
sysset_t *set);

DESCRIPTION

The proc_str2fltset(), proc_str2sigset(), and proc_str2sysset()
functions translate a character string, str, into the corresponding
fault set, signal set, and system call set respectively.

The character string delim will be used as a delimiter between
subsequent entries in the string set. The value of members determines
whether the entries in str enable or disable entries in set. If
members is zero, then set is filled in entirely and then each entry in
str causes the corresponding entry to be disabled in set. If members is
non-zero, then set is empty initially and for each entry in str the
corresponding entry in set will be enabled.

If an unknown entry is encountered in str then the conversion will fail
and a pointer to the first unknown character will be returned.

RETURN VALUES

Upon successful completion, NULL is returned and set is filled in.
Otherwise, a pointer to the first unknown character is returned and
errno is set to indicate the error.

ERRORS

The proc_str2fltset(), proc_str2sigset(), and proc_str2sigset()
functions will fail if:

EINVAL str contains an unrecognized set name.

INTERFACE STABILITY

Uncommitted

MT-LEVEL
MT-Safe