Man page - aa-status(8)

Packages contains this manual

Package: apparmor
apt-get install apparmor

Manuals in package:

Documentations in package:

apparmor

Manual

AA-STATUS

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXIT STATUS
BUGS
SEE ALSO

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.

--kill

displays the number of loaded enforcing AppArmor policies that will kill tasks on policy violations.

--prompt

displays the number of loaded enforcing AppArmor policies, with fallback to userspace mediation.

--special-unconfined

displays the number of loaded non-enforcing AppArmor policies that are in the special unconfined mode.

--process-mixed displays the number of processes confined by profile
stacks with profiles in different modes.
--verbose

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

--json

displays multiple data points about loaded AppArmor policy set in a JSON format, fit for machine consumption.

--pretty-json

same as --json, formatted to be readable by humans as well as by machines.

--show

what data sets to show information about. Currently processes , profiles , all for both processes and profiles. The default is all .

--count

display only counts for selected information.

--filter.mode=filter

Allows specifying a posix regular expression filter that will be applied against the displayed processes and profiles apparmor profile mode, reducing the output.

--filter.profiles=filter

Allows specifying a posix regular expression filter that will be applied against the displayed processes and profiles confining profile, reducing the output.

--filter.pid=filter

Allows specifying a posix regular expression filter that will be applied against the displayed processes, so that only processes pids matching the expression will be displayed.

--filter.exe=filter

Allows specifying a posix regular expression filter that will be applied against the displayed processes, so that only processes executable name matching the expression will be displayed.

--help

displays a short usage statement.

EXIT STATUS

Upon exiting, aa-status will set its exit status 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.
	42		if an internal error occurred.

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.

If you find any additional bugs, please report them at <https://gitlab.com/apparmor/apparmor/-/issues>.