AA-SHOW-USAGE(8) AppArmor AA-SHOW-USAGE(8)

# [NAME](#NAME)

aa-show-usage - Check which profiles are used

# [SYNOPSIS](#SYNOPSIS)

**aa-show-usage** \[option]

# [DESCRIPTION](#DESCRIPTION)

**aa-show-usage** will display data on the usage of the profiles of the system

# [OPTIONS](#OPTIONS)

**aa-show-usage** accepts the following arguments:

[-s, --show-type {all,used,unused}](#s,)

Type of profiles to show

[-j, --json](#j,)

Output in JSON

[-d, --dir](#d,)

Path to profiles

[--show-matching-path](#show)

Show the path of a file matching the profile. Only the first matching path of an executable is shown (not the whole list).

# [FILTERING OPTIONS](#FILTERING_OPTIONS)

**aa-show-usage** accepts the following filters to reduce the output of information to only those entries that will match the filter. Filters use Python's regular expression syntax.

[--filter.flags FLAGS](#filter.flags)

Filter by flags

[--filter.profile\_name PROFILE\_NAME](#filter.profile_name)

Filter by profile name

[--filter.profile\_attach PROFILE\_ATTACH](#filter.profile_attach)

Filter by profile attachment (i.e. by path of the executable to which this profile applies)

[--filter.profile\_path PROFILE\_PATH](#filter.profile_path)

Filter by profile path

# [EXAMPLES](#EXAMPLES)

Show both the list of used and unused profiles in your system.

```
  $ aa-show-usage
```

Show the list of unconfined profiles currently used by your system.

```
  $ aa-show-usage --show-type=used --filter.flags=unconfined
```

# [BUGS](#BUGS)

**aa-show-usage** needs to be able to read profiles to tell whether they are used in practice.

**aa-show-usage** will only report directly used profiles. Profiles used via profile transitions, systemd's **AppArmorProfile=**, or API call such as **aa-exec** are not shown as used.

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

# [SEE ALSO](#SEE_ALSO)

[**apparmor**(7)](/man/enterprise-packages/apparmor-utils/apparmor.7)

2026-09-13 AppArmor 5.0.2

---

Document: aa-show-usage(8) from apparmor-utils 5.0.2-r2 (Chainguard OS)
Source: https://gitlab.com/apparmor/apparmor.git