git.maemo.org Git - xmlrpc-c/blob - examples/README

   1 This directory contains working examples of uses of XML-RPC-c.  There
   2 are XML-RPC servers and XML-RPC clients that use the Xmlrpc-c libraries.
   3
   4 The simplest example is the 'query-meerkat' program, which contacts an
   5 XML-RPC server that O'Reilly operates on the Internet called Meerkat.
   6 Meerkat provides an RPC that returns a list of new articles that match
   7 a specified search pattern.  Run 'query-meerkat' like this example:
   8
   9   $ ./query-meerkat Linux
  10
  11 This responds with a list of new articles that contain the work "Linux",
  12 according to O'reilly's Meerkat service.
  13
  14
  15 The simplest server program is 'xmlrpc_sample_add_server'.  This
  16 implements a single XML-RPC method called 'sample.add'.  All it does is
  17 add two numbers and return the sum.  You can run such a server like
  18 this:
  19
  20   $ ./xmlrpc_sample_add_server 8080
  21
  22 The server this runs is based on the Abyss HTTP server.  file.  The
  23 argument tell it to listen on TCP Port 8080 for RPCs.  It puts log
  24 information in /tmp, so be sure to look there.
  25
  26 A client program that goes along with this server is
  27 'xmlrpc_sample_add_client'.  All this client does is make an XML-RPC
  28 request to Port 8080 of 'localhost' to add the numbers 5 and 7 and
  29 print the result on Standard Output.
  30
  31 You can run such a client like this:
  32
  33   $ ./xmlrpc_sample_add_client
  34