priv_getbyname(9F) Kernel Functions for Drivers priv_getbyname(9F)
NAME
priv_getbyname - map a privilege name to a number
SYNOPSIS
#include <sys/cred.h>
int priv_getbyname(const char *priv, int flags);
INTERFACE LEVEL
Solaris DDI specific (Solaris DDI).
PARAMETERS
priv
name of the privilege
flags
flags, must be zero or PRIV_ALLOC
DESCRIPTION
The priv_getbyname() function maps a privilege name to a privilege number for use with the priv_*() kernel interfaces.
If PRIV_ALLOC is passed as a flag parameter, an attempt is made to allocate a privilege if it is not yet defined. The newly allocated priv-
ilege number is returned.
Privilege names can be specified with an optional priv_ prefix, which is stripped.
Privilege names are case insensitive but allocated privileges preserve case.
Allocated privileges can be at most {PRIVNAME_MAX} characters long and can contain only alphanumeric characters and the underscore charac-
ter.
RETURN VALUES
This function returns the privilege number, which is greater than or equal to 0, if it succeeds. It returns a negative error number if an
error occurs.
ERRORS
EINVAL
This might be caused by any of the following
o The flags parameter is invalid.
o The specified privilege does not exist.
o The priv parameter contains invalid characters.
ENOMEM
There is no room to allocate another privilege.
ENAMETOOLONG
An attempt was made to allocate a privilege that was longer than {PRIVNAME_MAX} characters.
CONTEXT
This functions can be called from user and kernel contexts.
ATTRIBUTES
See attributes(5) for a description of the following attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|Architecture |All |
+-----------------------------+-----------------------------+
|Interface Stability |Evolving |
+-----------------------------+-----------------------------+
SEE ALSO
attributes(5), privileges(5)
Writing Device Drivers
SunOS 5.10 11 Mar 2004 priv_getbyname(9F)
