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)