Reference Manual

NAME

upnpc - interact with an external UPnP Internet Gateway Device

upnpc -a ip port external_port tcp | udp # Add port mapping
upnpc -d external_port tcp | udp         # Delete port mapping
upnpc -e                                 # External IP address
upnpc -i                                 # Initialize device list
upnpc -s                                 # Status
upnpc -l                                 # List port mappings
upnpc -r port1 tcp | udp [...]           # Map these ports to this host

The upnpc command sends control and status requests to external UPnP-enabled Internet Gateway Devices.

Argument -a adds the specified port mapping to the device's Port Forwarding Table.

Argument -d removes the specified port mapping from the device's Port Forwarding Table.

Argument -e prints the device's current external IP address.

Argument -i prints the device's current external IP address.

Argument -s prints current status details of the device.

Argument -l prints current status details and mappings of the device.

Argument -r maps the specified ports to the Windows IP address of this computer.

The UPnP Protocol does not allow port mappings other than those that were added via UPnP itself to be manipulated.

Some IGD's require that an administrator first enable full UPnP support before mappings can be added or deleted. Some even have all UPnP support disabled per default.

The NAT32 UPnP code is based on code kindly supplied by Thomas Bernard's MiniUPNP Project. It does not require any UPnP or XML capabilities of the Operating System on which it runs. The code will therefore work correctly on all Windows platforms (even 9X and Vista).

upnpd