upnpd.conf(5) File Formats Manual upnpd.conf(5)
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 for-
ward chain, so that they apply before any drop or reject rules later in the chain. This option only applies if "create_for-
ward_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 for-
wardUPnP 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)