HP-UX Reference (11i v2 07/12) - 3 Library Functions N-Z (vol 7)

priv_getbyname(3) priv_getbyname(3)

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

If priv_getbyname()

fails, errno is set to one of the following values:

[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);

}