NAME
priv_getbyname() — convert privilege name to privilege ID
SYNOPSIS
#include <sys/privileges.h>
#include <sys/types.h>
priv_t priv_getbyname(const char *priv_name);
Parameters
- priv_name
char
pointer to the string containing the privilege name.
DESCRIPTION
priv_getbyname()
converts the external (string) representation of the privilege name to
the internal (numeric) privilege representation.
RETURN VALUE
priv_getbyname()
returns the following values:
- >=0
Successful completion.
The value of the privilege ID is returned.
- -1
Function failed.
errno
is set to indicate the error.
ERRORS
priv_getbyname()
sets
errno
to the following value if the corresponding condition occurs.
- EINVAL
Invalid privilege name.
EXAMPLES
#include <sys/privileges.h>
#include <sys/types.h>
main()
{
priv_t privid;
char *privname = "SYSNFS";
privid = priv_getbyname(privname);
if (privid == -1) {
printf("\nError getting privilege ID\n");
} else {
printf("\nPrivilege ID : %d\n",privid);
}
}