2005-12-08 12:14:33 +00:00
|
|
|
=head1 NAME
|
|
|
|
|
2007-11-11 22:54:56 +00:00
|
|
|
fstrace_setset - Sets the status of an event set
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
|
2006-03-01 05:02:29 +00:00
|
|
|
=for html
|
|
|
|
<div class="synopsis">
|
|
|
|
|
2009-10-08 21:58:31 +01:00
|
|
|
B<fstrace setset> S<<< [B<-set> <I<set name>>+] >>>
|
|
|
|
[B<-active>] [B<-inactive>] [B<-dormant>] [B<-help>]
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2009-10-08 21:58:31 +01:00
|
|
|
B<fs sets> S<<< [B<-s> <I<set name>>+] >>> [B<-a>] [B<-i>] [B<-d>] [B<-h>]
|
2006-03-01 05:02:29 +00:00
|
|
|
|
|
|
|
=for html
|
|
|
|
</div>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
The B<fstrace setset> command sets the status of the C<cm> kernel event
|
|
|
|
set on the local machine, which determines whether trace messages are
|
|
|
|
recorded in the log buffer in kernel memory.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=head1 OPTIONS
|
|
|
|
|
|
|
|
=over 4
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item B<-set> <I<set name>>+
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
Names the event set for which to set the status. The only acceptable value
|
|
|
|
C<cm>, which is also the default if this argument is omitted.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item B<-active>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
Enables tracing for the event set and allocates kernel memory for the
|
2005-12-13 19:21:13 +00:00
|
|
|
associated trace log buffer. Provide one of this flag, the B<-inactive>
|
|
|
|
flag, or the B<-dormant> flag.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item B<-inactive>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
Temporarily disables tracing for the event set, but does not change the
|
2005-12-13 19:21:13 +00:00
|
|
|
allocation of kernel memory for the associated trace log buffer. Provide
|
|
|
|
one of this flag, the B<-active> flag, or the B<-dormant> flag.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item B<-dormant>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
Disables tracing for the event set and frees the kernel memory previously
|
2005-12-13 19:21:13 +00:00
|
|
|
allocated for the associated trace log buffer. Provide one of this flag,
|
|
|
|
the B<-active> flag, or the B<-inactive> flag.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item B<-help>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
Prints the online help for this command. All other valid options are
|
|
|
|
ignored.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=back
|
|
|
|
|
|
|
|
=head1 EXAMPLES
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
The following example sets the cm event set's status to inactive:
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
# fstrace setset -set cm -inactive
|
|
|
|
|
|
|
|
=head1 PRIVILEGE REQUIRED
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
The issuer must be logged in as the local superuser C<root>.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=head1 SEE ALSO
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
L<fstrace(8)>,
|
|
|
|
L<fstrace_lsset(8)>,
|
|
|
|
L<fstrace_setlog(8)>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=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.
|