Directives

apparmor.d supports build directives, they are processed at build time of the project. They are valid AppArmor comments, therefore, apparmor_parser can be used on a profile even if the directives have not been processed. They should not end with a comma. Multiline directive is not supported.

The directives follow the format:

#aa:<name> [options]

<name>: The name of the directive to apply
[options]: A (possibly empty) list or map of arguments. Exact format depend on the directive.

Dbus¶

See the dbus page.

Only, Exclude¶

The only and exclude directives can be used to filter individual rule or rule paragraphs depending on the target distribution or distribution family.

Format

#aa:only <filter>
#aa:exclude <filter>

<filter>

The filter to apply. Can be:

A supported target distribution: arch, debian, ubuntu, opensuse, whonix.
A supported distribution family: apt, pacman, zypper.

Example

apparmor.d/profiles-m-r/packagekitd

  #aa:only opensuse
        @{run}/zypp.pid rwk,
  owner @{run}/zypp-rpm.pid rwk,
  owner @{run}/zypp/packages/ r,

Generate

#aa:only pacman: Remove the line/paragraph when the project is not compiled on the Arch Linux family.

Exec¶

The exec directive is useful to allow executing transitions to a profile without having to manage the possible long list of profile attachments (it varies depending on the distribution). The directives parse and resolve the attachment variable (@{exec_path}) of the target profile and includes it in the current profile.

Format

#aa:exec [transition] profiles...

profiles...: List of profile files that can be executed from the current profile.
[transition]: Optional transition mode (default: P). Can be any of: P, U, p, u, PU, pu.

Example

apparmor.d/groups/kde/ksmserver

29	`#aa:exec kscreenlocker_greet`

Generate

#aa:exec baloo

@{bin}/baloo_file Px,
@{lib}/@{multiarch}/{,libexec/}baloo_file Px,
@{lib}/{,kf6/}baloo_file Px,

Stack¶

Stacked profiles can be hard to maintain. The parent profile needs to manage its own rules as well as always include the stacked profile rules. This directive automatically include the stacked profile rules into the parent profile.

Format

#aa:stack profiles...

profiles...: List a profile files to stack at the end of the current profile.

Example

apparmor.d/_full/systemd

150	`#aa:stack systemd-networkd systemd-oomd systemd-resolved systemd-timesyncd`

Generate

#aa:stack systemd-oomd

# Stacked profile: systemd-oomd
include <abstractions/bus-system>
include <abstractions/common/systemd>
capability dac_override,
capability kill,
unix (bind) type=stream addr=@@{hex16}/bus/systemd-oomd/bus-api-oom,
#aa:dbus own bus=system name=org.freedesktop.oom1
/etc/systemd/oomd.conf r,
/etc/systemd/oomd.conf.d/{,**} r,
        @{run}/systemd/io.system.ManagedOOM rw,
        @{run}/systemd/io.systemd.ManagedOOM rw,
        @{run}/systemd/notify rw,
owner @{run}/systemd/journal/socket w,
@{sys}/fs/cgroup/cgroup.controllers r,
@{sys}/fs/cgroup/memory.pressure r,
@{sys}/fs/cgroup/user.slice/user-@{uid}.slice/user@@{uid}.service/memory.* r,
@{PROC}/pressure/{cpu,io,memory} r,
include if exists <local/systemd-oomd>