Changes between Version 37 and Version 38 of GuiRpc


Ignore:
Timestamp:
Aug 16, 2013, 1:04:23 PM (11 years ago)
Author:
davea
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • GuiRpc

    v37 v38  
    33= Controlling the BOINC client via RPC =
    44
    5 The BOINC core client provides a set of RPCs (remote procedure calls)
     5The BOINC client provides a set of RPCs (remote procedure calls)
    66for control and state interrogation.
    77This enables the development of GUI (graphical user interface) programs.
     
    1818 * BOINC has a Java binding in [source:boinc-v2/android/BOINC/src/edu/berkeley/boinc/rpc/].
    1919 * A .Net binding is available at https://boincguirpc.codeplex.com/
     20 * A Python binding is available at https://github.com/MestreLion/boinc-indicator
    2021
    2122It should be easy to generate bindings in other languages.
    22 GUI programs connect to the core client by opening a TCP socket at port 31416.
     23GUI programs connect to the client by opening a TCP socket at port 31416.
    2324They can then do repeated RPCs over this connection.
    2425Each reply message ends with the character \003.
     
    6465== RPC list ==
    6566The following functions require authorization for remote clients, but not for local clients.
    66 Note: for core client versions 5.5.12 and earlier,
     67Note: for client versions 5.5.12 and earlier,
    6768all functions except `get_state()`,
    6869`get_results()`, `get_screensaver_mode()`,
     
    7677
    7778 `exchange_versions(VERSION_INFO&)`::
    78  Exchange version info with the core client.
    79  The core client's version info is returned.
     79 Exchange version info with the client.
     80 The client's version info is returned.
    8081
    8182 `get_activity_state(ACTIVITY_STATE&)`::
     
    136137
    137138 `get_newer_versions(string&)`::
    138  Get a string describing newer versions of the core client, if any.
     139 Get a string describing newer versions of the client, if any.
    139140
    140141 `get_notices(int seqno, NOTICES& notices)`::
     
    169170
    170171 `get_state(CC_STATE&)`::
    171   Get the core client's 'static' state, i.e. its projects, apps, app_versions, workunits and results.
     172  Get the client's 'static' state, i.e. its projects, apps, app_versions, workunits and results.
    172173  This call is relatively slow and should only be done initially, and when needed later (see below).
    173174
     
    176177
    177178 `network_status(int&)`::
    178  Find whether the core client has, needs, or is done with a physical network connection.
     179 Find whether the client has, needs, or is done with a physical network connection.
    179180 Deprecated - for 5.5.13 and later, use [#function-cc_status cc_status()] instead.
    180181
    181182 `set_screensaver_mode``(bool enabled, ``double blank_time, ``DISPLAY_INFO&)`::
    182  If `enabled` is `true`, the core client should try to get an application to provide screensaver graphics.
     183 If `enabled` is `true`, the client should try to get an application to provide screensaver graphics.
    183184 Blank screen after `blank_time` seconds.
    184185
     
    193194 Do an Account Manager RPC to the given URL, passing the given name/password.
    194195 If `use_config_file` is true, then the existing URL, username, and password are used
    195  and the core client updates the project information from the account manager.
     196 and the client updates the project information from the account manager.
    196197 If the RPC is successful,
    197198 save the account info on disk (it can be retrieved later using [#function-acct_mgr_info acct_mgr_info()]).
     
    211212
    212213 `network_available()`::
    213  Tells the core client that a network connection is available,
     214 Tells the client that a network connection is available,
    214215 and that it should do as much network activity as it can.
    215216
     
    223224
    224225 `quit()`::
    225  Tell the core client to exit.
     226 Tell the client to exit.
    226227
    227228 `read_global_prefs_override()`::
    228  Tells the core client to reread the [PrefsOverride global_prefs_override.xml] file,
     229 Tells the client to reread the [PrefsOverride global_prefs_override.xml] file,
    229230 modifying the global preferences according to its contents.
    230231