aa-notify(8) [debian man page]

AA-NOTIFY(8)							     AppArmor							      AA-NOTIFY(8)

NAME

       aa-notify - display information about logged AppArmor messages.

SYNOPSIS

       aa-notify [option]

DESCRIPTION

       aa-notify will display a summary or provide desktop notifications for AppArmor DENIED messages.

OPTIONS

       aa-notify accepts the following arguments:

       -p, --poll
	   poll AppArmor logs and display desktop notifications. Can be used with '-s' option to display a summary on startup.

       -f FILE, --file=FILE
	   search FILE for AppArmor messages

       -l, --since-last
	   show summary since last login.

       -s NUM, --since-days=NUM
	   show summary for last NUM of days.

       -u USER, --user=USER
	   user to drop privileges to when running privileged. When used with the -p option, this should be set to the user that will receive
	   desktop notifications.  This has no effect when running under sudo.

       -w NUM, --wait=NUM
	   wait NUM seconds before displaying notifications (for use with -p)

       -v, --verbose
	   show messages with summaries.

       -h, --help
	   displays a short usage statement.

CONFIGURATION

       System-wide configuration for aa-notify is done via /etc/apparmor/notify.conf:

	 # set to 'yes' to enable AppArmor DENIED notifications
	 show_notifications="yes"

	 # only people in use_group can use aa-notify
	 use_group="admin"

       Per-user configuration is done via ~/.apparmor/notify.conf:

	 # set to 'yes' to enable AppArmor DENIED notifications
	 show_notifications="yes"

BUGS

       aa-notify needs to be able to read the logfiles containing the AppArmor DENIED messages.

       If you find any additional bugs, please report them to Launchpad at <https://bugs.launchpad.net/apparmor/+filebug>.

SEE ALSO

       apparmor(7)

AppArmor 2.7.103						    2012-06-28							      AA-NOTIFY(8)

AA-STATUS(8)							     AppArmor							      AA-STATUS(8)

NAME

       aa-status - display various information about the current AppArmor policy.

SYNOPSIS

       aa-status [option]

DESCRIPTION

       aa-status will report various aspects of the current state of AppArmor confinement. By default, it displays the same information as if the
       --verbose argument were given. A sample of what this looks like is:

	 apparmor module is loaded.
	 110 profiles are loaded.
	 102 profiles are in enforce mode.
	 8 profiles are in complain mode.
	 Out of 129 processes running:
	 13 processes have profiles defined.
	 8 processes have profiles in enforce mode.
	 5 processes have profiles in complain mode.

       Other argument options are provided to report individual aspects, to support being used in scripts.

OPTIONS

       aa-status accepts only one argument at a time out of:

       --enabled
	   returns error code if AppArmor is not enabled.

       --profiled
	   displays the number of loaded AppArmor policies.

       --enforced
	   displays the number of loaded enforcing AppArmor policies.

       --complaining
	   displays the number of loaded non-enforcing AppArmor policies.

       --verbose
	   displays multiple data points about loaded AppArmor policy set (the default action if no arguments are given).

       --help
	   displays a short usage statement.

BUGS

       aa-status must be run as root to read the state of the loaded policy from the apparmor module. It uses the /proc filesystem to determine
       which processes are confined and so is susceptible to race conditions.

       Upon exiting, aa-status will set its return value to the following values:

       0   if apparmor is enabled and policy is loaded.

       1   if apparmor is not enabled/loaded.

       2   if apparmor is enabled but no policy is loaded.

       3   if the apparmor control files aren't available under /sys/kernel/security/.

       4   if the user running the script doesn't have enough privileges to read the apparmor control files.

       If you find any additional bugs, please report them at <http://https://bugs.launchpad.net/apparmor/+filebug>.

SEE ALSO

       apparmor(7), apparmor.d(5), and <http://wiki.apparmor.net>.

AppArmor 2.7.0~beta1						    2010-12-20							      AA-STATUS(8)