transmission/third-party/miniupnp/README

67 lines
2.1 KiB
Plaintext
Raw Normal View History

2009-08-02 22:21:46 +00:00
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
2009-08-02 22:21:46 +00:00
Author: Thomas Bernard
Copyright (c) 2005-2012 Thomas Bernard
2009-08-02 22:21:46 +00:00
This software is subject to the conditions detailed in the
2010-02-25 12:39:22 +00:00
LICENSE file provided within this distribution.
2009-08-02 22:21:46 +00:00
2009-08-02 22:21:46 +00:00
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 *
2009-08-02 22:21:46 +00:00
2010-02-25 12:39:22 +00:00
To compile, simply run 'gmake' (could be 'make' on your system).
2009-08-02 22:21:46 +00:00
Under win32, to compile with MinGW, type "mingw32make.bat".
MS Visual C solution and project files are supplied in the msvc/ subdirectory.
2009-08-02 22:21:46 +00:00
The compilation is known to work under linux, FreeBSD,
2010-02-25 12:39:22 +00:00
OpenBSD, MacOS X, AmigaOS and cygwin.
The official AmigaOS4.1 SDK was used for AmigaOS4 and GeekGadgets for AmigaOS3.
2011-07-26 01:36:30 +00:00
upx (http://upx.sourceforge.net) is used to compress the win32 .exe files.
2010-02-25 12:39:22 +00:00
2009-08-02 22:21:46 +00:00
To install the library and headers on the system use :
> su
> make install
> exit
alternatively, to install into a specific location, use :
2009-08-02 22:21:46 +00:00
> INSTALLPREFIX=/usr/local make install
upnpc.c is a sample client using the libminiupnpc.
To use the libminiupnpc in your application, link it with
2010-02-25 12:39:22 +00:00
libminiupnpc.a (or .so) and use the following functions found in miniupnpc.h,
2009-08-02 22:21:46 +00:00
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.
2009-08-02 22:21:46 +00:00
* Python module *
you can build a python module with 'make pythonmodule'
2009-08-02 22:21:46 +00:00
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 !
2011-07-26 01:36:30 +00:00
For any question, you can use the web forum :
http://miniupnp.tuxfamily.org/forum/
2009-08-02 22:21:46 +00:00