Chapter 1. How to use this library

Table of Contents

1.1. Introduction
1.2. Basic Variable Types
1.3. Communicating via XML-RPC
1.3.1. The Server
1.3.2. The Client
1.3.3. Asynchronous Communication
1.4. Talking HTTP
1.4.1. The Server
1.4.2. The Client
1.4.3. Processing HTML Requests
1.4.4. HTTP Handlers
1.4.5. Cached Resources
1.4.6. Processing HTML Data
1.5. Securing Network Transmissions
1.6. Multi-Processing XML-RPC
1.6.1. The Multi-Threaded Server
1.6.2. The Multi-Processing Server
1.6.3. The Client
1.7. Multithreaded HTTP server
1.8. Behaviour of TCP/IP Connections
1.8.1. Disabling Buffer Mechanism
1.8.2. Shutting a Socket Down
1.8.3. Abort on Close
1.9. Secure Connections via SSL/TLS
1.10. Tracking Partners With Cookies
1.10.1. Cookies in Server Mode
1.10.2. Cookies in Client Mode
1.11. Connections Via a Proxy Server
1.11.1. Transparently Using a Proxy Server
1.11.2. A SSL Connection over a Proxy Server
1.12. Transfer Encoding via HTTP
1.12.1. Chunked Encoding
1.13. Using the XML Parser
1.14. Using the WAP Binary XML Parser
1.14.1. What is WAP Binary XML?
1.14.2. Creating a WAP Binary XML parser
1.15. Worth to Know About UNICODE

1.1. Introduction

This chapter explains how to use this library. To learn more about the details please read the api documentation which you can either download from the homepage or generate yourself if you have doxygen installed. To generate it yourself run make doc in the top level directory of the source distribution.

Please also try the example files in the subdirectory tests which are compiled with make check. Some files run as standalone tests. But the most important files come as client and server pairs. Each of these pairs tests one or more aspects of the library. The most important pair regarding XML-RPC is val1_server and val1_client. There are also several options to turn special features on.