summaryrefslogtreecommitdiff
path: root/contrib/pf/pflogd/pflogd.8
diff options
context:
space:
mode:
Diffstat (limited to 'contrib/pf/pflogd/pflogd.8')
-rw-r--r--contrib/pf/pflogd/pflogd.8192
1 files changed, 0 insertions, 192 deletions
diff --git a/contrib/pf/pflogd/pflogd.8 b/contrib/pf/pflogd/pflogd.8
deleted file mode 100644
index ac8fe78aa0a79..0000000000000
--- a/contrib/pf/pflogd/pflogd.8
+++ /dev/null
@@ -1,192 +0,0 @@
-.\" $OpenBSD: pflogd.8,v 1.24 2004/01/16 10:45:49 jmc Exp $
-.\"
-.\" Copyright (c) 2001 Can Erkin Acar. All rights reserved.
-.\"
-.\" Redistribution and use in source and binary forms, with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\" 1. Redistributions of source code must retain the above copyright
-.\" notice, this list of conditions and the following disclaimer.
-.\" 2. Redistributions in binary form must reproduce the above copyright
-.\" notice, this list of conditions and the following disclaimer in the
-.\" documentation and/or other materials provided with the distribution.
-.\" 3. The name of the author may not be used to endorse or promote products
-.\" derived from this software without specific prior written permission.
-.\"
-.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
-.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
-.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
-.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
-.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
-.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
-.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
-.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
-.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
-.\"
-.Dd July 9, 2001
-.Dt PFLOGD 8
-.Os
-.Sh NAME
-.Nm pflogd
-.Nd packet filter logging daemon
-.Sh SYNOPSIS
-.Nm pflogd
-.Op Fl Dx
-.Op Fl d Ar delay
-.Op Fl f Ar filename
-.Op Fl s Ar snaplen
-.Op Ar expression
-.Sh DESCRIPTION
-.Nm
-is a background daemon which reads packets logged by
-.Xr pf 4
-to the packet logging interface
-.Pa pflog0
-and writes the packets to a logfile (normally
-.Pa /var/log/pflog )
-in
-.Xr tcpdump 8
-binary format.
-These logs can be reviewed later using the
-.Fl r
-option of
-.Xr tcpdump 8 ,
-hopefully offline in case there are bugs in the packet parsing code of
-.Xr tcpdump 8 .
-.Pp
-.Nm
-closes and then re-opens the log file when it receives
-.Dv SIGHUP ,
-permitting
-.Xr newsyslog 8
-to rotate logfiles automatically.
-.Dv SIGALRM
-causes
-.Nm
-to flush the current logfile buffers to the disk, thus making the most
-recent logs available.
-The buffers are also flushed every
-.Ar delay
-seconds.
-.Pp
-If the log file contains data after a restart or a
-.Dv SIGHUP ,
-new logs are appended to the existing file.
-If the existing log file was created with a different snaplen,
-.Nm
-temporarily uses the old snaplen to keep the log file consistent.
-.Pp
-.Nm
-tries to preserve the integrity of the log file against I/O errors.
-Furthermore, integrity of an existing log file is verified before
-appending.
-If there is an invalid log file or an I/O error, logging is suspended until a
-.Dv SIGHUP
-or a
-.Dv SIGALRM
-is received.
-.Pp
-The options are as follows:
-.Bl -tag -width Ds
-.It Fl D
-Debugging mode.
-.Nm
-does not disassociate from the controlling terminal.
-.It Fl d Ar delay
-Time in seconds to delay between automatic flushes of the file.
-This may be specified with a value between 5 and 3600 seconds.
-If not specified, the default is 60 seconds.
-.It Fl f Ar filename
-Log output filename.
-Default is
-.Pa /var/log/pflog .
-.It Fl s Ar snaplen
-Analyze at most the first
-.Ar snaplen
-bytes of data from each packet rather than the default of 96.
-The default of 96 is adequate for IP, ICMP, TCP, and UDP headers but may
-truncate protocol information for other protocols.
-Other file parsers may desire a higher snaplen.
-.It Fl x
-Check the integrity of an existing log file, and return.
-.It Ar expression
-Selects which packets will be dumped, using the regular language of
-.Xr tcpdump 8 .
-.El
-.Sh FILES
-.Bl -tag -width /var/run/pflogd.pid -compact
-.It Pa /var/run/pflogd.pid
-Process ID of the currently running
-.Nm .
-.It Pa /var/log/pflog
-Default log file.
-.El
-.Sh EXAMPLES
-Log specific tcp packets to a different log file with a large snaplen
-(useful with a log-all rule to dump complete sessions):
-.Bd -literal -offset indent
-# pflogd -s 1600 -f suspicious.log port 80 and host evilhost
-.Ed
-.Pp
-Display binary logs:
-.Bd -literal -offset indent
-# tcpdump -n -e -ttt -r /var/log/pflog
-.Ed
-.Pp
-Display the logs in real time (this does not interfere with the
-operation of
-.Nm ) :
-.Bd -literal -offset indent
-# tcpdump -n -e -ttt -i pflog0
-.Ed
-.Pp
-Tcpdump has been extended to be able to filter on the pfloghdr
-structure defined in
-.Aq Ar net/if_pflog.h .
-Tcpdump can restrict the output
-to packets logged on a specified interface, a rule number, a reason,
-a direction, an IP family or an action.
-.Pp
-.Bl -tag -width "reason match " -compact
-.It ip
-Address family equals IPv4.
-.It ip6
-Address family equals IPv6.
-.It ifname kue0
-Interface name equals "kue0".
-.It on kue0
-Interface name equals "kue0".
-.It rulenum 10
-Rule number equals 10.
-.It reason match
-Reason equals match.
-Also accepts "bad-offset", "fragment", "short", "normalize" and "memory".
-.It action pass
-Action equals pass.
-Also accepts "block".
-.It inbound
-The direction was inbound.
-.It outbound
-The direction was outbound.
-.El
-.Pp
-Display the logs in real time of inbound packets that were blocked on
-the wi0 interface:
-.Bd -literal -offset indent
-# tcpdump -n -e -ttt -i pflog0 inbound and action block and on wi0
-.Ed
-.Sh SEE ALSO
-.Xr pcap 3 ,
-.Xr pf 4 ,
-.Xr pflog 4 ,
-.Xr pf.conf 5 ,
-.Xr newsyslog 8 ,
-.Xr tcpdump 8
-.Sh HISTORY
-The
-.Nm
-command appeared in
-.Ox 3.0 .
-.Sh AUTHORS
-Can Erkin Acar