FreeBSD 6.2 manual page repository

FreeBSD is a free computer operating system based on BSD UNIX originally. Many IT companies, like DeployIS is using it to provide an up-to-date, stable operating system.

audit - Commit a BSM audit record to the audit log



      audit - Commit a BSM audit record to the audit log


      #include <bsm/audit.h>
      audit(const char *record, u_int length);


      audit() submits a completed BSM audit record to the system audit log.
      record is a pointer to the the specific event to be recorded and length
      is the size in bytes of the data to be written.
      Upon successful completion, the value 0 is returned; otherwise the
      value -1 is returned and the global variable errno is set to indicate the


      The audit() system call will fail and the data never written if:
      [EFAULT]           The record argument is beyond the allocated address
                         space of the process.
      [EINVAL]           The token ID is invalid or length is larger than
      [EPERM]            The process does not have sufficient permission to
                         complete the operation.
      auditon(2), getauid(2), setauid(2), getaudit(2), setaudit(2),
      getaudit_addr(2), setaudit_addr(2), libbsm(3)


      This software was created by McAfee Research, the security research divi‐
      sion of McAfee, Inc., under contract to Apple Computer Inc.  Additional
      authors include Wayne Salamon, Robert Watson, and SPARTA Inc.
      The Basic Security Module (BSM) interface to audit records and audit
      event stream format were defined by Sun Microsystems.
      This manual page was written by Tom Rhodes 〈〉.


      The OpenBSM implementation was created by McAfee Research, the security
      division of McAfee Inc., under contract to Apple Computer Inc. in 2004.
      It was subsequently adopted by the TrustedBSD Project as the foundation
      for the OpenBSM distribution.


      The FreeBSD kernel does not fully validate that the argument passed is
      syntactically valid BSM.  Submitting invalid audit records may corrupt
      the audit log.


Based on BSD UNIX
FreeBSD is an advanced operating system for x86 compatible (including Pentium and Athlon), amd64 compatible (including Opteron, Athlon64, and EM64T), UltraSPARC, IA-64, PC-98 and ARM architectures. It is derived from BSD, the version of UNIX developed at the University of California, Berkeley. It is developed and maintained by a large team of individuals. Additional platforms are in various stages of development.