PROC_STR2FLTSET(3PROC) Process Control Library Functions PROC_STR2FLTSET(3PROC)

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

SEE ALSO


libproc(3LIB), proc_fltname(3PROC), proc_fltset2str(3PROC),
proc_signame(3PROC), proc_sigset2str(3PROC), proc_str2flt(3PROC),
proc_str2sig(3PROC), proc_str2sys(3PROC), proc_sysname(3PROC),
proc_sysset2str(3PROC), proc(5)

illumos November 27, 2023 illumos