← Back to branch summary

~ubuntu-branches/ubuntu/raring/apparmor/raring

« back to all changes in this revision

Viewing changes to docs/apparmor_parser.pod

  • Committer: Bazaar Package Importer
  • Author(s): Kees Cook
  • Date: 2007-03-23 16:42:01 UTC
  • Revision ID: james.westby@ubuntu.com-20070323164201-jkax6f0oku087b7l
Tags: upstream-2.0.1+510.dfsg
Import upstream version 2.0.1+510.dfsg

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/apparmor_parser.pod
 
1
# $Id: apparmor_parser.pod 190 2006-11-03 09:47:55Z seth_arnold $
 
2
# This publication is intellectual property of Novell Inc. Its contents
 
3
# can be duplicated, either in part or in whole, provided that a copyright
 
4
# label is visibly located on each copy.
 
5
# 
 
6
# All information found in this book has been compiled with utmost
 
7
# attention to detail. However, this does not guarantee complete accuracy.
 
8
# Neither SUSE LINUX GmbH, the authors, nor the translators shall be held
 
9
# liable for possible errors or the consequences thereof.
 
10
# 
 
11
# Many of the software and hardware descriptions cited in this book
 
12
# are registered trademarks. All trade names are subject to copyright
 
13
# restrictions and may be registered trade marks. SUSE LINUX GmbH
 
14
# essentially adheres to the manufacturer's spelling.
 
15
# 
 
16
# Names of products and trademarks appearing in this book (with or without
 
17
# specific notation) are likewise subject to trademark and trade protection
 
18
# laws and may thus fall under copyright restrictions.
 
19
# 
 
20
# Please direct suggestions and comments to apparmor-general@forge.novell.com.
 
21
 
 
22
 
 
23
=pod
 
24
 
 
25
=head1 NAME
 
26
 
 
27
apparmor_parser - loads AppArmor profiles into the kernel
 
28
 
 
29
=head1 SYNOPSIS
 
30
 
 
31
B<apparmor_parser [-adrR] [--add] [--debug]  [--replace] [--remove]
 
32
                  [--preprocess] [--Include n] [--base n] [ --Complain ]>
 
33
 
 
34
B<apparmor_parser [-hv] [--help] [--version]>
 
35
 
 
36
=head1 DESCRIPTION
 
37
 
 
38
B<apparmor_parser> is used to import new apparmor.d(5) profiles
 
39
into the Linux kernel. The profiles restrict the operations available
 
40
to processes by executable name.
 
41
 
 
42
The profiles are loaded into the Linux kernel by the B<apparmor_parser>
 
43
program, which takes its input from standard input. The input supplied to
 
44
B<apparmor_parser> should be in the format described in apparmor.d(5).
 
45
 
 
46
=head1 OPTIONS
 
47
 
 
48
=over 4
 
49
 
 
50
=item -a, --add
 
51
 
 
52
Insert the AppArmor definitions given into the kernel. This is the default
 
53
action. This gives an error message if a AppArmor definition by the same
 
54
name already exists in the kernel, or if the parser doesn't understand
 
55
its input. It reports when an addition succeeded.
 
56
 
 
57
=item -r, --replace
 
58
 
 
59
This flag is required if an AppArmor definition by the same name already
 
60
exists in the kernel; used to replace the definition already
 
61
in the kernel with the definition given on standard input.
 
62
 
 
63
=item -R, --remove
 
64
 
 
65
This flag is used to remove an AppArmor definition already in the kernel.
 
66
Note that it still requires a complete AppArmor definition as described
 
67
in apparmor.d(5) even though the contents of the definition aren't
 
68
used.
 
69
 
 
70
=item -p, --preprocess
 
71
 
 
72
Parse the profile(s) and process include directives and output the
 
73
result to stdout.
 
74
 
 
75
=item -I n, --Include n
 
76
 
 
77
Add element n to the search path when resolving #include directives
 
78
defined as an absolute paths.
 
79
 
 
80
=item -b n, --base n
 
81
 
 
82
Set the base directory for resolving #include directives
 
83
defined as relative paths.
 
84
 
 
85
=item -C, --Complain
 
86
 
 
87
Load the profile in complain mode.
 
88
 
 
89
=item -h, --help
 
90
 
 
91
Give a quick reference guide.
 
92
 
 
93
=item -v, --version
 
94
 
 
95
Print the version number and exit.
 
96
 
 
97
=item -d, --debug
 
98
 
 
99
Given once, only checks the profiles to ensure syntactic correctness.
 
100
Given twice, dumps its interpretation of the profile for checking.
 
101
 
 
102
=back
 
103
 
 
104
=head1 BUGS
 
105
 
 
106
None known. If you find any, please report them to bugzilla at
 
107
L<http://bugzilla.novell.com>.
 
108
 
 
109
=head1 SEE ALSO
 
110
 
 
111
apparmor(7), apparmor.d(5), subdomain.conf(5), change_hat(2), and
 
112
L<http://forge.novell.com/modules/xfmod/project/?apparmor>.
 
113
 
 
114
=cut