Manual Pages for UNIX Operating System command usage for man au_user_mask

Security and Auditing Library Functions        au_user_mask(3BSM)



NAME
     au_user_mask - get user's binary preselection mask

SYNOPSIS
     cc [ flag... ] file... -lbsm  -lsocket   -lnsl   [ library... ]
     #include 

     int au_user_mask(char *username, au_mask_t *mask_p);


DESCRIPTION
     The au_user_mask() function  reads  the  default  (per-zone-
     specific)  audit mask from kernel, combines it with the per-
     user audit flags from the user_attr(4) database, and updates
     the  binary  preselection mask pointed to by mask_p with the
     combined value.


     The always-audit-flags and never-audit-flags fields from the
     user_attr  database  represent  binary  audit classes. These
     fields are combined by au_preselect(3BSM) as follows:


     mask = ( user default  preselection  mask  +   always-audit-
     flags) -  never-audit-flags


     The au_user_mask() function fails only if the  user  default
     audit  mask  could not be retrieved.  In case that user_attr
     database  entries  could  not  be  retrieved,  the  function
     returns  with  success.  This allows for flexible configura-
     tions.

RETURN VALUES
     Upon successful completion,  au_user_mask()  returns  0.  It
     fails  and  returns  -1 if the user default audit mask could
     not be retrieved.

FILES
     /etc/user_attr    extended user attributes database


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










SunOS 5.11          Last change: 27 Jul 2010                    1






Security and Auditing Library Functions        au_user_mask(3BSM)



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


SEE ALSO
     login(1),   auditconfig(1M),    getaudit(2),    setaudit(2),
     au_preselect(3BSM), user_attr(4), attributes(5)

NOTES
     The au_user_mask() function should  be  called  by  programs
     like  login(1)  which set a process's preselection mask with
     setaudit(2). getaudit(2) should  be  used  to  obtain  audit
     characteristics for the current process.





































SunOS 5.11          Last change: 27 Jul 2010                    2