# aa-status - display various information about the current AppArmor... - man(8) - [phpMan]

[_AA-STATUS_(8)](https://www.chedong.com/phpMan.php/man/AA-STATUS/8/markdown)                                  AppArmor                                  [_AA-STATUS_(8)](https://www.chedong.com/phpMan.php/man/AA-STATUS/8/markdown)

## 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 processess 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 processess 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>>.

## SEE ALSO
       [**apparmor**(7)](https://www.chedong.com/phpMan.php/man/apparmor/7/markdown), [**apparmor.d**(5)](https://www.chedong.com/phpMan.php/man/apparmor.d/5/markdown), and <<https://wiki.apparmor.net>>.

AppArmor 4.0.1                               2026-04-13                                 [_AA-STATUS_(8)](https://www.chedong.com/phpMan.php/man/AA-STATUS/8/markdown)