/usr/share/doc/libxmlrpc-c3-dev/xmlrpc.html is in libxmlrpc-core-c3-dev 1.16.33-3.1ubuntu5.2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 | <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2//EN">
<title>Xmlrpc User Manual</title>
<body>
<p><b>xmlrpc</b> makes an XML-RPC remote procedure call (RPC) and displays
the response. <b>xmlrpc</b> runs an XML-RPC client.
<p>This program is mainly useful for debugging and learning about
XML-RPC servers. XML-RPC is such that the RPCs normally need to be made
by a program rather than a person to be of use.
<p>A similar tool done as a web form is at <a
href="http://gggeek.damacom.it/debugger/">
http://gggeek.damacom.it/debugger/</a>
<h2>Examples</h2>
<pre>
<tt>
$ xmlrpc http://localhost:8080/RPC2 sample.add i/3 i/5
Result:
Integer: 8
</tt>
</pre>
<pre>
<tt>
$ xmlrpc localhost:8080 sample.add i/3 i/5
Result:
Integer: 8
</tt>
</pre>
<pre>
<tt>
$ xmlrpc http://xmlrpc.server.net/~bryanh echostring \
"s/This is a string"
Result:
String: This is a string
</tt>
</pre>
<pre>
<tt>
$ xmlrpc http://xmlrpc.server.net/~bryanh echostring \
"This is a string in shortcut syntax"
Result:
String: This is a string in shortcut syntax
</tt>
</pre>
<pre>
<tt>
$ xmlrpc http://xmlrpc.server.net sample.add i/3 i/5 \
transport=curl -curlinterface=eth1 -username=bryanh -password=passw0rd
Result:
Integer: 8
</tt>
</pre>
<h2>Overview</h2>
<p>
<b>xmlrpc</b>
<i>url</i>
<i>methodName</i>
<i>parameter</i> ...
[<b>-transport=</b><i>transportname</i>]
[<b>-username=</b><i>username</i> <b>-password=</b><i>password</i>]
[<b>-curlinterface</b>={<i>interface</i>|<i>host</i>}]
[<b>-curlnoverifypeer</b>]
[<b>-curlnoverifyhost</b>]
<p><i>parameter</i>:
<p>
<b>i/</b><i>integer</i> |
<b>s/</b><i>string</i> |
<b>h/</b><i>hexstring</i> |
<b>b/</b>{<b>true</b>|<b>false</b>|<b>t</b>|<b>f</b>} |
<b>d/</b><i>realnum</i> |
<b>n/</b> |
<b><i>string</i></b>
<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</b> assumes an "http://" prefix and a
"/RPC2" suffix. <b>RPC2</b> is the conventional file name for
an XML-RPC responder.
<dt><i>methodName</i>
<dd>The name of the XML-RPC method you want to invoke.
<dt><i>parameter</i> ...
<dd>The list of parameters for the RPC. <b>xmlrpc</b> turns each of these
arguments into an XML-RPC parameter, in the order given. You may specify
no parameters if you like.
<p>You specify the data type of the parameter with a prefix ending in
a slash. Example: <b>i/5</b>. Here, the "i" signifies an
integer data type. "5" is the value.
<p><b>xmlrpc</b> is capable of only a subset of the
possible XML-RPC types, as follows by prefix:
<dl>
<dt>i/
<dd>integer (<i4>) (32 bit)
<dt>s/
<dd>string (<string>)
<dt>h/
<dd>byte string (<base64>). Specify the value in hexadecimal.
<dt>b/
<dd>boolean (<boolean>). Specify the value as "true" or
"t" for true; "false" or "f" for false.
<dt>d/
<dd>double (<double>) (i.e. real number)
<dt>n/
<dd>nil (<nil>)
<dt>I/
<dd>64 bit integer (<i8>)
</dl>
<p>As a shortcut, if you don't specify a prefix (i.e. your argument does
not contain a slash), <b>xmlrpc</b> assumes string data type.
</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</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</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.
<dt><b>-curlinterface</b>={<i>interface</i>|<i>host</i>}
<dd>
This option gives the "interface" option for a Curl XML transport.
<p>The exact meaning of this option is up to the Curl library, and the
best documentation for it is the manual for the 'curl' program that comes
with the Curl library.
<p>But essentially, it chooses the local network interface through which
to send the RPC. It causes the Curl library to perform a
"bind" operation on the socket it uses for the
communication. It can be the name of a network interface (e.g. on
Linux, "eth1") or an IP address of the interface or a host
name that resolves to the IP address of the interface. Unfortunately,
you can't explicitly state which form you're specifying, so there's
some ambiguity.
<p>Examples:
<ul>
<li>
<kbd>
-interface=eth1
</kbd>
<li>
<kbd>
-interface=64.171.19.66
</kbd>
<li>
<kbd>
-interface=giraffe.giraffe-data.com
</kbd>
</ul>
<p>This option causes <b>xmlrpc</b> to default to using the Curl
XML transport. You may not specify any other transport.
<dt><b>-curlnoverifypeer</b>
<dd>
This option gives the "no_ssl_verifypeer" option for the Curl
XML transport, which is essentially the CURLOPT_SSL_VERIFYPEER option
of the Curl library.
<p>See the <b>curl_easy_setopt()</b> man page for details on this, but
essentially it means that the client does not authenticate the server's
certificate of identity -- it just believes whatever the server says.
<p>You may want to use <b>-curlnoverifyhost</b> as well. Since you're
not authenticating the server's identity, there's not much sense in
checking it.
<p>This option causes <b>xmlrpc</b> to default to using the Curl
XML transport. You may not specify any other transport.
<dt><b>-curlnoverifyhost</b>
<dd>
This option gives the "no_ssl_verifyhost" option for the Curl
XML transport, which is essentially the CURLOPT_SSL_VERIFYHOST option
of the Curl library.
<p>See the <b>curl_easy_setopt()</b> man page for details on this, but
essentially it means that the client does not verify the server's
identity. It just assumes that if the server answers the IP address
of the server as indicated by the URL (probably via host name), then
it's the intended server.
<p>You may want to use <b>-curlnoverifypeer</b> as well. As long as
you don't care who the server says it is, there's no point in
authenticating its identity.
<p>This option causes <b>xmlrpc</b> to default to using the Curl
XML transport. You may not specify any other transport.
</dl>
<h2>Limitations</h2>
<p>If you run <b>xmlrpc</b> in an environment in which programs get
their arguments encoded some way other than UTF-8, <b>xmlrpc</b>
will generate garbage for the XML-RPC call and display garbage for
the XML-RPC response. Typically, you control this aspect of the
environment with a <b>LANG</b> environment variable. One safe value
for <b>LANG</b> is "C".
</body>
|