freeswitch/libs/xmlrpc-c
Michael Jerris af9898658c configure runs through fine now, and allmost everything builds and runs again
git-svn-id: http://svn.freeswitch.org/svn/freeswitch/trunk@4552 d0543943-73ff-0310-b7d9-9358b9ac24b2
2007-03-11 14:36:33 +00:00
..
Windows add xmlrpc-c 1.03.14 to in tree libs 2006-12-21 03:57:49 +00:00
conf/abyss_root add xmlrpc-c 1.03.14 to in tree libs 2006-12-21 03:57:49 +00:00
debian add xmlrpc-c 1.03.14 to in tree libs 2006-12-21 03:57:49 +00:00
doc add xmlrpc-c 1.03.14 to in tree libs 2006-12-21 03:57:49 +00:00
examples add xmlrpc-c 1.03.14 to in tree libs 2006-12-21 03:57:49 +00:00
include add xmlrpc-c 1.03.14 to in tree libs 2006-12-21 03:57:49 +00:00
lib add xmlrpc-c 1.03.14 to in tree libs 2006-12-21 03:57:49 +00:00
src add xmlrpc-c 1.03.14 to in tree libs 2006-12-21 03:57:49 +00:00
tools add xmlrpc-c 1.03.14 to in tree libs 2006-12-21 03:57:49 +00:00
.cvsignore add xmlrpc-c 1.03.14 to in tree libs 2006-12-21 03:57:49 +00:00
GNUmakefile add xmlrpc-c 1.03.14 to in tree libs 2006-12-21 03:57:49 +00:00
Makefile add xmlrpc-c 1.03.14 to in tree libs 2006-12-21 03:57:49 +00:00
Makefile.common add xmlrpc-c 1.03.14 to in tree libs 2006-12-21 03:57:49 +00:00
Makefile.config.in add xmlrpc-c 1.03.14 to in tree libs 2006-12-21 03:57:49 +00:00
Makefile.depend add xmlrpc-c 1.03.14 to in tree libs 2006-12-21 03:57:49 +00:00
README add xmlrpc-c 1.03.14 to in tree libs 2006-12-21 03:57:49 +00:00
aclocal.m4 update in tree generated files. THe whole tree now cleanly bootstraps. 2007-03-11 12:30:24 +00:00
config.guess update in tree generated files. THe whole tree now cleanly bootstraps. 2007-03-11 12:30:24 +00:00
config.sub update in tree generated files. THe whole tree now cleanly bootstraps. 2007-03-11 12:30:24 +00:00
configure configure runs through fine now, and allmost everything builds and runs again 2007-03-11 14:36:33 +00:00
configure.gnu git-svn-id: http://svn.freeswitch.org/svn/freeswitch/trunk@4540 d0543943-73ff-0310-b7d9-9358b9ac24b2 2007-03-11 10:44:45 +00:00
configure.in don't conditionally run macros like that. it's bad. 2007-03-11 14:23:05 +00:00
install-sh add xmlrpc-c 1.03.14 to in tree libs 2006-12-21 03:57:49 +00:00
ltconfig add xmlrpc-c 1.03.14 to in tree libs 2006-12-21 03:57:49 +00:00
ltmain.sh update in tree generated files. THe whole tree now cleanly bootstraps. 2007-03-11 12:30:24 +00:00
missing add xmlrpc-c 1.03.14 to in tree libs 2006-12-21 03:57:49 +00:00
mkinstalldirs add xmlrpc-c 1.03.14 to in tree libs 2006-12-21 03:57:49 +00:00
stamp-h.in add xmlrpc-c 1.03.14 to in tree libs 2006-12-21 03:57:49 +00:00
version.h add xmlrpc-c 1.03.14 to in tree libs 2006-12-21 03:57:49 +00:00
xmlrpc-c-config.in add xmlrpc-c 1.03.14 to in tree libs 2006-12-21 03:57:49 +00:00
xmlrpc-c-config.test.in add xmlrpc-c 1.03.14 to in tree libs 2006-12-21 03:57:49 +00:00
xmlrpc_amconfig.h.in add xmlrpc-c 1.03.14 to in tree libs 2006-12-21 03:57:49 +00:00
xmlrpc_config.h.in add xmlrpc-c 1.03.14 to in tree libs 2006-12-21 03:57:49 +00:00

README

This is the source code for XML-RPC for C/C++, called Xmlrpc-c for short.

XML-RPC for C/C++ is programming libraries and related tools to help you
write an XML-RPC server or client in C or C++.

Documentation for the package is at

  http://xmlrpc-c.sourceforge.net/doc

See the Xmlrpc-c website at:

  http://xmlrpc-c.sourceforge.net/


PREREQUISITES
-------------

To build a useful Xmlrpc-c client library, you'll need to have at
least one HTTP library.  Xmlrpc-c knows how to use W3C Libwww (Version
5.3.2 or newer), Curl, and Wininet.  The configurator gives you the
option of building libraries that use any or all of these, and
defaults to every one you appear to have installed.  If you don't
appear to have any installed, the configurator causes the build to
omit client facilities altogether.

Information about W3C Libwww, including how to get it are at
<http://www.w3.org/Library>.

For Curl, see <http://curl.haxx.se>.

Wininet comes with Windows, and isn't available for any other platform.

You also need an XML parser/builder library.  An old version of Expat
is included in the package and used by default, so there's no actual
prerequisite here.  But if you separately obtain Libxml2, you can
configure the build to use that instead.  There's no really pressing
reason to do that, though.

Once you have the prerequisite libraries installed, you can issue
these commands:

  $ ./configure
  $ make
  $ make install

(There's supposed to be a 'make check' step in there too, to validate
that everything built OK, but it's broken right now - 2005.01.07).

To see it work, run a simple server like this:

  $ examples/xmlrpc_sample_add_server 8080

Then run a client that does an RPC to this server:

  $ examples/xmlrpc_sample_add_client

(I don't mean to imply that the above are consecutive shell commands;
They can't be, because the server program runs indefinitely).

Also try other sample servers and clients, described in examples/README.


You may want to pass a '--prefix' argument to 'configure'.  See
'./configure --help' for details.

You may also want to disable client XML transports that you won't be
using.  In particular, the Libwww transport can be inconvenient, because
it typically uses about 20 shared libraries.  Any XML-RPC client
program that uses Xmlrpc-c, whether or not the program uses any of the
libwww facilities, must attach all those libraries, and that can take
a significant amount of time.

See './configure --help' for the options that disable certain transports.



WINDOWS
-------

All of the above is essentially for Unix-type operating systems.  To
build and use Xmlrpc-c on Windows, see the file
Windows/ReadMeWin32.txt.


ADDITIONAL INFORMATION
----------------------

See the doc/ directory of the source tree for information about the
source code.  User documentation is on the web, as described above.