.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sh \" Subsection heading
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  | will give a
.\" real vertical bar.  \*(C+ will give a nicer C++.  Capital omega is used to
.\" do unbreakable dashes and therefore won't be available.  \*(C` and \*(C'
.\" expand to `' in nroff, nothing in troff, for use with C<>.
.tr \(*W-|\(bv\*(Tr
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
'br\}
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.if \nF \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    nr % 0
.    rr F
.\}
.\"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.hy 0
.if n .na
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "IPFMETA 1"
.TH IPFMETA 1 "2001-02-13" "perl v5.8.8" "User Contributed Perl Documentation"
.SH "NAME"
\&\fBipfmeta\fR \- use objects in IPfilter files
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
\&\fBipfmeta\fR [\fIobjfile\fR]
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\fBipfmeta\fR is used to simplify the maintenance of your IPfilter
ruleset. It does this through the use of 'objects'. A matching
object gets replaced by its values at runtime. This is similar to
what a macro processor like m4 does.
.PP
\&\fBipfmeta\fR is specifically geared towards IPfilter. It is line
oriented: if an object has multiple values, the line with the object
is duplicated and substituted for each value. It is also recursive:
an object may have another object as a value.
.PP
Metarules to be processed are read from stdin, output rules go to
stdout.
.PP
Definition of the objects and their values is done in a separate
file; the filename defaults to \fIipf.objs\fR. An object is delimited
by square brackets. A value is delimited by whitespace, except when
it is enclosed by double\-quotes. Comments start with '#' and end
with a newline. Empty lines and extraneous whitespace are allowed.
A value belongs to the object that precedes it.
.PP
\&\fBipfmeta\fR has a command mode. Metarules starting with '%' are
passed to the command processor. The commands are listed below.
.PP
It is recommended that you use all caps or another distinguishing
feature for object names. You can use \fBipfmeta\fR for \s-1NAT\s0 rules also,
for instance to keep them in sync with filter rules. Combine
\&\fBipfmeta\fR with a Makefile to save typing.
.SH "COMMANDS"
.IX Header "COMMANDS"
.IP "\fBdump\fR" 4
.IX Item "dump"
Include a list of all objects with their values in the output as
comments. This can be used to verify if the objectfile is parsed
correctly.
.IP "\fBgroup\fR \fIn\fR" 4
.IX Item "group n"
Append 'group n' to subsequent output rules. Use 'group 0' to stop
appending groups to the output. This is also the default.
.IP "\fBverbose\fR \fIlevel\fR" 4
.IX Item "verbose level"
Include expanded metarules in output as comments. The default is
0, do not add any comments. Higher verbosity levels cause deeper
levels of expanded metarules to be included.
.SH "EXAMPLES"
.IX Header "EXAMPLES"
ipfmeta ipf.objs <ipf.metarules >ipf.rules
.PP
cat ipf.metarules | ipfmeta | ipf \-I \-Fa \-vf \-
.SH "AUTHOR"
.IX Header "AUTHOR"
Camiel Dobbelaar <cd@sentia.nl>