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