priv_getbynum(3) Library Functions Manual priv_getbynum(3)
NAME
priv_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) representation.
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
");
} else {
/* priv_name is constant static data
may not be modified or freed */
printf("Privilege Name : %s
",priv_name);
}
}
SEE ALSO
priv_getbyname(3), priv_set_to_str(3), priv_str_to_set(3), privileges(5).
priv_getbynum(3)
