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