---
name: "miniupnpc"
section: "3"
platform: "linux"
package: "miniupnpc"
version: "2.3.3-3"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/miniupnpc"
---

# miniupnpc(3)

UPnP client library

## NAME

miniupnpc - UPnP client library

## SYNOPSIS

## DESCRIPTION

The miniupnpc library implement the UPnP protocol defined to dialog with Internet Gateway Devices. It also has the ability to use data gathered by [minissdpd(1)](/minissdpd/1.md) about UPnP devices up on the network in order to skip the long UPnP device discovery process.

At first, upnpDiscover(3) has to be used to discover UPnP IGD present on the network. Then UPNP\_GetValidIGD(3) to select the right one. Alternatively, UPNP\_GetIGDFromUrl(3) could be used to bypass discovery process if the root description url of the device to use is known. Then all the UPNP\_\* functions can be used, such as UPNP\_GetConnectionTypeInfo(3), UPNP\_AddPortMapping(3), etc...

## HEADER FILES

- miniupnpc.h

  That's the main header file for the miniupnpc library API. It contains all the functions and structures related to device discovery.

- upnpcommands.h

  This header file contain the UPnP IGD methods that are accessible through the miniupnpc API. The name of the C functions are matching the UPnP methods names. ie: GetGenericPortMappingEntry is UPNP\_GetGenericPortMappingEntry.

## API FUNCTIONS

- struct UPNPDev \* upnpDiscover(int delay, const char \* multicastif, const char \* minissdpdsock, int localport, int ipv6, int \* error);

  execute the discovery process. delay (in millisecond) is the maximum time for waiting any device response. If available, device list will be obtained from MiniSSDPd. Default path for minissdpd socket will be used if minissdpdsock argument is NULL. If multicastif is not NULL, it will be used instead of the default multicast interface for sending SSDP discover packets. If localport is set to UPNP\_LOCAL\_PORT\_SAME(1) SSDP packets will be sent  from the source port 1900 (same as destination port), if set to  UPNP\_LOCAL\_PORT\_ANY(0) system assign a source port, any other value will  be attempted as the source port. If ipv6 is not 0, IPv6 is used instead of IPv4 for the discovery process.

- void freeUPNPDevlist(struct UPNPDev \* devlist);

  free the list returned by upnpDiscover().

- int UPNP\_GetValidIGD(struct UPNPDev \* devlist, struct UPNPUrls \* urls, struct IGDdatas \* data, char \* lanaddr, int lanaddrlen, char \* wanaddr, int wanaddrlen);

  browse the list of device returned by upnpDiscover(), find a live UPnP internet gateway device and fill structures passed as arguments with data used for UPNP methods invocation.

- int UPNP\_GetIGDFromUrl(const char \* rootdescurl, struct UPNPUrls \* urls, struct IGDdatas \* data, char \* lanaddr, int lanaddrlen);

  permit one to bypass the upnpDiscover() call if the xml root description URL of the UPnP IGD is known. Fill structures passed as arguments with data used for UPNP methods invocation.

- void GetUPNPUrls(struct UPNPUrls \*, struct IGDdatas \*, const char \*);

  - void FreeUPNPUrls(struct UPNPUrls \*);

  ## SEE ALSO

[minissdpd(1)](/minissdpd/1.md)

## BUGS