pod-man-pages-20051015
[openafs.git] / doc / man-pages / pod / fs_messages.pod
1 =head1 NAME
2
3 fs messages - Sets whether the Cache Manager writes log messages
4
5 =head1 SYNOPSIS
6
7 fs messages [B<-show> I<[user|console|all|none]>]  [B<-help>]
8
9 fs me [B<-s> I<[user|console|all|none]>]  [B<-h>]
10
11 =head1 DESCRIPTION
12
13 The C<fs messages> command controls whether the Cache Manager displays
14 status and warning messages on user screens, the client machine
15 console, on both, or on neither.
16
17 There are two types of Cache Manager messages:
18
19 =over
20
21 =item *
22
23 User messages provide user-level status and warning information,
24 and the Cache Manager directs them to user screens.
25
26 =item *
27
28 Console messages provide system-level status and warning
29 information, and the Cache Manager directs them to the client
30 machine's designated console.
31
32 =back
33
34 Disabling messaging completely is not recommended, because the
35 messages provide useful status and warning information.
36
37 =head1 OPTIONS
38
39 =over 4
40
41 =item B<-show> I<[user|console|all|none]>
42
43 Specifies the types of messages to display. Choose one of the
44 following values:
45
46 =over
47
48 =item B<user>
49
50 Send user messages to user screens
51
52 =item B<console>
53
54 Send console messages to the console
55
56 =item B<all>
57
58 Send user messages to user screens and console messages
59 to the console (the default if the B<-show> argument is
60 omitted)
61
62 =item B<none>
63
64 Do not send any messages to user screens or the console
65
66 =back
67
68 =item B<-help>
69
70 Prints the online help for this command. All other valid
71 options are ignored.
72
73 =back
74
75 =head1 EXAMPLES
76
77 The following command instructs the Cache Manager to display both
78 types of messages:
79
80     fs messages -show all
81
82 =head1 PRIVILEGE REQUIRED
83
84 The issuer must be logged in as the local superuser B<root>.
85
86 =head1 COPYRIGHT
87
88 IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
89
90 Converted from html to pod by Alf Wachsmann <alfw@slac.stanford.edu>, 2003,
91 and Elizabeth Cassell <e_a_c@mailsnare.net>, 2004,
92 Stanford Linear Accelerator Center, a department of Stanford University.
93
94 =head1 SEE ALSO
95
96 L<afsd(1)>
97
98 =cut