Table of Contents
Major releases and bug fixes of ulxmlrpcpp can be found in the download area of its homepage.
There is also the possibility to update from anonymous cvs to obtain the most recent sources.
In order to successfully compile ulxmlrpcpp, you need the
expat should already be contained in every
distribution. Otherwise you can download it from
In order to compile and install ulxmlrpcpp on your system, type the following in the base directory of the ulxmlrpcpp distribution:
There are some options for
configure you might be interested in:
By default ulxmlrpcpp uses standard 8bit wide strings (std::string
and const char* to be more precise). If you need basic support for
Unicode and it's 16bit or 32bit wide characters
you must add this parameter when invoking
By default ulxmlrpcpp uses calls to
select() to find out about
availability of data from a socket.
There are resource limitations on this call. On Linux systems with kernel 2.6 and later
you might want to enable the usage of
ulxmlrpcpp contains a simple helper class that uses logging features
taken from Log4J.
On startup you need to invoke
to initialize logging and afterwards every call to
ulxr::getLogger4J()->send(level, message) will send a debug
message encapsulated in an XML structure over the network to the local port 4448.
can be used as logging host to view the messages when an XMLSocketReceiver
The above option uses this logging feature to send the internal debugging
messages not to the console output but instead to a logging host. But for this
to take effect you also need to #define the various
and ULXR_SHOW_... macros in the according source files. To enable globally
you can enable the predefined macros in
To run the tests and examples type the following and change to the subdirectory "tests" afterwards:
You will find some validator applications and some client/server pairs.
which implement the test suite from
Since ulxmlrpcpp uses autoconf you should have not trouble compiling it. Should you run into problems please report them to the the author at ulxmlrpcpp at ewald-arnold dot de
Using the previous installation procedure has drawacks when you want do uninstall or upgrade to a newer version. Maybe you rather want to benefit from the common mechanism provided by rpm. Before installing the library this way you need to create rpm packages which requires some developer tools like doxygen or docbook and a bit of experience in this matter.
This can be done by running the following command in the top level directory of the source distribution:
After completion you will receive two rpm packages: one for the library and the
headers and one for the documentation. They are usually located at
In case you are using a Red Hat Fedora distribution you should better use
the optimized rpm file
If you are using a compiler on a platform not directly supported you must
set up your own project files for your compiler. All adjustments are done in
ulxmlrpcpp.h. To benefit from updates it
is of course better to move your own settings to a configuration file and
config-bcb5.h as an example
for Borland's CBuilder.
|Once you have ported ulxmlrpcpp to a new platform:|
Please send me your files for inclusion in the next distribution. You will certainly make some people happy with this.