Return to README CVS log

Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / miniupnpd / miniupnpc

Annotation of embedaddon/miniupnpd/miniupnpc/README, revision 1.1.1.1

1.1       misho       1: Project: miniupnp
                      2: Project web page: http://miniupnp.free.fr/ or https://miniupnp.tuxfamily.org/
                      3: github: https://github.com/miniupnp/miniupnp
                      4: Author: Thomas Bernard
                      5: Copyright (c) 2005-2023 Thomas Bernard
                      6: This software is subject to the conditions detailed in the
                      7: LICENSE file provided within this distribution.
                      8: 
                      9: 
                     10: * miniUPnP Client - miniUPnPc *
                     11: 
                     12: To compile, simply run 'gmake' (could be 'make' on your system).
                     13: Under win32, to compile with MinGW, type "mingw32make.bat".
                     14: MS Visual C solution and project files are supplied in the msvc/ subdirectory.
                     15: The miniupnpc library is available as a static library or as a DLL :
                     16: define MINIUPNP_STATICLIB if you want to link against the static library.
                     17: 
                     18: The compilation is known to work under linux, FreeBSD,
                     19: OpenBSD, MacOS X, AmigaOS and cygwin.
                     20: The official AmigaOS4.1 SDK was used for AmigaOS4 and GeekGadgets for AmigaOS3.
                     21: upx (http://upx.sourceforge.net) is used to compress the win32 .exe files.
                     22: 
                     23: To install the library and headers on the system use :
                     24: > su
                     25: > make install
                     26: > exit
                     27: 
                     28: alternatively, to install into a specific location, use :
                     29: > INSTALLPREFIX=/usr/local make install
                     30: 
                     31: upnpc.c is a sample client using the libminiupnpc.
                     32: To use the libminiupnpc in your application, link it with
                     33: libminiupnpc.a (or .so) and use the following functions found in miniupnpc.h,
                     34: upnpcommands.h and miniwget.h :
                     35: - upnpDiscover()
                     36: - UPNP_GetValidIGD()
                     37: - miniwget()
                     38: - parserootdesc()
                     39: - GetUPNPUrls()
                     40: - UPNP_* (calling UPNP methods)
                     41: 
                     42: Note : use #include <miniupnpc/miniupnpc.h> etc... for the includes
                     43: and -lminiupnpc for the link
                     44: 
                     45: Discovery process is speeded up when MiniSSDPd is running on the machine.
                     46: 
                     47: 
                     48: * Python module *
                     49: 
                     50: you can build a python module with 'make pythonmodule'
                     51: and install it with 'make installpythonmodule'.
                     52: setup.py (and setupmingw32.py) are included in the distribution.
                     53: 
                     54: 
                     55: Feel free to contact me if you have any problem :
                     56: e-mail : miniupnp@free.fr
                     57: 
                     58: If you are using libminiupnpc in your application, please
                     59: send me an email !
                     60: 
                     61: For any question, you can use the web forum :
                     62: https://miniupnp.tuxfamily.org/forum/
                     63: 
                     64: Bugs should be reported on GitHub :
                     65: https://github.com/miniupnp/miniupnp/issues
                     66: 
                     67: * Linux firewall configuration for UPnP clients *
                     68: 
                     69: Due to how UPnP protocol is designed, unicast responses to UPnP multicast client
                     70: requests are not tracked by Linux netfilter. And therefore netfilter executes
                     71: default action for them (which is in most cases DROP response packet).
                     72: 
                     73: To workaround this limitation, custom ipset hash table can be used. It is
                     74: supported since Linux kernel >= 2.6.39.
                     75: 
                     76: Rules for IPv4:
                     77: $ ipset create upnp hash:ip,port timeout 3
                     78: $ iptables -A OUTPUT -d 239.255.255.250/32 -p udp -m udp --dport 1900 -j SET --add-set upnp src,src --exist
                     79: $ iptables -A INPUT -p udp -m set --match-set upnp dst,dst -j ACCEPT
                     80: $ iptables -A INPUT -d 239.255.255.250/32 -p udp -m udp --dport 1900 -j ACCEPT
                     81: 
                     82: Rules for IPv6:
                     83: $ ipset create upnp6 hash:ip,port timeout 3 family inet6
                     84: $ ip6tables -A OUTPUT -d ff02::c/128 -p udp -m udp --dport 1900 -j SET --add-set upnp6 src,src --exist
                     85: $ ip6tables -A OUTPUT -d ff05::c/128 -p udp -m udp --dport 1900 -j SET --add-set upnp6 src,src --exist
                     86: $ ip6tables -A INPUT -p udp -m set --match-set upnp6 dst,dst -j ACCEPT
                     87: $ ip6tables -A INPUT -d ff02::c/128 -p udp -m udp --dport 1900 -j ACCEPT
                     88: $ ip6tables -A INPUT -d ff05::c/128 -p udp -m udp --dport 1900 -j ACCEPT
                     89: 
                     90: Detailed description is available on:
                     91: https://serverfault.com/a/911286
                     92: https://unix.stackexchange.com/a/444804