contrib/ipfilter/man/ipnat.8

   1 .\"     $FreeBSD$
   2 .\"
   3 .TH IPNAT 8
   4 .SH NAME
   5 ipnat \- user interface to the NAT subsystem
   6 .SH SYNOPSIS
   7 .B ipnat
   8 [
   9 .B \-dhlnrsvCF
  10 ]
  11 [
  12 .B \-M core
  13 ]
  14 [
  15 .B \-N system
  16 ]
  17 .B \-f <\fIfilename\fP>
  18 .SH DESCRIPTION
  19 .PP
  20 \fBipnat\fP opens the filename given (treating "\-" as stdin) and parses the
  21 file for a set of rules which are to be added or removed from the IP NAT.
  22 .PP
  23 Each rule processed by \fBipnat\fP
  24 is added to the kernels internal lists if there are no parsing problems.
  25 Rules are added to the end of the internal lists, matching the order in
  26 which they appear when given to \fBipnat\fP.
  27 .PP
  28 Note that if
  29 \fBipf(8)\fP
  30 is not enabled when NAT is configured, it will be enabled
  31 automatically, as the same kernel facilities are used for
  32 NAT functionality.  In addition, packet forwarding must be
  33 enabled.
  34 .SH OPTIONS
  35 .TP
  36 .B \-C
  37 delete all entries in the current NAT rule listing (NAT rules)
  38 .TP
  39 .B \-d
  40 Enable printing of some extra debugging information.
  41 .TP
  42 .B \-F
  43 delete all active entries in the current NAT translation table (currently
  44 active NAT mappings)
  45 .TP
  46 .B \-h
  47 Print number of hits for each MAP/Redirect filter.
  48 .TP
  49 .B \-l
  50 Show the list of current NAT table entry mappings.
  51 .TP
  52 .B \-n
  53 This flag (no-change) prevents \fBipf\fP from actually making any ioctl
  54 calls or doing anything which would alter the currently running kernel.
  55 .TP
  56 .B \-p
  57 This flag is used with the \fB-r\fP flag to cause any active NAT
  58 sessions that were created by the rules being removed and that are
  59 currently active to also be removed.
  60 .TP
  61 .B \-r
  62 Remove matching NAT rules rather than add them to the internal lists.
  63 .TP
  64 .B \-s
  65 Retrieve and display NAT statistics.
  66 .TP
  67 .B \-v
  68 Turn verbose mode on.  Displays information relating to rule processing
  69 and active rules/table entries.
  70 .DT
  71 .SH FILES
  72 /dev/ipnat
  73 .br
  74 /usr/share/examples/ipfilter  Directory with examples.
  75 .SH SEE ALSO
  76 ipnat(5), ipf(8), ipfstat(8)