← Back to branch summary

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

« back to all changes in this revision

Viewing changes to utils/aa-notify.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:
utils/aa-notify.pod
 
1
# This publication is intellectual property of Canonical Ltd. Its contents
 
2
# can be duplicated, either in part or in whole, provided that a copyright
 
3
# label is visibly located on each copy.
 
4
#
 
5
# All information found in this book has been compiled with utmost
 
6
# attention to detail. However, this does not guarantee complete accuracy.
 
7
# Neither Canonical Ltd, the authors, nor the translators shall be held
 
8
# liable for possible errors or the consequences thereof.
 
9
#
 
10
# Many of the software and hardware descriptions cited in this book
 
11
# are registered trademarks. All trade names are subject to copyright
 
12
# restrictions and may be registered trade marks. Canonical Ltd
 
13
# essentially adheres to the manufacturer's spelling.
 
14
#
 
15
# Names of products and trademarks appearing in this book (with or without
 
16
# specific notation) are likewise subject to trademark and trade protection
 
17
# laws and may thus fall under copyright restrictions.
 
18
#
 
19
 
 
20
 
 
21
=pod
 
22
 
 
23
=head1 NAME
 
24
 
 
25
aa-notify - display information about logged AppArmor messages.
 
26
 
 
27
=head1 SYNOPSIS
 
28
 
 
29
B<aa-notify> [option]
 
30
 
 
31
=head1 DESCRIPTION
 
32
 
 
33
B<aa-notify> will display a summary or provide desktop notifications
 
34
for AppArmor DENIED messages.
 
35
 
 
36
=head1 OPTIONS
 
37
 
 
38
B<aa-notify> accepts the following arguments:
 
39
 
 
40
=over 4
 
41
 
 
42
=item -p, --poll
 
43
 
 
44
poll AppArmor logs and display desktop notifications. Can be used with '-s'
 
45
option to display a summary on startup.
 
46
 
 
47
=item -f FILE, --file=FILE
 
48
 
 
49
search FILE for AppArmor messages
 
50
 
 
51
=item -l, --since-last
 
52
 
 
53
show summary since last login.
 
54
 
 
55
=item -s NUM, --since-days=NUM
 
56
 
 
57
show summary for last NUM of days.
 
58
 
 
59
=item -u USER, --user=USER
 
60
 
 
61
user to drop privileges to when running privileged. This has no effect when
 
62
running under sudo.
 
63
 
 
64
=item -w NUM, --wait=NUM
 
65
 
 
66
wait NUM seconds before displaying notifications (for use with -p)
 
67
 
 
68
=item -v, --verbose
 
69
 
 
70
show messages with summaries.
 
71
 
 
72
=item -h, --help
 
73
 
 
74
displays a short usage statement.
 
75
 
 
76
=back
 
77
 
 
78
=head1 CONFIGURATION
 
79
 
 
80
System-wide configuration for B<aa-notify> is done via
 
81
/etc/apparmor/notify.conf:
 
82
 
 
83
  # set to 'yes' to enable AppArmor DENIED notifications
 
84
  show_notifications="yes"
 
85
 
 
86
  # only people in use_group can use aa-notify
 
87
  use_group="admin"
 
88
 
 
89
Per-user configuration is done via ~/.apparmor/notify.conf:
 
90
 
 
91
  # set to 'yes' to enable AppArmor DENIED notifications
 
92
  show_notifications="yes"
 
93
 
 
94
=head1 BUGS
 
95
 
 
96
B<aa-notify> needs to be able to read the logfiles containing the
 
97
AppArmor DENIED messages.
 
98
 
 
99
If you find any additional bugs, please report them to Launchpad at
 
100
L<https://bugs.launchpad.net/apparmor/+filebug>.
 
101
 
 
102
=head1 SEE ALSO
 
103
 
 
104
apparmor(7)
 
105
 
 
106
=cut