Write a man page for aa-load based on the help text

Signed-off-by: Ryan Lee <ryan.lee@canonical.com>
This commit is contained in:
Ryan Lee 2025-01-24 16:03:20 -08:00
parent 6592daff90
commit ee8300545e
3 changed files with 79 additions and 1 deletions

1
.gitignore vendored
View file

@ -7,6 +7,7 @@ binutils/aa-exec.1
binutils/aa-features-abi binutils/aa-features-abi
binutils/aa-features-abi.1 binutils/aa-features-abi.1
binutils/aa-load binutils/aa-load
binutils/aa-load.8
binutils/aa-status binutils/aa-status
binutils/aa-status.8 binutils/aa-status.8
binutils/cJSON.o binutils/cJSON.o

View file

@ -21,7 +21,7 @@ DESTDIR=/
BINDIR=${DESTDIR}/usr/bin BINDIR=${DESTDIR}/usr/bin
SBINDIR=${DESTDIR}/usr/sbin SBINDIR=${DESTDIR}/usr/sbin
LOCALEDIR=/usr/share/locale LOCALEDIR=/usr/share/locale
MANPAGES=aa-enabled.1 aa-exec.1 aa-features-abi.1 aa-status.8 MANPAGES=aa-enabled.1 aa-exec.1 aa-features-abi.1 aa-load.8 aa-status.8
WARNINGS = -Wall WARNINGS = -Wall
CPP_WARNINGS = CPP_WARNINGS =

77
binutils/aa-load.pod Normal file
View file

@ -0,0 +1,77 @@
# This publication is intellectual property of Canonical Ltd. Its contents
# can be duplicated, either in part or in whole, provided that a copyright
# label is visibly located on each copy.
#
# All information found in this book has been compiled with utmost
# attention to detail. However, this does not guarantee complete accuracy.
# Neither Canonical Ltd, the authors, nor the translators shall be held
# liable for possible errors or the consequences thereof.
#
# Many of the software and hardware descriptions cited in this book
# are registered trademarks. All trade names are subject to copyright
# restrictions and may be registered trade marks. Canonical Ltd
# essentially adheres to the manufacturer's spelling.
#
# Names of products and trademarks appearing in this book (with or without
# specific notation) are likewise subject to trademark and trade protection
# laws and may thus fall under copyright restrictions.
#
=pod
=head1 NAME
aa-load - load precompiled AppArmor policy from cache location(s)
=head1 SYNOPSIS
B<aa-load> [options] (cache file|cache dir|cache base dir)+
=head1 DESCRIPTION
B<aa-load> loads precompiled AppArmor policy from the specified locations.
=head1 OPTIONS
B<aa-load> accepts the following arguments:
=over 4
=item -f, --force
Force B<aa-load> to load a policy even if its abi does not match the kernel abi.
=item -d, --debug
Display debug messages.
=item -v, --verbose
Display progress and error messages.
=item -n, --dry-run
Do not actually load the specified policy/policies into the kernel.
=item -h, --help
Display a brief usage guide.
=back
=head1 EXIT STATUS
Upon exiting, B<aa-load> returns 0 upon success and 1 upon an error loading
the precompiled policy.
=head1 BUGS
If you find any bugs, please report them at
L<https://gitlab.com/apparmor/apparmor/-/issues>.
=head1 SEE ALSO
apparmor(7), apparmor.d(5), apparmor_parser(8), and L<https://wiki.apparmor.net>.
=cut