diff options
Diffstat (limited to 'share/man')
-rw-r--r-- | share/man/man5/Makefile | 6 | ||||
-rw-r--r-- | share/man/man5/pf.conf.5 | 164 |
2 files changed, 167 insertions, 3 deletions
diff --git a/share/man/man5/Makefile b/share/man/man5/Makefile index 5fd28b58937..a485437ea1b 100644 --- a/share/man/man5/Makefile +++ b/share/man/man5/Makefile @@ -1,4 +1,4 @@ -# $OpenBSD: Makefile,v 1.20 2001/06/26 17:38:57 kjell Exp $ +# $OpenBSD: Makefile,v 1.21 2001/07/08 14:31:23 dhartmei Exp $ # $NetBSD: Makefile,v 1.14 1995/05/11 23:13:15 cgd Exp $ # missing: dump.5 plot.5 @@ -6,8 +6,8 @@ MAN= a.out.5 acct.5 bsd.port.mk.5 core.5 dir.5 disktab.5 ethers.5 fbtab.5 \ fs.5 fstab.5 group.5 hostname.if.5 hosts.equiv.5 hosts.5 intro.5 \ link.5 login.conf.5 moduli.5 motd.5 netgroup.5 networks.5 passwd.5 \ - passwd.conf.5 nat.conf.5 phones.5 printcap.5 protocols.5 remote.5 \ - resolv.conf.5 rpc.5 services.5 shells.5 stab.5 sysctl.conf.5 \ + passwd.conf.5 nat.conf.5 pf.conf.5 phones.5 printcap.5 protocols.5 \ + remote.5 resolv.conf.5 rpc.5 services.5 shells.5 stab.5 sysctl.conf.5 \ types.5 utmp.5 MLINKS= dir.5 dirent.5 fs.5 inode.5 utmp.5 wtmp.5 utmp.5 lastlog.5 MLINKS+= hosts.equiv.5 .rhosts.5 diff --git a/share/man/man5/pf.conf.5 b/share/man/man5/pf.conf.5 new file mode 100644 index 00000000000..cfeb982e9e7 --- /dev/null +++ b/share/man/man5/pf.conf.5 @@ -0,0 +1,164 @@ +.\" $OpenBSD: pf.conf.5,v 1.1 2001/07/08 14:31:23 dhartmei Exp $ +.\" +.\" Copyright (c) 2001, Daniel Hartmeier +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" +.\" - Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" - 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. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +.\" "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 +.\" COPYRIGHT HOLDERS OR CONTRIBUTORS 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 8, 2001 +.Dt PF.CONF 5 +.Os +.Sh NAME +.Nm pf.conf +.Nd filter rule configuration file for packet filtering +.Sh DESCRIPTION +The packet filter drops, passes and modifies packets according to the +rules defined in this file. For each packet inspected by the filter, +the set of rules is evaluated from top to bottom, and the last +matching rule decides what action is performed. +.Pp +.Sh GRAMMAR +Syntax for filter rules in BNF: +.Pp +.Bd -literal +rule = action ( "in" | "out" ) + [ "log" | "log-all" ] [ "quick" ] + [ "on" interface-name ] + [ "proto" ( proto-name | proto-number ] + hosts + [ flags ] [ icmp-type ] [ "keep-state" ] . + +action = "pass" | "block" [ return ] | "scrub" . +return = "return-rst" | + "return-icmp" [ "(" ( icmp-code-name | icmp-code-number ) ")" ] . + +hosts = "all" | + "from" ( "any" | host ) [ port ] "to" ( "any" | host ) [ port ]. +host = [ "!" ] address [ "/" mask-bits ] . +port = "port" ( unary-op | binary-op ) . +unary-op = ( "=" | "!=" | "<" | "<=" | ">" | ">=" ) + ( port-name | port-number ) . +binary-op = port-number ( "<>" | "><" ) port-number . + +flags = "flags" flag-set [ "/" flag-set ] . +flag-set = [ "F" ] [ "S" ] [ "R" ] [ "P" ] [ "A" ] [ "U" ] . + +icmp-type = "icmp-type" ( icmp-type-name | icmp-type-number ) + [ "code" ( icmp-code-name | icmp-code-number ) ] . +.Ed +.Pp +Emtpy lines and lines beginning with the character `#' are ignored. +.Pp +.Sh EXAMPLES +.Bd -literal +# My external interface is kue0 (157.161.48.183, my only routable address) and +# the private network is 10.0.0.0/8, for which i'm doing NAT. + +# block and log everything by default +# +block out log on kue0 all +block in log on kue0 all +block return-rst out log on kue0 proto tcp all +block return-rst in log on kue0 proto tcp all +block return-icmp out log on kue0 proto udp all +block return-icmp in log on kue0 proto udp all + +# block and log outgoing packets that don't have my address as source, they are +# either spoofed or something is misconfigured (NAT disabled, for instance), +# we want to be nice and don't send out garbage. +# +block out log quick on kue0 from ! 157.161.48.183 to any + +# silently drop broadcasts (cable modem noise) +# +block in quick on kue0 from any to 255.255.255.255 + +# block and log incoming packets from reserved address space and invalid +# addresses, they are either spoofed or misconfigured, we can't reply to +# them anyway (hence, no return-rst). +# +block in log quick on kue0 from 10.0.0.0/8 to any +block in log quick on kue0 from 172.16.0.0/12 to any +block in log quick on kue0 from 192.168.0.0/16 to any +block in log quick on kue0 from 255.255.255.255/32 to any + +# ----------------------------------------------------------------------------- +# ICMP +# ----------------------------------------------------------------------------- + +# pass out/in certain ICMP queries and keep state (ping) +# +# state matching is done on host addresses and ICMP id (not type/code), so +# replies (like 0/0 for 8/0) will match queries +# +# ICMP error messages (which always refer to a TCP/UDP packet) are handled +# by the TCP/UDP states +# +pass out on kue0 proto icmp all icmp-type 8 code 0 keep state +pass in on kue0 proto icmp all icmp-type 8 code 0 keep state + +# ----------------------------------------------------------------------------- +# UDP +# ----------------------------------------------------------------------------- + +# pass out all UDP connections and keep state +# +pass out on kue0 proto udp all keep state + +# pass in certain UDP connections and keep state (DNS) +# +pass in on kue0 proto udp from any to any port = domain keep state + +# ----------------------------------------------------------------------------- +# TCP +# ----------------------------------------------------------------------------- + +# pass out all TCP connections and keep state +# +pass out on kue0 proto tcp all keep state + +# pass in certain TCP connections and keep state (SSH, SMTP, DNS, IDENT) +# +pass in on kue0 proto tcp from any to any port = ssh keep state +pass in on kue0 proto tcp from any to any port = smtp keep state +pass in on kue0 proto tcp from any to any port = domain keep state +pass in on kue0 proto tcp from any to any port = auth keep state +.Ed +.Pp +.Sh FILES +.Bl -tag -width "/etc/pf.conf" -compact +.It Pa /etc/pf.conf +.It Pa /etc/services +.El +.Sh SEE ALSO +.Xr pf 4 , +.Xr nat.conf 5 , +.Xr services 5 , +.Xr pfctl 8 +.Sh HISTORY +The +.Nm +file format appeared in +.Ox 3.0 . |