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)