Name Size Rev. Time Author Log Message
CMakeLists.txt 9.26 k 209eabf34a22 2021-12-12 20:55:18 simphone miniupnpc 2.2.3
Changelog.txt 18.17 k 209eabf34a22 2021-12-12 20:55:18 simphone miniupnpc 2.2.3
LICENSE 1.45 k 209eabf34a22 2021-12-12 20:55:18 simphone miniupnpc 2.2.3
MANIFEST.in 178 209eabf34a22 2021-12-12 20:55:18 simphone miniupnpc 2.2.3
Makefile 11.64 k 084fe5a27770 2021-12-12 23:52:13 simphone merged and patched libraries to release
Makefile.mingw 4.69 k 209eabf34a22 2021-12-12 20:55:18 simphone miniupnpc 2.2.3
README 3.38 k 209eabf34a22 2021-12-12 20:55:18 simphone miniupnpc 2.2.3
VERSION 6 209eabf34a22 2021-12-12 20:55:18 simphone miniupnpc 2.2.3
apiversions.txt 4.95 k 26e8c1975a28 2020-07-04 19:12:25 simphone miniupnpc 2.1
external-ip.sh 161 26e8c1975a28 2020-07-04 19:12:25 simphone miniupnpc 2.1
include 084fe5a27770 2021-12-12 23:52:13 simphone merged and patched libraries to release
java 26e8c1975a28 2020-07-04 19:12:25 simphone miniupnpc 2.1
man3 26e8c1975a28 2020-07-04 19:12:25 simphone miniupnpc 2.1
mingw32make.bat 212 26e8c1975a28 2020-07-04 19:12:25 simphone miniupnpc 2.1
miniupnpc-config.cmake 306 209eabf34a22 2021-12-12 20:55:18 simphone miniupnpc 2.2.3
miniupnpc.def 1.02 k 209eabf34a22 2021-12-12 20:55:18 simphone miniupnpc 2.2.3
miniupnpc.rc 1.15 k 209eabf34a22 2021-12-12 20:55:18 simphone miniupnpc 2.2.3
miniupnpcstrings.h.cmake 376 26e8c1975a28 2020-07-04 19:12:25 simphone miniupnpc 2.1
miniupnpcstrings.h.in 693 26e8c1975a28 2020-07-04 19:12:25 simphone miniupnpc 2.1
msvc 209eabf34a22 2021-12-12 20:55:18 simphone miniupnpc 2.2.3
pymoduletest.py 2.72 k 209eabf34a22 2021-12-12 20:55:18 simphone miniupnpc 2.2.3
setup.py 1.12 k 209eabf34a22 2021-12-12 20:55:18 simphone miniupnpc 2.2.3
setupmingw32.py 1.19 k 209eabf34a22 2021-12-12 20:55:18 simphone miniupnpc 2.2.3
src 084fe5a27770 2021-12-12 23:52:13 simphone merged and patched libraries to release
testdesc 26e8c1975a28 2020-07-04 19:12:25 simphone miniupnpc 2.1
testminiwget.sh 2.86 k 209eabf34a22 2021-12-12 20:55:18 simphone miniupnpc 2.2.3
testreplyparse 26e8c1975a28 2020-07-04 19:12:25 simphone miniupnpc 2.1
testupnpigd.py 2.43 k 209eabf34a22 2021-12-12 20:55:18 simphone miniupnpc 2.2.3
testupnpreplyparse.sh 254 209eabf34a22 2021-12-12 20:55:18 simphone miniupnpc 2.2.3
updateminiupnpcstrings.sh 1.64 k 209eabf34a22 2021-12-12 20:55:18 simphone miniupnpc 2.2.3
wingenminiupnpcstrings.c 4.06 k 084fe5a27770 2021-12-12 23:52:13 simphone merged and patched libraries to release

README

Project: miniupnp
Project web page: http://miniupnp.free.fr/ or https://miniupnp.tuxfamily.org/
github: https://github.com/miniupnp/miniupnp
Author: Thomas Bernard
Copyright (c) 2005-2021 Thomas Bernard
This software is subject to the conditions detailed in the
LICENSE file provided within this distribution.


* miniUPnP Client - miniUPnPc *

To compile, simply run 'gmake' (could be 'make' on your system).
Under win32, to compile with MinGW, type "mingw32make.bat".
MS Visual C solution and project files are supplied in the msvc/ subdirectory.
The miniupnpc library is available as a static library or as a DLL :
define MINIUPNP_STATICLIB if you want to link against the static library.

The compilation is known to work under linux, FreeBSD,
OpenBSD, MacOS X, AmigaOS and cygwin.
The official AmigaOS4.1 SDK was used for AmigaOS4 and GeekGadgets for AmigaOS3.
upx (http://upx.sourceforge.net) is used to compress the win32 .exe files.

To install the library and headers on the system use :
> su
> make install
> exit

alternatively, to install into a specific location, use :
> INSTALLPREFIX=/usr/local make install

upnpc.c is a sample client using the libminiupnpc.
To use the libminiupnpc in your application, link it with
libminiupnpc.a (or .so) and use the following functions found in miniupnpc.h,
upnpcommands.h and miniwget.h :
- upnpDiscover()
- UPNP_GetValidIGD()
- miniwget()
- parserootdesc()
- GetUPNPUrls()
- UPNP_* (calling UPNP methods)

Note : use #include <miniupnpc/miniupnpc.h> etc... for the includes
and -lminiupnpc for the link

Discovery process is speeded up when MiniSSDPd is running on the machine.


* Python module *

you can build a python module with 'make pythonmodule'
and install it with 'make installpythonmodule'.
setup.py (and setupmingw32.py) are included in the distribution.


Feel free to contact me if you have any problem :
e-mail : miniupnp@free.fr

If you are using libminiupnpc in your application, please
send me an email !

For any question, you can use the web forum :
https://miniupnp.tuxfamily.org/forum/

Bugs should be reported on github :
https://github.com/miniupnp/miniupnp/issues

* Linux firewall configuration for UPnP clients *

Due to how UPnP protocol is designed, unicast responses to UPnP multicast client
requests are not tracked by Linux netfilter. And therefore netfilter executes
default action for them (which is in most cases DROP response packet).

To workaround this limitation, custom ipset hash table can be used. It is
supported since Linux kernel >= 2.6.39.

Rules for IPv4:
$ ipset create upnp hash:ip,port timeout 3
$ iptables -A OUTPUT -d 239.255.255.250/32 -p udp -m udp --dport 1900 -j SET --add-set upnp src,src --exist
$ iptables -A INPUT -p udp -m set --match-set upnp dst,dst -j ACCEPT
$ iptables -A INPUT -d 239.255.255.250/32 -p udp -m udp --dport 1900 -j ACCEPT

Rules for IPv6:
$ ipset create upnp6 hash:ip,port timeout 3 family inet6
$ ip6tables -A OUTPUT -d ff02::c/128 -p udp -m udp --dport 1900 -j SET --add-set upnp6 src,src --exist
$ ip6tables -A OUTPUT -d ff05::c/128 -p udp -m udp --dport 1900 -j SET --add-set upnp6 src,src --exist
$ ip6tables -A INPUT -p udp -m set --match-set upnp6 dst,dst -j ACCEPT
$ ip6tables -A INPUT -d ff02::c/128 -p udp -m udp --dport 1900 -j ACCEPT
$ ip6tables -A INPUT -d ff05::c/128 -p udp -m udp --dport 1900 -j ACCEPT

Detailed description is available on:
https://serverfault.com/a/911286
https://unix.stackexchange.com/a/444804
Show on old repository browser