priv_str_to_set(3)priv_str_to_set(3)NAMEpriv_str_to_set(), priv_set_to_str() - privilege name to set conversion
function
SYNOPSIS
Parameters
priv_list The list of privilege names, passed as a string,
separated by one or more characters from delim‐
iter. It may also contain the compound privi‐
leges (basic, basicroot, and policy).
delimiter Separates the privileges in priv_list.
index_ptr If an error occurs while parsing the list of
privilege names, the pointer pointed to by
index_ptr is set to point to the remainder of the
string after the error occurred, so long as
index_ptr is not a NULL pointer.
delimiter Separates the individual privilege names by any
of the specified characters. If delimiter is a
NULL character, the default delimiter of comma is
used.
flag Bit mask with the following bit positions
defined: Exactly one of the two flags must be
passed. When flag is the resulting string uses
the compound privileges and to arrive at a short
representation.
priv_vec Specifies privilege set.
DESCRIPTION
priv_str_to_set Conversion
converts a list of privilege names to a privilege set.
priv_list is a string consisting of privilege names and/or compound
privileges. The individual elements in the string are separated by one
or more characters of delimiter .
Any privilege in the list priv_list can be optionally preceded by an
exclamation mark to be interpreted as removal. For example, means all
privileges in the compound privilege except the privilege.
The string is case-insensitive. prefix is optional to a privilege
name. For example, and all have the same meaning.
priv_list is interpreted left to right, so the string is the same as an
empty list of privileges, while is the same as
For a list of valid privileges (both individual privileges and compound
privileges), see privileges(5).
priv_set_to_str Conversion
converts a privilege set to a string of privilege names separated by
the character specified by delimiter .
RETURN VALUE
and return the following values:
pointer Successful completions. Returns a non-null pointer.
The caller of is responsible for freeing the result
using the The caller of is responsible for freeing the
result using the
NULL pointer
Function failed. Returns a null pointer and sets to
indicate the error .
ERRORS
If any of the following conditions occur, the functions fail and set
Cannot allocate enough memory for the given data.
One or more arguments are invalid.
EXAMPLES
#include <stdio.h>
#include <sys/types.h>
#include <sys/privileges.h>
#define priv_list "PRIV_CHOWN,PRIV_CHROOT,PRIV_DACREAD"
main()
{
char *index;
priv_set_t * priv_vector;
if ( (priv_vector = priv_str_to_set( priv_list,
NULL,
&index)) == NULL )
{
perror("priv_str_to_set Failed");
if (index)
printf("Invalid privilege name starting at %s\n", index);
exit(1);
}
printf("The privileges in the given privilege vector are %s\n",
priv_set_to_str( priv_vector, NULL, PRIV_STR_SHORT) );
}
DEPENDENCIES
and are both part of the library.
SEE ALSOprivset_free(3), privileges(5).
priv_str_to_set(3)