getauclassnam man page on SmartOS

Man page or keyword search:  
man Server   16655 pages
apropos Keyword Search (all sections)
Output format
SmartOS logo
[printable version]

GETAUCLASSENT(3BSM)					   GETAUCLASSENT(3BSM)

NAME
       getauclassent,  getauclassnam, setauclass, endauclass, getauclassnam_r,
       getauclassent_r - get audit_class entry

SYNOPSIS
       cc [ flag... ] file... -lbsm  -lsocket	-lnsl	[ library... ]
       #include <sys/param.h>
       #include <bsm/libbsm.h>

       struct au_class_ent *getauclassnam( const char *name);

       struct au_class_ent *getauclassnam_r( au_class_ent_t *class_int,
	    const char *name);

       struct au_class_ent *getauclassent(void);

       struct au_class_ent *getauclassent_r( au_class_ent_t *class_int);

       void setauclass(void);

       void endauclass(void);

DESCRIPTION
       The  getauclassent()  function  and  getauclassnam()  each  return   an
       audit_class entry.

       The  getauclassnam()  function searches for an audit_class entry with a
       given class name name.

       The getauclassent() function enumerates audit_class entries. Successive
       calls  to  getauclassent() return either successive audit_class entries
       or NULL.

       The setauclass() function ``rewinds'' to the beginning of the  enumera‐
       tion  of	 audit_class  entries.	Calls to getauclassnam() may leave the
       enumeration in an indeterminate state, so setauclass() should be called
       before the first getauclassent().

       The  endauclass() may be called to indicate that audit_class processing
       is complete; the system may then close any open audit_class file, deal‐
       locate storage, and so forth.

       The  getauclassent_r()  and  getauclassnam_r()  functions both return a
       pointer to an audit_class entry as do their  similarly  named  counter‐
       parts.	They  each take an additional argument, a pointer to pre-allo‐
       cated space for an au_class_ent_t, which is returned  if	 the  call  is
       successful.  To	assure	there  is  enough  space  for  the information
       returned, the  applications  programmer	should	be  sure  to  allocate
       AU_CLASS_NAME_MAX  and  AU_CLASS_DESC_MAX  bytes	 for  the  ac_name and
       ac_desc members of the au_class_ent_t data structure.

       The internal representation of an audit_user entry is  an  au_class_ent
       structure defined in  <bsm/libbsm.h> with the following members:

	 char	     *ac_name;
	 au_class_t	ac_class;
	 char	    *ac_desc;

RETURN VALUES
       The getauclassnam() and getauclassnam_r() functions return a pointer to
       a au_class_ent structure if  they  successfully	locate	the  requested
       entry. Otherwise they return NULL.

       The getauclassent() and getauclassent_r() functions return a pointer to
       a au_class_ent structure if they successfully enumerate an entry.  Oth‐
       erwise they return NULL, indicating the end of the enumeration.

FILES
       /etc/security/audit_class
				    file that aps audit class numbers to audit
				    class names

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

       ┌───────────────┬──────────────────────────┐
       │ATTRIBUTE TYPE │     ATTRIBUTE VALUE	  │
       ├───────────────┼──────────────────────────┤
       │MT-Level       │ MT-Safe with exceptions. │
       └───────────────┴──────────────────────────┘

       All of the functions described on  this	man-page  are  MT-Safe	except
       getauclassent()	 and  getauclassnam,  which  are  Unsafe.  The	getau‐
       classent_r() and getauclassnam_r() functions have the same  functional‐
       ity  as	the  Unsafe  functions, but have a slightly different function
       call interface to make them MT-Safe.

SEE ALSO
       bsmconv(1M), audit_class(4), audit_event(4), attributes(5)

NOTES
       All information is contained in a static area, so it must be copied  if
       it is to be saved.

       The  functionality  described  on this manual page is available only if
       the Solaris Auditing has been enabled.  See bsmconv(1M) for more infor‐
       mation.

				 Mar 31, 2005		   GETAUCLASSENT(3BSM)
[top]

List of man pages available for SmartOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net