Changes between Version 37 and Version 38 of GuiRpc
- Timestamp:
- Aug 16, 2013, 1:04:23 PM (11 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
GuiRpc
v37 v38 3 3 = Controlling the BOINC client via RPC = 4 4 5 The BOINC c ore client provides a set of RPCs (remote procedure calls)5 The BOINC client provides a set of RPCs (remote procedure calls) 6 6 for control and state interrogation. 7 7 This enables the development of GUI (graphical user interface) programs. … … 18 18 * BOINC has a Java binding in [source:boinc-v2/android/BOINC/src/edu/berkeley/boinc/rpc/]. 19 19 * A .Net binding is available at https://boincguirpc.codeplex.com/ 20 * A Python binding is available at https://github.com/MestreLion/boinc-indicator 20 21 21 22 It should be easy to generate bindings in other languages. 22 GUI programs connect to the c ore client by opening a TCP socket at port 31416.23 GUI programs connect to the client by opening a TCP socket at port 31416. 23 24 They can then do repeated RPCs over this connection. 24 25 Each reply message ends with the character \003. … … 64 65 == RPC list == 65 66 The following functions require authorization for remote clients, but not for local clients. 66 Note: for c ore client versions 5.5.12 and earlier,67 Note: for client versions 5.5.12 and earlier, 67 68 all functions except `get_state()`, 68 69 `get_results()`, `get_screensaver_mode()`, … … 76 77 77 78 `exchange_versions(VERSION_INFO&)`:: 78 Exchange version info with the c ore client.79 The c ore client's version info is returned.79 Exchange version info with the client. 80 The client's version info is returned. 80 81 81 82 `get_activity_state(ACTIVITY_STATE&)`:: … … 136 137 137 138 `get_newer_versions(string&)`:: 138 Get a string describing newer versions of the c ore client, if any.139 Get a string describing newer versions of the client, if any. 139 140 140 141 `get_notices(int seqno, NOTICES& notices)`:: … … 169 170 170 171 `get_state(CC_STATE&)`:: 171 Get the c ore 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. 172 173 This call is relatively slow and should only be done initially, and when needed later (see below). 173 174 … … 176 177 177 178 `network_status(int&)`:: 178 Find whether the c ore 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. 179 180 Deprecated - for 5.5.13 and later, use [#function-cc_status cc_status()] instead. 180 181 181 182 `set_screensaver_mode``(bool enabled, ``double blank_time, ``DISPLAY_INFO&)`:: 182 If `enabled` is `true`, the c ore 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. 183 184 Blank screen after `blank_time` seconds. 184 185 … … 193 194 Do an Account Manager RPC to the given URL, passing the given name/password. 194 195 If `use_config_file` is true, then the existing URL, username, and password are used 195 and the c ore client updates the project information from the account manager.196 and the client updates the project information from the account manager. 196 197 If the RPC is successful, 197 198 save the account info on disk (it can be retrieved later using [#function-acct_mgr_info acct_mgr_info()]). … … 211 212 212 213 `network_available()`:: 213 Tells the c ore client that a network connection is available,214 Tells the client that a network connection is available, 214 215 and that it should do as much network activity as it can. 215 216 … … 223 224 224 225 `quit()`:: 225 Tell the c ore client to exit.226 Tell the client to exit. 226 227 227 228 `read_global_prefs_override()`:: 228 Tells the c ore client to reread the [PrefsOverride global_prefs_override.xml] file,229 Tells the client to reread the [PrefsOverride global_prefs_override.xml] file, 229 230 modifying the global preferences according to its contents. 230 231