1.\" Copyright (c) 2006 Niclas Zeising
2.\" All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\" notice, this list of conditions and the following disclaimer.
9.\" 2. Redistributions in binary form must reproduce the above copyright
10.\" notice, this list of conditions and the following disclaimer in the
11.\" documentation and/or other materials provided with the distribution.
12.\"
13.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
14.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
16.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
17.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
18.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
19.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
21.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
22.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
23.\" SUCH DAMAGE.
24.\"
| 1.\" Copyright (c) 2006 Niclas Zeising
2.\" All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\" notice, this list of conditions and the following disclaimer.
9.\" 2. Redistributions in binary form must reproduce the above copyright
10.\" notice, this list of conditions and the following disclaimer in the
11.\" documentation and/or other materials provided with the distribution.
12.\"
13.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
14.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
16.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
17.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
18.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
19.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
21.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
22.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
23.\" SUCH DAMAGE.
24.\"
|
25.\" $FreeBSD: head/usr.sbin/ipfwpcap/ipfwpcap.8 158822 2006-05-22 07:36:45Z joel $
| 25.\" $FreeBSD: head/usr.sbin/ipfwpcap/ipfwpcap.8 162893 2006-09-30 19:07:03Z ru $
|
26.\"
27.Dd May 22, 2006
28.Dt IPFWPCAP 8
29.Os
30.Sh NAME
31.Nm ipfwpcap
32.Nd "copy diverted packets to a file in tcpdump format"
33.Sh SYNOPSIS
34.Nm
35.Op Fl dr
36.Op Fl b Ar maxbytes
37.Op Fl p Ar maxpkts
38.Op Fl P Ar pidfile
39.Ar portnum
40.Ar dumpfile
41.Sh DESCRIPTION
42The
43.Nm
44utility is used to copy diverted packets to a file in
45.Xr tcpdump 1
46format.
47The interesting packets are diverted by
48.Xr ipfw 8
49to a port on which
50.Nm
51listens.
52The packets are then dropped unless
53.Fl r
54is used.
55.Pp
56The options are as follows:
| 26.\"
27.Dd May 22, 2006
28.Dt IPFWPCAP 8
29.Os
30.Sh NAME
31.Nm ipfwpcap
32.Nd "copy diverted packets to a file in tcpdump format"
33.Sh SYNOPSIS
34.Nm
35.Op Fl dr
36.Op Fl b Ar maxbytes
37.Op Fl p Ar maxpkts
38.Op Fl P Ar pidfile
39.Ar portnum
40.Ar dumpfile
41.Sh DESCRIPTION
42The
43.Nm
44utility is used to copy diverted packets to a file in
45.Xr tcpdump 1
46format.
47The interesting packets are diverted by
48.Xr ipfw 8
49to a port on which
50.Nm
51listens.
52The packets are then dropped unless
53.Fl r
54is used.
55.Pp
56The options are as follows:
|
57.Bl -tag -width Ds
| 57.Bl -tag -width indent
|
58.It Fl d
59Turns on extra debugging messages.
60.It Fl r
| 58.It Fl d
59Turns on extra debugging messages.
60.It Fl r
|
61Writes packets back to the divert socket.
| 61Writes packets back to the
62.Xr divert 4
63socket.
|
62.It Fl rr
63Indicates that it is okay to quit if
64.Ar maxbytes
65or
66.Ar maxpkts
67are reached.
68Diverted packets will silently disappear if nothing is listening on the
| 64.It Fl rr
65Indicates that it is okay to quit if
66.Ar maxbytes
67or
68.Ar maxpkts
69are reached.
70Diverted packets will silently disappear if nothing is listening on the
|
69divert socket.
| 71.Xr divert 4
72socket.
|
70.It Fl b Ar maxbytes
71Stop dumping after
72.Ar maxbytes
73bytes.
74.It Fl p Ar maxpkts
75Stop dumping after
76.Ar maxpkt
77packets.
78.It Fl P Ar pidfile
79File to store PID number in.
80Default is
81.Pa /var/run/ipwfpcap.portnr.pid .
82.El
83.Pp
84The
85.Ar portnum
86argument specifies which
87.Xr divert 4
88socket port to listen on.
89The
90.Ar dumpfile
91argument is the path to the file to write captured packets to.
92Specify
| 73.It Fl b Ar maxbytes
74Stop dumping after
75.Ar maxbytes
76bytes.
77.It Fl p Ar maxpkts
78Stop dumping after
79.Ar maxpkt
80packets.
81.It Fl P Ar pidfile
82File to store PID number in.
83Default is
84.Pa /var/run/ipwfpcap.portnr.pid .
85.El
86.Pp
87The
88.Ar portnum
89argument specifies which
90.Xr divert 4
91socket port to listen on.
92The
93.Ar dumpfile
94argument is the path to the file to write captured packets to.
95Specify
|
93.Sq Li -
| 96.Sq Fl
|
94to write to stdout.
95.Sh EXIT STATUS
96.Ex -std
97.Sh EXAMPLES
| 97to write to stdout.
98.Sh EXIT STATUS
99.Ex -std
100.Sh EXAMPLES
|
98.Dl ipfwpcap -r 8091 divt.log &
| 101.Dl "ipfwpcap -r 8091 divt.log &"
|
99.Pp
100Starts
101.Nm
102as a background job listening to port 8091 and reflecting the packets
103back to the socket.
104.Pp
| 102.Pp
103Starts
104.Nm
105as a background job listening to port 8091 and reflecting the packets
106back to the socket.
107.Pp
|
105.Dl ipfw add 2864 divert 8091 ip from 192.168.1.101
| 108.Dl "ipfw add 2864 divert 8091 ip from 192.0.2.101"
|
106.Pp
107Example
108.Xr ipfw 8
| 109.Pp
110Example
111.Xr ipfw 8
|
109rule to divert all packets from 192.168.1.101 to port 8091.
| 112rule to divert all packets from 192.0.2.101 to port 8091.
|
110See
111.Xr ipfw 8
112for details.
113.Sh SEE ALSO
114.Xr tcpdump 1 ,
115.Xr pcap 3 ,
116.Xr divert 4 ,
117.Xr ipfw 8
118.Sh HISTORY
119The
120.Nm
121utility first appeared in
122.Fx 7.0 .
123.Sh AUTHORS
124.An -nosplit
125.Nm
126was written by
127.An P. Kern Aq pkern@cns.utoronto.ca .
128This manual page was written by
129.An Niclas Zeising Aq lothrandil@n00b.apagnu.se .
| 113See
114.Xr ipfw 8
115for details.
116.Sh SEE ALSO
117.Xr tcpdump 1 ,
118.Xr pcap 3 ,
119.Xr divert 4 ,
120.Xr ipfw 8
121.Sh HISTORY
122The
123.Nm
124utility first appeared in
125.Fx 7.0 .
126.Sh AUTHORS
127.An -nosplit
128.Nm
129was written by
130.An P. Kern Aq pkern@cns.utoronto.ca .
131This manual page was written by
132.An Niclas Zeising Aq lothrandil@n00b.apagnu.se .
|