← Back to branch summary

~ubuntu-branches/ubuntu/wily/apparmor/wily

« back to all changes in this revision

Viewing changes to docs/logprof.conf.pod

  • Committer: Bazaar Package Importer
  • Author(s): Kees Cook
  • Date: 2011-04-27 10:38:07 UTC
  • mfrom: (5.1.118 natty)
  • Revision ID: james.westby@ubuntu.com-20110427103807-ym3rhwys6o84ith0
Tags: 2.6.1-2
debian/copyright: clarify for some full organization names.

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/logprof.conf.pod
1
 
# $Id: logprof.conf.pod 7 2006-04-12 03:21:58Z steve-beattie $ 
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
 
logprof.conf - configuration file for expert options that modify the
28
 
behavior of the AppArmor logprof(1) program.
29
 
 
30
 
=head1 DESCRIPTION
31
 
 
32
 
The logprof(1) program can be configured to have certain default behavior
33
 
by the contents of logprof.conf.
34
 
 
35
 
The B<[qualifiers]> section lists specific programs that should have
36
 
a subset of the full ix/px/ux list when asking what mode to execute
37
 
it using.
38
 
 
39
 
Since creating a separate profile for /bin/bash is dangerous, we can
40
 
specify that for /bin/bash, only (I)nherit, (U)nconstrained, and (D)eny
41
 
should be allowed options and only those will show up in the prompt when
42
 
we're asking about adding that to a profile.
43
 
 
44
 
Likewise, if someone currently exec's /bin/mount in ix or px mode, things
45
 
won't work, so we can provide only (U)nconstrained and (D)eny as options.
46
 
 
47
 
And certain apps like grep, awk, sed, cp, and mkdir should always
48
 
inherit the parent profile rather than having their own profile or
49
 
running unconfined, so for them we can specify that only (I)nherit and
50
 
(D)eny are the allowed options.
51
 
 
52
 
Any programs that are not listed in the qualifiers section get the full
53
 
(I)nherit / (P)rofile / (U)nconstrained / (D)eny option set.
54
 
 
55
 
If the user is doing something tricky and wants different behavior,
56
 
they can tweak or remove the corresponding line in the conf file.
57
 
 
58
 
The B<[defaulthat]> section lists changehat-aware programs and what hat
59
 
logprof(1) will collapse the entries to for that program if the user
60
 
specifies that the access should be allowed, but should not have it's
61
 
own hat.
62
 
 
63
 
The B<[globs]> section allows modification of the logprof rule engine
64
 
with respect to globbing suggestions that the user will be prompted with.
65
 
 
66
 
The format of each line is-- "<perl glob> = <apparmor glob>".
67
 
 
68
 
When logprof(1) asks about a specific path, if the perl glob matches the
69
 
path, it replaces the part of the path that matched with the corresponding
70
 
apparmor glob and adds it to the list of globbing suggestions.
71
 
 
72
 
Lines starting with # are comments and are ignored.
73
 
 
74
 
=head1 EXAMPLE
75
 
 
76
 
  [qualifiers]
77
 
    # things will very likely be painfully broken if bash has it's own profile
78
 
    /bin/bash  = iu
79
 
 
80
 
    # mount doesn't work if it's confined
81
 
    /bin/mount = u
82
 
 
83
 
    # these helper utilities should inherit the parent profile and
84
 
    # shouldn't have their own profiles
85
 
    /bin/awk   = i
86
 
    /bin/grep  = i
87
 
    /bin/sed   = i
88
 
 
89
 
  [defaulthat]
90
 
    /usr/sbin/sshd           = EXEC
91
 
    /usr/sbin/httpd2         = DEFAULT_URI
92
 
    /usr/sbin/httpd2-prefork = DEFAULT_URI
93
 
 
94
 
  [globs]
95
 
    # /foo/bar/lib/libbaz.so -> /foo/bar/lib/lib*
96
 
    /lib/lib[^\/]+so[^\/]*$  = /lib/lib*so*
97
 
 
98
 
    # strip kernel version numbers from kernel module accesses
99
 
    ^/lib/modules/[^\/]+\/   = /lib/modules/*/
100
 
 
101
 
    # strip pid numbers from /proc accesses
102
 
    ^/proc/\d+/              = /proc/*/
103
 
 
104
 
 
105
 
=head1 BUGS
106
 
 
107
 
None. Please report any you find to bugzilla at
108
 
L<http://bugzilla.novell.com>.
109
 
 
110
 
=head1 SEE ALSO
111
 
 
112
 
apparmor(7), apparmor.d(5), enforce(1), change_hat(2),
113
 
complain(1), logprof(1), genprof(1), and
114
 
L<http://forge.novell.com/modules/xfmod/project/?apparmor>.
115
 
 
116
 
=cut