transmission/third-party/miniupnp
Charles Kerr 743ef2a3c6 (trunk) #2795 "non-GUI compilation issues on OS X 10.4" -- fixed for 1.90 2010-01-29 19:11:56 +00:00
..
Changelog.txt update to miniupnpc-20091010 2009-10-11 01:32:58 +00:00
LICENCE
Makefile.am (trunk third-party) ensure that dht, miniupnp, and libnatpmp are compiled with @PTHREAD_CFLAGS@ on Solaris for thread safety. 2010-01-15 14:54:01 +00:00
README update miniupnpc to miniupnpc-20090729 2009-08-02 22:21:46 +00:00
bsdqueue.h
codelength.h
declspec.h
igd_desc_parse.c
igd_desc_parse.h
minisoap.c
minisoap.h
minissdpc.c update miniupnp to 20090921 2009-09-24 12:17:28 +00:00
minissdpc.h
miniupnpc.c update to miniupnpc-20091010 2009-10-11 01:32:58 +00:00
miniupnpc.h update to miniupnpc-20091010 2009-10-11 01:32:58 +00:00
miniupnpcstrings.h.in finish #2273 and probably break non-Mac builds in the process 2009-07-14 00:13:10 +00:00
miniwget.c update to miniupnpc-20091010 2009-10-11 01:32:58 +00:00
miniwget.h
minixml.c update to miniupnpc-20091010 2009-10-11 01:32:58 +00:00
minixml.h
updateminiupnpcstrings.sh (trunk) #2795 "non-GUI compilation issues on OS X 10.4" -- fixed for 1.90 2010-01-29 19:11:56 +00:00
upnpcommands.c (trunk third-party) #2273: update to latest libnatpmp and miniupnpc libraries 2009-07-13 16:00:21 +00:00
upnpcommands.h
upnpreplyparse.c
upnpreplyparse.h (trunk third-party) #2273: update to latest libnatpmp and miniupnpc libraries 2009-07-13 16:00:21 +00:00

README

Project: miniupnp
Project web page: http://miniupnp.free.fr/ or http://miniupnp.tuxfamily.org/
Author: Thomas Bernard
Copyright (c) 2005-2008 Thomas Bernard
This software is subject to the conditions detailed in the
LICENCE 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 *

To compile, simply run 'gmake' (could be 'make').
Under win32, to compile with MinGW, type "mingw32make.bat".
The compilation is known to work under linux, FreeBSD,
OpenBSD, MacOS X and cygwin.
To install the library and headers on the system use :
> su
> make install
> exit

alternatively, to install in 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 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 !