96 lines
2.9 KiB
HTML
96 lines
2.9 KiB
HTML
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2//EN">
|
|
<title>Xmlrpc_transport User Manual</title>
|
|
<body>
|
|
|
|
<p><b>xmlrpc_transport</b> transports data to a server as if to make an
|
|
XML-RPC remote procedure call and displays the response from the server.
|
|
|
|
<p>You supply the call in XML form on Standard Input and get the response
|
|
in XML form on Standard Output. <b>xmlrpc_transport</b> doesn't really know
|
|
anything about XML; it sends the characters you supply and displays the
|
|
characters it gets back.
|
|
|
|
<p><b>xmlrpc_transport</b> uses the lower levels of the XML-RPC For C/C++
|
|
client libraries.
|
|
|
|
<p>This program is mainly useful for debugging and learning about
|
|
XML-RPC servers and the XML-RPC For C/C++ client XML transports.
|
|
|
|
|
|
<h2>Examples</h2>
|
|
|
|
<
|
|
|
|
<pre>
|
|
<tt>
|
|
$ xmlrpc_transport http://localhost:8080/RPC2 <<-EOF
|
|
<?xml version="1.0" encoding="UTF-8"?>
|
|
<methodCall>
|
|
<methodName>sample.add</methodName>
|
|
<params>
|
|
<param><value><i4>5</i4></value></param>
|
|
<param><value><i4>7</i4></value></param>
|
|
</params>
|
|
</methodCall>
|
|
EOF
|
|
<?xml version="1.0" encoding="UTF-8"?>
|
|
<methodResponse>
|
|
<params>
|
|
<param><value><i4>12</i4></value></param>
|
|
</params>
|
|
</methodResponse>
|
|
</tt>
|
|
</pre>
|
|
|
|
<h2>Overview</h2>
|
|
<p>
|
|
<b>xmlrpc_transport</b>
|
|
<i>url</i>
|
|
[<b>-transport=</b><i>transportname</i>]
|
|
[<b>-username=</b><i>username</i> <b>-password=</b><i>password</i>]
|
|
|
|
<P>Minimum unique abbreviation of option is acceptable. You may use double
|
|
hyphens instead of single hyphen to denote options. You may use white
|
|
space in place of the equals sign to separate an option name from its value.
|
|
|
|
|
|
<h2>Arguments</h2>
|
|
|
|
<dl>
|
|
<dt><i>url</i>
|
|
|
|
<dd>This is the URL of the XML-RPC server. As XML-RPC uses HTTP, this
|
|
must be an HTTP url. However, if you don't specify a type ("http:")
|
|
in the URL, <b>xmlrpc_transport</b> assumes an "http://" prefix and a
|
|
"/RPC2" suffix. <b>RPC2</b> is the conventional file name for
|
|
an XML-RPC responder.
|
|
|
|
</dl>
|
|
|
|
|
|
<h2>Options</h2>
|
|
|
|
<dl>
|
|
<dt><b>-transport=</b><i>transportname</i>
|
|
|
|
<dd>This selects the XML transport facility (e.g. libwww) that
|
|
<b>xmlrpc_transport</b> uses to perform the RPC.
|
|
|
|
<p>The name <i>transportname</i> is one that the Xmlrpc-c programming
|
|
library recognizes. This is typically <b>libwww</b>, <b>curl</b>, and
|
|
<b>wininet</b>.
|
|
|
|
<p>By default, <b>xmlrpc_transport</b> lets the Xmlrpc-c library choose.
|
|
|
|
<dt><b>-username=</b><i>username</i>
|
|
<dt><b>-password=</b><i>password</i>
|
|
|
|
<dd>These options, which must be used together, cause the client to
|
|
authenticate itself to the server, if the server requires it, using
|
|
HTTP Basic Authentication and the specified username and password.
|
|
|
|
</dl>
|
|
|
|
</body>
|
|
|