apparmor/parser
John Johansen a3c0753b89 Add Audit control to AppArmor through, the use of audit and deny
key words.  Deny is also used to subtract permissions from the
profiles permission set.

the audit key word can be prepended to any file, network, or capability
rule, to force a selective audit when that rule is matched.  Audit
permissions accumulate just like standard permissions.

  eg.
  audit /bin/foo rw,

  will force an audit message when the file /bin/foo is opened for
  read or write.

  audit /etc/shadow w,
  /etc/shadow r,
  will force an audit message when /etc/shadow is opened for writing.
  The audit message is per permission bit so only opening the file
  for read access will not, force an audit message.

  audit can also be used in block form instead of prepending audit
  to every rule.

  audit {
    /bin/foo rw,
    /etc/shadow w,
  }
  /etc/shadow r,	# don't audit r access to /etc/shadow


the deny key word can be prepended to file, network and capability
rules, to result in a denial of permissions when matching that rule.
The deny rule specifically does 3 things
- it gives AppArmor the ability to remember what has been denied
  so that the tools don't prompt for what has been denied in
  previous profiling sessions.
- it subtracts globally from the allowed permissions.  Deny permissions
  accumulate in the the deny set just as allow permissions accumulate
  then, the deny set is subtracted from the allow set.
- it quiets known rejects.  The default audit behavior of deny rules
  is to quiet known rejects so that audit logs are not flooded
  with already known rejects.  To have known rejects logged prepend
  the audit keyword to the deny rule.  Deny rules do not have a
  block form.

eg.
  deny /foo/bar rw,
  audit deny /etc/shadow w,

  audit {
     deny owner /blah w,
     deny other /foo w,
     deny /etc/shadow w,
  }
2008-03-13 17:39:03 +00:00
..
libapparmor_re Add Audit control to AppArmor through, the use of audit and deny 2008-03-13 17:39:03 +00:00
pcre Add an 'all' target for the pcre subdir. 2007-03-30 16:30:15 +00:00
po Added updated translations. 2007-08-06 12:48:39 +00:00
tst add owner parser tests 2007-12-20 12:58:16 +00:00
apparmor-parser.spec.in merge over change from 1082 - update parser .spec change log 2008-02-19 10:18:12 +00:00
apparmor.d.pod merge over r1088 - Add descriptiion of append, lock and network rules to the man page 2008-02-19 10:19:28 +00:00
apparmor.pod update copyright dates 2007-04-11 08:12:51 +00:00
apparmor.vim.pod update copyright dates 2007-04-11 08:12:51 +00:00
apparmor_parser.pod update copyright dates 2007-04-11 08:12:51 +00:00
COPYING.GPL Import the rest of the core functionality of the internal apparmor 2006-04-11 21:52:54 +00:00
frob_slack_rc Update keywords attribute, svn:ignore attribute, update Makefile to 2006-04-12 03:09:10 +00:00
immunix.h Add the ability to specify link subset test on a link pair, and 2008-03-13 16:49:10 +00:00
Makefile autogenerate the capability names file 2007-11-16 09:32:38 +00:00
parser.h Add Audit control to AppArmor through, the use of audit and deny 2008-03-13 17:39:03 +00:00
parser_include.c Fix a double free bug in include handling 2007-08-15 20:24:58 +00:00
parser_include.h update copyright dates 2007-04-11 08:12:51 +00:00
parser_interface.c Add Audit control to AppArmor through, the use of audit and deny 2008-03-13 17:39:03 +00:00
parser_lex.l Add Audit control to AppArmor through, the use of audit and deny 2008-03-13 17:39:03 +00:00
parser_main.c add basic handling of profile namespaces 2007-11-16 09:18:48 +00:00
parser_merge.c Add Audit control to AppArmor through, the use of audit and deny 2008-03-13 17:39:03 +00:00
parser_misc.c Add Audit control to AppArmor through, the use of audit and deny 2008-03-13 17:39:03 +00:00
parser_policy.c remove old netdomain syntax 2007-11-16 09:34:01 +00:00
parser_regex.c Add Audit control to AppArmor through, the use of audit and deny 2008-03-13 17:39:03 +00:00
parser_symtab.c update copyright dates 2007-04-11 08:12:51 +00:00
parser_variable.c update copyright dates 2007-04-11 08:12:51 +00:00
parser_yacc.y Add Audit control to AppArmor through, the use of audit and deny 2008-03-13 17:39:03 +00:00
rc.aaeventd.redhat Fix return code propogation in the initscripts, and return the 2007-05-24 05:00:34 +00:00
rc.aaeventd.suse Fix return code propogation in the initscripts, and return the 2007-05-24 05:00:34 +00:00
rc.apparmor.debian fix formatting of description field in initscripts 2007-05-28 03:42:26 +00:00
rc.apparmor.functions fix init script so that it doesn't result in a regex with a null alternation ie. |apparmor 2008-01-03 23:21:07 +00:00
rc.apparmor.redhat fix formatting of description field in initscripts 2007-05-28 03:42:26 +00:00
rc.apparmor.slackware Fix return code propogation in the initscripts, and return the 2007-05-24 05:00:34 +00:00
rc.apparmor.suse Only run apparmor initscript at boottime on suse. (novell #286749) 2007-08-31 19:05:54 +00:00
README Kill some bogus readme text 2007-04-25 20:50:21 +00:00
subdomain.conf Update keywords attribute, svn:ignore attribute, update Makefile to 2006-04-12 03:09:10 +00:00
subdomain.conf.pod update copyright dates 2007-04-11 08:12:51 +00:00
techdoc.tex Move the techdoc to the apparmor-parser package. 2007-04-12 06:01:40 +00:00

The apparmor_parser allows you to add, replace, and remove AppArmor
policy through the use of command line options. The default is to add.
`apparmor_parser --help` shows what the command line options are.

You can also find more information at
<http://forge.novell.com/modules/xfmod/project/?apparmor>.

Please send all complaints, bug reports, feature requests, rants about the
software, and questions to apparmor-general@forge.novell.com. Security
issues should be directed to security@suse.de or secure@novell.com,
where we will attempt to conform to the RFP vulnerability disclosure
protocol: http://www.wiretrip.net/rfp/policy.html

The parser uses the PCRE (Perl Compatible Regular Expression) engine,
which was written by Philip Hazel and is copyright by the University
of Cambridge, England. For more information on the PCRE engine, see
<ftp://ftp.csx.cam.ac.uk/pub/software/programming/pcre/>

Thanks.

-- The AppArmor development team