xmlrpc_transport.html 2.9 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495
  1. <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2//EN">
  2. <title>Xmlrpc_transport User Manual</title>
  3. <body>
  4. <p><b>xmlrpc_transport</b> transports data to a server as if to make an
  5. XML-RPC remote procedure call and displays the response from the server.
  6. <p>You supply the call in XML form on Standard Input and get the response
  7. in XML form on Standard Output. <b>xmlrpc_transport</b> doesn't really know
  8. anything about XML; it sends the characters you supply and displays the
  9. characters it gets back.
  10. <p><b>xmlrpc_transport</b> uses the lower levels of the XML-RPC For C/C++
  11. client libraries.
  12. <p>This program is mainly useful for debugging and learning about
  13. XML-RPC servers and the XML-RPC For C/C++ client XML transports.
  14. <h2>Examples</h2>
  15. &lt;
  16. <pre>
  17. <tt>
  18. $ xmlrpc_transport http://localhost:8080/RPC2 &lt;&lt;-EOF
  19. &lt;?xml version="1.0" encoding="UTF-8"?&gt;
  20. &lt;methodCall&gt;
  21. &lt;methodName&gt;sample.add&lt;/methodName&gt;
  22. &lt;params&gt;
  23. &lt;param&gt;&lt;value&gt;&lt;i4&gt;5&lt;/i4&gt;&lt;/value&gt;&lt;/param&gt;
  24. &lt;param&gt;&lt;value&gt;&lt;i4&gt;7&lt;/i4&gt;&lt;/value&gt;&lt;/param&gt;
  25. &lt;/params&gt;
  26. &lt;/methodCall&gt;
  27. EOF
  28. &lt;?xml version="1.0" encoding="UTF-8"?&gt;
  29. &lt;methodResponse&gt;
  30. &lt;params&gt;
  31. &lt;param&gt;&lt;value&gt;&lt;i4&gt;12&lt;/i4&gt;&lt;/value&gt;&lt;/param&gt;
  32. &lt;/params&gt;
  33. &lt;/methodResponse&gt;
  34. </tt>
  35. </pre>
  36. <h2>Overview</h2>
  37. <p>
  38. <b>xmlrpc_transport</b>
  39. <i>url</i>
  40. [<b>-transport=</b><i>transportname</i>]
  41. [<b>-username=</b><i>username</i> <b>-password=</b><i>password</i>]
  42. <P>Minimum unique abbreviation of option is acceptable. You may use double
  43. hyphens instead of single hyphen to denote options. You may use white
  44. space in place of the equals sign to separate an option name from its value.
  45. <h2>Arguments</h2>
  46. <dl>
  47. <dt><i>url</i>
  48. <dd>This is the URL of the XML-RPC server. As XML-RPC uses HTTP, this
  49. must be an HTTP url. However, if you don't specify a type (&quot;http:&quot;)
  50. in the URL, <b>xmlrpc_transport</b> assumes an &quot;http://&quot; prefix and a
  51. &quot;/RPC2&quot; suffix. <b>RPC2</b> is the conventional file name for
  52. an XML-RPC responder.
  53. </dl>
  54. <h2>Options</h2>
  55. <dl>
  56. <dt><b>-transport=</b><i>transportname</i>
  57. <dd>This selects the XML transport facility (e.g. libwww) that
  58. <b>xmlrpc_transport</b> uses to perform the RPC.
  59. <p>The name <i>transportname</i> is one that the Xmlrpc-c programming
  60. library recognizes. This is typically <b>libwww</b>, <b>curl</b>, and
  61. <b>wininet</b>.
  62. <p>By default, <b>xmlrpc_transport</b> lets the Xmlrpc-c library choose.
  63. <dt><b>-username=</b><i>username</i>
  64. <dt><b>-password=</b><i>password</i>
  65. <dd>These options, which must be used together, cause the client to
  66. authenticate itself to the server, if the server requires it, using
  67. HTTP Basic Authentication and the specified username and password.
  68. </dl>
  69. </body>