bionic (5) upnpd.conf.5.gz

Provided by: linux-igd_1.0+cvs20070630-6_amd64 bug

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)