NAME

       upnpd.conf - upnpd(8) configuration file

SYNOPSIS

       upnpd.conf

DESCRIPTION

       upnpd.conf   contains   the  configuration  details  to  do  with  run-time  of  upnpd(8).
       Configuration items related to starting the daemon such as interface  names  are  defined,
       for Debian, in /etc/default/linux-igd.

OPTIONS

       iptables_location
              The full path and name of the iptables executable, (enclosed in quotes).

              Example: iptables_location = "/sbin/iptables"

       debug_mode
              Daemon debug level. Messages are logged via syslog to debug.

                  0 - no debug messages
                  1 - log errors
                  2 - log errors and basic info
                  3 - log errors and verbose info
                  default = 0

              Example: debug_mode = 2

       create_forward_rules
              Should  the daemon create rules in the forward chain, or not.  This is necessary if
              your firewall has a drop or reject policy in your forward chain.

                  allowed values: yes,no
                  default = no

              Example: create_forward_rules = yes

       forward_rules_append
              Should the daemon insert or append rules in the forward chain.  Normally  you  will
              want  to  insert  rules  at  the beginning of the forward chain, so that they apply
              before any drop or reject rules later in the chain.  This option  only  applies  if
              "create_forward_rules = yes".

              As  an  experiment,  this setting now also affects the PREROUTING chain in the same
              way.  If this causes you problems please let me (Debian  maintainer)  know  through
              the BTS.

              Tip:  If  you  need  to  insert  rules somewhere in the middle of the PREROUTING or
              FORWARD chains, instead of first or last, then you should create a new empty chain,
              e.g  forwardUPnP,  and  set forward_chain_name to that chain. Then insert a rule to
              jump to forwardUPnP in the appropriate place in the PREROUTING  or  FORWARD  chain.
              (The value of forward_rules_append probably won't matter much in that case.)

                  allowed values: yes,no
                  default = no

              Example: forward_rules_append = no

       forward_chain_name
              The  name  of  the  chain to put the forward rules in.  This option only applies if
              "create_forward_rules = yes".

                  allowed values: a-z, A-Z, _, -
                  default = FORWARD

              Example: forward_chain_name = FORWARD

       prerouting_chain_name
              The name of the chain to put prerouting rules in.

                  allowed values: a-z, A-Z, _, -
                  default = PREROUTING

              Example: prerouting_chain_name = PREROUTING

       upstream_bitrate
              The internet line upstream bit rate reported from the daemon.  Value  in  bits  per
              second.

                  default = 0

              Example: upstream_bitrate = 512000

       downstream_bitrate
              The  internet  line downstream bit rate reported from the daemon. Value in bits per
              second.

                  default = 0

              Example: downstream_bitrate = 512000

       duration
              The default duration of port mappings, used  when  the  client  doesn't  specify  a
              duration.  Can have the following values:

                  0 - no default duration specified
                  seconds | HH:MM - duration from the time of addition
                  @seconds | @HH:MM - expire mapping at the specified time of day
                  default = 0

              Example: duration = 86400 # One day

       xml_document_path
              The path to the xml documents.  Do not include the trailing "/".

                  default = /etc/linuxigd

              Example: xml_document_path = /etc/linuxigd

       description_document_name
              The name of the igd device xml description document, underneath xml_document_path.

                  default = gatedesc.xml

              Example: description_document_name = gatedesc.xml

       listenport
              The UPnP port to listen on.

                  default = 0 (first free UPnP port, starting with 49152).

              Example: listenport = 0

       paranoid
              Paranoid forwarding setting.  Can have the following values:

                  0 - allow internal hosts to forward to any other (internal) host.
                  1-  only allow internal hosts to forward to themselves.
                  default = 0

              Example: paranoid = 1

SEE ALSO

       upnpd(8)

AUTHOR

       This manual page was written by Nick Leverton <nick@leverton.org> for the Debian GNU/Linux
       system (but may be used by others).

                                           May 4, 2008                              upnpd.conf(5)