man-page-fs-updates-20070817
[openafs.git] / doc / man-pages / pod8 / fstrace_clear.pod
1 =head1 NAME
2
3 fstrace clear - Clears the trace log
4
5 =head1 SYNOPSIS
6
7 =for html
8 <div class="synopsis">
9
10 B<fstrace clear> S<<< [B<-set> <I<set name>>+] >>> S<<< [B<-log> <I<log name>>+] >>>
11     [B<-help>]
12
13 B<fstrace c> S<<< [B<-s> <I<set name>>+] >>> S<<< [B<-l> <I<log name>>+] >>> [B<-h>]
14
15 =for html
16 </div>
17
18 =head1 DESCRIPTION
19
20 The B<fstrace clear> command erases the contents of the trace log from
21 kernel memory, but leaves kernel memory allocated for the log.
22
23 =head1 OPTIONS
24
25 =over 4
26
27 =item B<-set> <I<set name>>+
28
29 Names the event set for which to clear the associated trace log.  The only
30 acceptable value is C<cm> (for which the associated trace log is
31 C<cmfx>). Provide either this argument or the B<-log> argument, or omit
32 both to clear the C<cmfx> log by default.
33
34 =item B<-log> <I<log name>>+
35
36 Names the trace log to clear. The only acceptable value is
37 C<cmfx>. Provide either this argument or the B<-set> argument, or omit
38 both to clear the C<cmfx> log by default.
39
40 =item B<-help>
41
42 Prints the online help for this command. All other valid options are
43 ignored.
44
45 =back
46
47 =head1 EXAMPLES
48
49 The following command clears the C<cmfx> trace log on the local machine:
50
51    # fstrace clear
52
53 =head1 PRIVILEGE REQUIRED
54
55 The issuer must be logged in as the local superuser C<root>.
56
57 =head1 SEE ALSO
58
59 L<fstrace(8)>,
60 L<fstrace_lslog(8)>,
61 L<fstrace_lsset(8)>
62
63 =head1 COPYRIGHT
64
65 IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
66
67 This documentation is covered by the IBM Public License Version 1.0.  It was
68 converted from HTML to POD by software written by Chas Williams and Russ
69 Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.