]> git.ozlabs.org Git - ppp.git/blob - pppdump/pppdump.8
config: Include some extra files in the tarball
[ppp.git] / pppdump / pppdump.8
1 .TH PPPDUMP 8 "1 April 1999"
2 .SH NAME
3 pppdump \- convert PPP record file to readable format
4 .SH SYNOPSIS
5 .B pppdump
6 [
7 .B \-h
8 |
9 .B \-p
10 [
11 .B \-d
12 ]] [
13 .B \-r
14 ] [
15 .B \-a
16 ] [
17 .B \-m \fImru
18 ] [
19 .I file \fR...
20 ]
21 .ti 12
22 .SH DESCRIPTION
23 The
24 .B pppdump
25 utility converts the files written using the \fIrecord\fR option of
26 .B pppd
27 into a human-readable format.  If one or more filenames are specified,
28 .B pppdump
29 will read each in turn; otherwise it will read its standard input.  In
30 each case the result is written to standard output.
31 .PP
32 The options are as follows:
33 .TP
34 .B \-h
35 Prints the bytes sent and received in hexadecimal.  If neither this
36 option nor the \fB\-p\fR option is specified, the bytes are printed as
37 the characters themselves, with non-printing and non-ASCII characters
38 printed as escape sequences.
39 .TP
40 .B \-p
41 Collects the bytes sent and received into PPP packets, interpreting
42 the async HDLC framing and escape characters and checking the FCS
43 (frame check sequence) of each packet.  The packets are printed as hex
44 values and as characters (non-printable characters are printed as
45 `.').
46 .TP
47 .B \-d
48 With the \fB\-p\fR option, this option causes
49 .B pppdump
50 to decompress packets which have been compressed with the BSD-Compress
51 or Deflate methods.
52 .TP
53 .B \-r
54 Reverses the direction indicators, so that `sent' is printed for
55 bytes or packets received, and `rcvd' is printed for bytes or packets
56 sent.
57 .TP
58 .B \-a
59 Prints absolute times.
60 .TP
61 .B \-m \fImru
62 Use \fImru\fR as the MRU (maximum receive unit) for both directions of
63 the link when checking for over-length PPP packets (with the \fB\-p\fR
64 option).
65 .SH SEE ALSO
66 pppd(8)