Changes between Version 17 and Version 18 of GuiRpcProtocol


Ignore:
Timestamp:
Sep 9, 2008, 8:56:09 AM (16 years ago)
Author:
Pepo
Comment:

"client must always send <boinc_gui_rpc_request> tag" typo

Legend:

Unmodified
Added
Removed
Modified
  • GuiRpcProtocol

    v17 v18  
    1010The protocol is based on XML, and it's strictly request-reply. The client sends requests to the server, and waits for a reply; the server never sends a reply without getting a request from the client first. Both requests and replies are terminated with the control character `0x03`.
    1111
    12 Requests are inside `<boinc_gui_rpc_request>` elements, and replies from the RPC server are inside `<boinc_gui_rpc_reply>` elements (in both cases there is a `0x03` byte after the closing tag). The current core client doesn't require the `<boinc_gui_rpc_request>` tag, which is handy for debugging (you can connect via [http://netcat.sourceforge.net/ netcat] and just type `<auth1/>`); however, clients must not rely on this, and must always send the `<boinc_gui_rpc_request>` root tag.
     12Requests are inside `<boinc_gui_rpc_request>` elements, and replies from the RPC server are inside `<boinc_gui_rpc_reply>` elements (in both cases there is a `0x03` byte after the closing tag). The current core client doesn't require the `<boinc_gui_rpc_request>` tag, which is handy for debugging (you can connect via [http://netcat.sourceforge.net/ netcat] and just type `<auth1/>`); however,
     13> clients must not rely on this, and must always send the __`<boinc_gui_rpc_request>`__ root tag.
     14Ought this to be read as "''must always send the __`<boinc_gui_rpc_reply>`__ root tag''"?
    1315
    1416The current official core client (RPC server) doesn't support pipelining of requests (pipelining means sending a batch of multiple requests without waiting for a reply, then getting all the replies together; this improves latency). For compatibility, pipelining must not be used.