Scroll to navigation

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.
--display $DISPLAY
set the DISPLAY environment variable to $DISPLAY (might be needed if sudo resets $DISPLAY)
-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"

  # OPTIONAL - custom notification message body
  message_body="This is a custom notification message."

  # OPTIONAL - custom notification message footer
  message_footer="For more information visit https://foo.com"

Per-user configuration is done via $XDG_CONFIG_HOME/apparmor/notify.conf (or the deprecated ~/.apparmor/notify.conf if it exists):

  # 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)
2019-03-30 AppArmor 2.13.2