priv_getbyname(9f) 맨 페이지 - 윈디하나의 솔라나라

개요

섹션
맨 페이지 이름
검색(S)

priv_getbyname(9f)

priv_getbyname(9F)             Kernel Functions             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 num‐
       ber 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
       privilege 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 character.

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 charac‐
                                  ters.



       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(7) for a description of the following attributes:


       tab()  box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) ATTRIBUTE TYPEAT‐
       TRIBUTE VALUE _ ArchitectureAll _ Interface StabilityCommitted


SEE ALSO
       attributes(7), privileges(7)


       Writing Device Drivers in Oracle Solaris 11.4



Oracle Solaris 11.4               11 Mar 2004               priv_getbyname(9F)
맨 페이지 내용의 저작권은 맨 페이지 작성자에게 있습니다.
RSS ATOM XHTML 5 CSS3