miniupnp/miniupnpc
Thomas Bernard 3ae6b969a3 testminiwget.sh: fix comment (it now works with dash) 2013-12-09 09:31:04 +01:00
..
java Make miniupnpc jar file build on win32 2013-01-27 22:41:33 +01:00
man3 to upper case 2013-02-09 16:32:57 +01:00
msvc Added miniupnpc 2011-09-27 22:25:35 +02:00
testreplyparse update upnpreplyparse to allow larger values (128 chars instead of 64) 2013-06-06 23:41:23 +02:00
.gitignore miniupnpc: validate upnpreplyparse.c code with "make check" 2013-05-14 23:09:42 +02:00
CMakeLists.txt miniupnpc: increment API_VERSION to 9 2012-06-24 00:49:09 +02:00
Changelog.txt miniupnpc.c: UPNP_GetValidIGD() now checks for ExternalIpAddress 2013-12-09 09:31:04 +01:00
LICENSE remove trailing whitespace from miniupnpc 2012-02-29 17:51:24 -08:00
MANIFEST.in Added miniupnpc 2011-09-27 22:25:35 +02:00
Makefile miniupnpc: validate upnpreplyparse.c code with "make check" 2013-05-14 23:09:42 +02:00
Makefile.mingw miniupnpc: prepare version 1.8 ! 2013-02-06 14:57:49 +01:00
README Try to update README and INSTALL files 2012-05-09 23:25:43 +02:00
VERSION miniupnpc: prepare version 1.8 ! 2013-02-06 14:57:49 +01:00
apiversions.txt added miniupnpc/apiversions.txt 2013-03-29 15:46:25 +01:00
bsdqueue.h remove trailing whitespace from miniupnpc 2012-02-29 17:51:24 -08:00
codelength.h Rename all include guards to not clash with C99 (7.1.3 Reserved identifiers). 2012-09-20 17:52:51 -03:00
connecthostport.c miniupnpc: define MAXHOSTNAMELEN if not already done 2013-12-09 09:31:04 +01:00
connecthostport.h Rename all include guards to not clash with C99 (7.1.3 Reserved identifiers). 2012-09-20 17:52:51 -03:00
declspec.h Rename all include guards to not clash with C99 (7.1.3 Reserved identifiers). 2012-09-20 17:52:51 -03:00
external-ip.sh Added miniupnpc 2011-09-27 22:25:35 +02:00
igd_desc_parse.c Added miniupnpc 2011-09-27 22:25:35 +02:00
igd_desc_parse.h Fix include guards that were missed in 95d5c0bf39. 2012-10-09 19:00:31 -03:00
mingw32make.bat Added miniupnpc 2011-09-27 22:25:35 +02:00
minihttptestserver.c miniupnpc: Improvements in testminiwget.sh 2012-06-20 23:11:36 +02:00
minisoap.c Replaced WIN32 macro by _WIN32 2012-01-21 14:38:38 +01:00
minisoap.h Rename all include guards to not clash with C99 (7.1.3 Reserved identifiers). 2012-09-20 17:52:51 -03:00
minissdpc.c remove trailing whitespace from miniupnpc 2012-02-29 17:51:24 -08:00
minissdpc.h Rename all include guards to not clash with C99 (7.1.3 Reserved identifiers). 2012-09-20 17:52:51 -03:00
miniupnpc.c miniupnpc.c: UPNP_GetValidIGD() now checks for ExternalIpAddress 2013-12-09 09:31:04 +01:00
miniupnpc.def Added miniupnpc 2011-09-27 22:25:35 +02:00
miniupnpc.h miniupnpc.h changed version to 1.8 2013-02-06 15:50:37 +01:00
miniupnpcmodule.c miniupnpc: Supports Python 3 2012-08-28 21:25:00 -04:00
miniupnpcstrings.h.cmake Fix include guards that were missed in 95d5c0bf39. 2012-10-09 19:00:31 -03:00
miniupnpcstrings.h.in Fix include guards that were missed in 95d5c0bf39. 2012-10-09 19:00:31 -03:00
miniupnpctypes.h Rename all include guards to not clash with C99 (7.1.3 Reserved identifiers). 2012-09-20 17:52:51 -03:00
miniwget.c miniwget.c: fixed potential buffer overrun 2013-12-09 09:31:04 +01:00
miniwget.h Rename all include guards to not clash with C99 (7.1.3 Reserved identifiers). 2012-09-20 17:52:51 -03:00
minixml.c remove trailing whitespace from miniupnpc 2012-02-29 17:51:24 -08:00
minixml.h Rename all include guards to not clash with C99 (7.1.3 Reserved identifiers). 2012-09-20 17:52:51 -03:00
minixmlvalid.c Remove warning about unused argument 2012-05-01 20:55:13 +02:00
portlistingparse.c miniupnpc/portlistingparse.c: removed a unused argument warning 2012-06-20 23:11:59 +02:00
portlistingparse.h Rename all include guards to not clash with C99 (7.1.3 Reserved identifiers). 2012-09-20 17:52:51 -03:00
pymoduletest.py Added miniupnpc 2011-09-27 22:25:35 +02:00
receivedata.c #define MINIUPNPC_GET_SRC_ADDR enables receivedata() to get scope_id 2012-06-24 00:52:51 +02:00
receivedata.h Rename all include guards to not clash with C99 (7.1.3 Reserved identifiers). 2012-09-20 17:52:51 -03:00
setup.py Prepare release of version 1.7 of both miniupnpc and miniupnpd 2012-05-24 18:26:39 +02:00
setupmingw32.py Prepare release of version 1.7 of both miniupnpc and miniupnpd 2012-05-24 18:26:39 +02:00
testigddescparse.c miniupnpc: GetUPNPUrls() now inserts scope into link-local IPv6 addresses 2012-06-28 21:05:50 +02:00
testminiwget.c miniupnpc: parseURL()/miniwget() : IPv6 addresses scope 2012-06-24 00:55:31 +02:00
testminiwget.sh testminiwget.sh: fix comment (it now works with dash) 2013-12-09 09:31:04 +01:00
testminixml.c testminixml.c: remove warnings 2013-05-14 23:10:06 +02:00
testupnpigd.py Added miniupnpc 2011-09-27 22:25:35 +02:00
testupnpreplyparse.c miniupnpc: validate upnpreplyparse.c code with "make check" 2013-05-14 23:09:42 +02:00
testupnpreplyparse.sh miniupnpc: validate upnpreplyparse.c code with "make check" 2013-05-14 23:09:42 +02:00
updateminiupnpcstrings.sh Added miniupnpc 2011-09-27 22:25:35 +02:00
upnpc.c miniupnpc: prepare version 1.8 ! 2013-02-06 14:57:49 +01:00
upnpcommands.c minor things 2012-06-24 00:56:24 +02:00
upnpcommands.h Rename all include guards to not clash with C99 (7.1.3 Reserved identifiers). 2012-09-20 17:52:51 -03:00
upnperrors.c upnperrors.c returns valid error string for unrecognized error codes 2012-03-12 16:50:27 -07:00
upnperrors.h Rename all include guards to not clash with C99 (7.1.3 Reserved identifiers). 2012-09-20 17:52:51 -03:00
upnpreplyparse.c update upnpreplyparse to allow larger values (128 chars instead of 64) 2013-06-06 23:41:23 +02:00
upnpreplyparse.h update upnpreplyparse to allow larger values (128 chars instead of 64) 2013-06-06 23:41:23 +02:00
wingenminiupnpcstrings.c remove trailing whitespace from miniupnpc 2012-02-29 17:51:24 -08:00

README

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


For the comfort of Win32 users, bsdqueue.h is included in the distribution.
Its licence is included in the header of the file.
bsdqueue.h is a copy of the sys/queue.h of an OpenBSD system.


* 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 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()
- 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 :
http://miniupnp.tuxfamily.org/forum/