Manual Pages for UNIX Operating System command usage for man priv_addset

Standard C Library Functions                      priv_addset(3C)



NAME
     priv_addset,   priv_allocset,   priv_copyset,   priv_delset,
     priv_emptyset,  priv_basicset,  priv_fillset,  priv_freeset,
     priv_intersect,        priv_inverse,        priv_isemptyset,
     priv_isequalset,        priv_isfullset,       priv_ismember,
     priv_issubset, priv_union - privilege set manipulation func-
     tions

SYNOPSIS
     #include 

     int priv_addset(priv_set_t *sp, const char *priv);


     priv_set_t *priv_allocset(void);


     void priv_copyset(const priv_set_t *src, priv_set_t *dst);


     int priv_delset(priv_set_t *sp, const char *priv);


     void priv_emptyset(priv_set_t *sp);


     void priv_basicset(priv_set_t *sp);


     void priv_fillset(priv_set_t *sp);


     void priv_freeset(priv_set_t *sp);


     void priv_intersect(const priv_set_t *src, priv_set_t *dst);


     void priv_inverse(priv_set_t *sp);


     boolean_t priv_isemptyset(const priv_set_t *sp);


     boolean_t priv_isequalset(const priv_set_t *src, const priv_set_t *dst);


     boolean_t priv_isfullset(const priv_set_t *sp);


     boolean_t priv_ismember(const priv_set_t *sp, const char *priv);




SunOS 5.11          Last change: 12 Jan 2010                    1






Standard C Library Functions                      priv_addset(3C)



     boolean_t priv_issubset(const priv_set_t *src, const priv_set_t *dst);


     void priv_union(const priv_set_t *src, priv_set_t *dst);


DESCRIPTION
     The sp, src, and dst arguments point to privilege sets.  The
     priv argument points to a named privilege.


     The priv_addset() function adds the named privilege priv  to
     sp.


     The priv_allocset() function allocates sufficient memory  to
     contain a privilege set. The value of the returned privilege
     set is indeterminate. The function  returns  NULL  and  sets
     errno when it fails to allocate memory.


     The priv_copyset() function copies the set src to dst.


     The priv_delset() function removes the named privilege  priv
     from sp.


     The priv_emptyset() function clears all privileges from sp.


     The priv_basicset() function copies the basic privilege  set
     to sp.


     The priv_fillset() function asserts all  privileges  in  sp,
     including  the  privileges not currently defined in the sys-
     tem.


     The priv_freeset() function frees the storage  allocated  by
     priv_allocset().


     The priv_intersect() function intersects src  with  dst  and
     places the results in dst.


     The priv_inverse() function inverts the privilege set  given
     as argument in place.





SunOS 5.11          Last change: 12 Jan 2010                    2






Standard C Library Functions                      priv_addset(3C)



     The priv_isemptyset() function checks whether  the  argument
     is an empty set.


     The priv_isequalset() function checks whether the  privilege
     set src is equal to dst.


     The priv_isfullset() function checks whether the argument is
     a  full  set. A full set is a set with all bits set, regard-
     less of whether the privilege is currently  defined  in  the
     system.


     The  priv_ismember()  function  checks  whether  the   named
     privilege priv is a member of sp.


     The priv_issubset() function checks whether src is a  subset
     of dst.


     The priv_union() function takes the union of src and dst and
     places the result in dst.

RETURN VALUES
     Upon  successful  completion,  priv_allocset()   returns   a
     pointer  to  an  opaque  data  structure. It returns NULL if
     memory allocation fails  and  sets  errno  to  indicate  the
     error.


     Upon     successful      completion,      priv_isemptyset(),
     priv_isfullset(),  priv_isequalset(),  priv_issubset(),  and
     priv_ismember()  return  B_TRUE.  Otherwise,   they   return
     B_FALSE.


     Upon successful completion, priv_delset() and  priv_addset()
     return  0.  Otherwise, they return -1 and set errno to indi-
     cate the error.

ERRORS
     The priv_allocset() function will fail if:

     ENOMEM    The physical limits of the system are exceeded  by
               the  memory  allocation needed to hold a privilege
               set.


     EAGAIN    There is insufficient  memory  for  allocation  to
               hold  a  privilege  set.  The  application can try



SunOS 5.11          Last change: 12 Jan 2010                    3






Standard C Library Functions                      priv_addset(3C)



               again later.



     The priv_delset() and priv_addset() functions will fail if:

     EINVAL    The privilege argument is not  a  valid  privilege
               name.


ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe                     |
    |_____________________________|_____________________________|


SEE ALSO
     setppriv(2), malloc(3C), priv_str_to_set(3C), attributes(5),
     privileges(5)

NOTES
     The functions that compare sets operate on all bits  of  the
     set,  regardless  of  whether  the  specific  privileges are
     currently defined in the system.






















SunOS 5.11          Last change: 12 Jan 2010                    4