priv_getbynum(3)priv_getbynum(3)NAMEpriv_getbynum() - convert privilege ID to privilege name
SYNOPSIS
Parameters
priv_id The internal (numeric) representation of a privilege
to be converted to the external (string) representa‐
tion.
DESCRIPTION
converts the internal privilege representation of the privilege ID to
the external string representation.
RETURN VALUE
returns the following values:
pointer Successful completion. A non-null pointer to the
privilege name is returned. The returned string is a
pointer to shared data, and must not be modified or
freed.
NULL pointer
Function failed. is set to indicate the error.
ERRORS
If fails, is set to one of the following values:
Invalid privilege ID.
EXAMPLES
#include <stdio.h>
#include <sys/privileges.h>
#include <sys/types.h>
main()
{
priv_t priv_id=PRIV_SYSNFS;
const char *priv_name;
priv_name = priv_getbynum(priv_id);
if (priv_name == NULL) {
printf("Error getting privilege name\n");
} else {
/* priv_name is constant static data
may not be modified or freed */
printf("Privilege Name : %s\n",priv_name);
}
}
SEE ALSOpriv_getbyname(3), priv_set_to_str(3), priv_str_to_set(3), privi‐
leges(5).
priv_getbynum(3)