miniupnp/miniupnpc
Thomas Bernard fe37de7e2c Clean signal handling 2012-05-24 18:17:31 +02:00
..
java remove trailing whitespace from miniupnpc 2012-02-29 17:51:24 -08:00
man3 Added miniupnpc 2011-09-27 22:25:35 +02:00
msvc Added miniupnpc 2011-09-27 22:25:35 +02:00
.gitignore update ignore 2012-01-24 03:28:59 +04:00
CMakeLists.txt update version 2012-05-09 23:31:37 +02:00
Changelog.txt Fix signed/unsigned integer comparaisons 2012-05-01 20:53:19 +02: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 Cleanup settings of CFLAGS in Makefile 2012-05-01 20:49:43 +02:00
Makefile.mingw Added miniupnpc 2011-09-27 22:25:35 +02:00
README Try to update README and INSTALL files 2012-05-09 23:25:43 +02:00
VERSION Added miniupnpc 2011-09-27 22:25:35 +02:00
bsdqueue.h remove trailing whitespace from miniupnpc 2012-02-29 17:51:24 -08:00
codelength.h Added miniupnpc 2011-09-27 22:25:35 +02:00
connecthostport.c remove trailing whitespace from miniupnpc 2012-02-29 17:51:24 -08:00
connecthostport.h Added miniupnpc 2011-09-27 22:25:35 +02:00
declspec.h Replaced WIN32 macro by _WIN32 2012-01-21 14:38:38 +01: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 Added miniupnpc 2011-09-27 22:25:35 +02:00
mingw32make.bat Added miniupnpc 2011-09-27 22:25:35 +02:00
minihttptestserver.c Clean signal handling 2012-05-24 18:17:31 +02:00
minisoap.c Replaced WIN32 macro by _WIN32 2012-01-21 14:38:38 +01:00
minisoap.h Added miniupnpc 2011-09-27 22:25:35 +02:00
minissdpc.c remove trailing whitespace from miniupnpc 2012-02-29 17:51:24 -08:00
minissdpc.h Added miniupnpc 2011-09-27 22:25:35 +02:00
miniupnpc.c miniupnpc: disable HAS_IP_MREQN for Cygwin 2012-04-11 07:51:53 +02:00
miniupnpc.def Added miniupnpc 2011-09-27 22:25:35 +02:00
miniupnpc.h Only try to fetch XML description once in UPNP_GetValidIGD() 2012-04-10 00:10:52 +02:00
miniupnpcmodule.c remove trailing whitespace from miniupnpc 2012-02-29 17:51:24 -08:00
miniupnpcstrings.h.cmake Added miniupnpc 2011-09-27 22:25:35 +02:00
miniupnpcstrings.h.in Added miniupnpc 2011-09-27 22:25:35 +02:00
miniupnpctypes.h Added miniupnpc 2011-09-27 22:25:35 +02:00
miniwget.c removed unused argument url in minwget2() miniwget3() 2012-05-01 20:54:11 +02:00
miniwget.h Added miniupnpc 2011-09-27 22:25:35 +02:00
minixml.c remove trailing whitespace from miniupnpc 2012-02-29 17:51:24 -08:00
minixml.h Added miniupnpc 2011-09-27 22:25:35 +02:00
minixmlvalid.c Remove warning about unused argument 2012-05-01 20:55:13 +02:00
portlistingparse.c remove trailing whitespace from miniupnpc 2012-02-29 17:51:24 -08:00
portlistingparse.h remove trailing whitespace from miniupnpc 2012-02-29 17:51:24 -08:00
pymoduletest.py Added miniupnpc 2011-09-27 22:25:35 +02:00
receivedata.c remove trailing whitespace from miniupnpc 2012-02-29 17:51:24 -08:00
receivedata.h remove trailing whitespace from miniupnpc 2012-02-29 17:51:24 -08:00
setup.py Fixes setup.py to use the defined CFLAGS 2012-03-05 05:56:02 +01:00
setupmingw32.py Fixes setup.py to use the defined CFLAGS 2012-03-05 05:56:02 +01:00
testigddescparse.c remove trailing whitespace from miniupnpc 2012-02-29 17:51:24 -08:00
testminiwget.c Added miniupnpc 2011-09-27 22:25:35 +02:00
testminiwget.sh Added miniupnpc 2011-09-27 22:25:35 +02:00
testminixml.c remove trailing whitespace from miniupnpc 2012-02-29 17:51:24 -08:00
testupnpigd.py Added miniupnpc 2011-09-27 22:25:35 +02:00
testupnpreplyparse.c Added miniupnpc 2011-09-27 22:25:35 +02:00
updateminiupnpcstrings.sh Added miniupnpc 2011-09-27 22:25:35 +02:00
upnpc.c Fix crash if -A protocol argument is neither numeric, neither TCP or UDP 2012-05-08 23:05:21 +02:00
upnpcommands.c Added -ansi flag to compilation, and fixed C++ comments to ANSI C comments 2012-04-10 00:08:53 +02:00
upnpcommands.h remove trailing whitespace from miniupnpc 2012-02-29 17:51:24 -08:00
upnperrors.c upnperrors.c returns valid error string for unrecognized error codes 2012-03-12 16:50:27 -07:00
upnperrors.h remove trailing whitespace from miniupnpc 2012-02-29 17:51:24 -08:00
upnpreplyparse.c remove trailing whitespace from miniupnpc 2012-02-29 17:51:24 -08:00
upnpreplyparse.h remove trailing whitespace from miniupnpc 2012-02-29 17:51:24 -08: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/