Directives

apparmor.d supports build directives, they are processed at build time of the project, when running make. They are valid apparmor comment, 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 paragraph depending on the target distribution of 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 Archlinux family.

Exec¶

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

Format

#aa:exec [transition] profiles...

profiles...: List of profile file 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 file 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=@@{hex}/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>