Man Linux: Main Page and Category List

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)