freebsd kernel with SKQ
Go to file
Robert Watson e257c20ec1 Introduce support for per-audit pipe preselection independent from the
global audit trail configuration.  This allows applications consuming
audit trails to specify parameters for which audit records are of
interest, including selecting records not required by the global trail.
Allowing application interest specification without changing the global
configuration allows intrusion detection systems to run without
interfering with global auditing or each other (if multiple are
present).  To implement this:

- Kernel audit records now carry a flag to indicate whether they have
  been selected by the global trail or by the audit pipe subsystem,
  set during record commit, so that this information is available
  after BSM conversion when delivering the BSM to the trail and audit
  pipes in the audit worker thread asynchronously.  Preselection by
  either record target will cause the record to be kept.

- Similar changes to preselection when the audit record is created
  when the system call is entering: consult both the global trail and
  pipes.

- au_preselect() now accepts the class in order to avoid repeatedly
  looking up the mask for each preselection test.

- Define a series of ioctls that allow applications to specify whether
  they want to track the global trail, or program their own
  preselection parameters: they may specify their own flags and naflags
  masks, similar to the global masks of the same name, as well as a set
  of per-auid masks.  They also set a per-pipe mode specifying whether
  they track the global trail, or user their own -- the door is left
  open for future additional modes.  A new ioctl is defined to allow a
  user process to flush the current audit pipe queue, which can be used
  after reprogramming pre-selection to make sure that only records of
  interest are received in future reads.

- Audit pipe data structures are extended to hold the additional fields
  necessary to support preselection.  By default, audit pipes track the
  global trail, so "praudit /dev/auditpipe" will track the global audit
  trail even though praudit doesn't program the audit pipe selection
  model.

- Comment about the complexities of potentially adding partial read
  support to audit pipes.

By using a set of ioctls, applications can select which records are of
interest, and toggle the preselection mode.

Obtained from:	TrustedBSD Project
2006-06-05 14:48:17 +00:00
bin Fix the wording about the blocksize (-b) parameter. The existing 2006-05-10 20:32:57 +00:00
contrib Regenerate config.h from OpenBSM 1.0 alpha 6 import. 2006-06-05 11:06:32 +00:00
crypto Introduce a namespace munging hack inspired by NetBSD to avoid polluting 2006-05-13 13:47:45 +00:00
etc Use an option form better matching the manual. 2006-06-05 03:47:14 +00:00
games Layers are for cakes, not for software. 2006-05-28 06:16:15 +00:00
gnu Clean the product of patch(1). 2006-04-10 09:00:19 +00:00
include Add size_t declaration 2006-05-22 05:57:39 +00:00
kerberos5 Bump library majro version for gethostbyaddr(3). 2006-05-21 15:15:21 +00:00
lib Add audit_submit.3 to the set of man pages built and installed with 2006-06-05 12:53:44 +00:00
libexec *thwack*! all the world's not i386. 2006-03-29 12:29:01 +00:00
release Swing URLs to security advisories over to security.FreeBSD.org. 2006-05-31 23:49:51 +00:00
rescue Pass -DCRUNCH down to standard targets in individual makefiles. 2006-04-10 09:32:50 +00:00
sbin Fix "mount -u -o ro". 2006-06-02 17:53:46 +00:00
secure Add a manual dependency on ssh_namespace.h. 2006-05-13 21:38:16 +00:00
share Document more bits. 2006-06-03 23:39:13 +00:00
sys Introduce support for per-audit pipe preselection independent from the 2006-06-05 14:48:17 +00:00
tools Add regression tests for IPsec. 2006-06-04 22:06:17 +00:00
usr.bin Add audit.h to mkioctls inclusion list: audit pipe ioctls need access 2006-06-05 10:06:51 +00:00
usr.sbin - Fix markup 2006-06-04 15:39:19 +00:00
COPYRIGHT Happy new year, a little late 2006-01-15 22:06:10 +00:00
LOCKS Document commit constraints for RELENG_6_*. 2006-01-13 06:51:43 +00:00
MAINTAINERS Remove stale entries. 2006-06-03 01:52:11 +00:00
Makefile Connect the kernel subsystem API documentation generation framework to 2006-05-26 18:10:06 +00:00
Makefile.inc1 Connect the kernel subsystem API documentation generation framework to 2006-05-26 18:10:06 +00:00
ObsoleteFiles.inc Belatedly add usr/share/man/man4.sab.4.gz. The sab(4) driver was 2006-05-20 00:30:06 +00:00
README Add a note explaining what the rescue/ directory is for. 2006-03-01 20:14:55 +00:00
UPDATING Note that an old adjkerntz is not really usable after the recent 2006-05-15 15:47:45 +00:00

This is the top level of the FreeBSD source directory.  This file
was last revised on:
$FreeBSD$

For copyright information, please see the file COPYRIGHT in this
directory (additional copyright information also exists for some
sources in this tree - please see the specific source directories for
more information).

The Makefile in this directory supports a number of targets for
building components (or all) of the FreeBSD source tree, the most
commonly used one being ``world'', which rebuilds and installs
everything in the FreeBSD system from the source tree except the
kernel, the kernel-modules and the contents of /etc.  The
``buildkernel'' and ``installkernel'' targets build and install
the kernel and the modules (see below).  Please see the top of
the Makefile in this directory for more information on the
standard build targets and compile-time flags.

Building a kernel is a somewhat more involved process, documentation
for which can be found at:
   http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/kernelconfig.html
And in the config(8) man page.
Note: If you want to build and install the kernel with the
``buildkernel'' and ``installkernel'' targets, you might need to build
world before.  More information is available in the handbook.

The sample kernel configuration files reside in the sys/<arch>/conf
sub-directory (assuming that you've installed the kernel sources), the
file named GENERIC being the one used to build your initial installation
kernel.  The file NOTES contains entries and documentation for all possible
devices, not just those commonly used.  It is the successor of the ancient
LINT file, but in contrast to LINT, it is not buildable as a kernel but a
pure reference and documentation file.


Source Roadmap:
---------------
bin		System/user commands.

contrib		Packages contributed by 3rd parties.

crypto		Cryptography stuff (see crypto/README).

etc		Template files for /etc.

games		Amusements.

gnu		Various commands and libraries under the GNU Public License.
		Please see gnu/COPYING* for more information.

include		System include files.

kerberos5	Kerberos5 (Heimdal) package.

lib		System libraries.

libexec		System daemons.

release		Release building Makefile & associated tools.

rescue		Build system for statically linked /rescue utilities.

sbin		System commands.

secure		Cryptographic libraries and commands.

share		Shared resources.

sys		Kernel sources.

tools		Utilities for regression testing and miscellaneous tasks.

usr.bin		User commands.

usr.sbin	System administration commands.


For information on synchronizing your source tree with one or more of
the FreeBSD Project's development branches, please see:

  http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/synching.html