[hcoop/debian/openafs.git] / doc / man-pages / pod1 / fs_messages.pod

=head1 NAME

fs_messages - Sets whether the Cache Manager writes log messages

=head1 SYNOPSIS

=for html
<div class="synopsis">

B<fs messages> S<<< [B<-show> (user|console|all|none)] >>> [B<-help>]

B<fs me> S<<< [B<-s> (user|console|all|none)] >>> [B<-h>]

=for html
</div>

=head1 DESCRIPTION

The B<fs messages> command controls whether the Cache Manager displays
status and warning messages on user screens, the client machine console,
on both, or on neither.

There are two types of Cache Manager messages:

=over 4

=item *

User messages provide user-level status and warning information, and the
Cache Manager directs them to user screens.

=item *

Console messages provide system-level status and warning information, and
the Cache Manager directs them to the client machine's designated console.

=back

Disabling messaging completely is not recommended, because the messages
provide useful status and warning information.

=head1 OPTIONS

=over 4

=item B<-show> (user|console|all|none)

Specifies the types of messages to display. Choose one of the following
values:

=over 4

=item user

Send user messages to user screens.

=item console

Send console messages to the console.

=item all

Send user messages to user screens and console messages to the console
(the default if the B<-show> argument is omitted).

=item none

Do not send any messages to user screens or the console.

=back

=item B<-help>

Prints the online help for this command. All other valid options are
ignored.

=back

=head1 EXAMPLES

The following command instructs the Cache Manager to display both types of
messages:

   % fs messages -show all

=head1 PRIVILEGE REQUIRED

The issuer must be logged in as the local superuser root.

=head1 SEE ALSO

L<afsd(8)>

=head1 COPYRIGHT

IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.

This documentation is covered by the IBM Public License Version 1.0.  It was
converted from HTML to POD by software written by Chas Williams and Russ
Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.
Commit	Line	Data
805e021f CE	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.