Boinccmd

boinccmd是BOINC客户端的命令行界面，用来控制BOINC客户端，可以在命令行（Windows 命令提示符、UNIX/UNIX-LIKE终端模拟器）中通过以下命令使用：

boinccmd [--host 主机名[:端口]] [--passwd 密码] {命令}
boinccmd [-hV]

注意：--host 和 --passwd 参数必须在其他参数前面。

参数

• --host 主机名[:端口]

连接到指定主机。 默认为localhost（本机）。

• --passwd 密码

使用指定密码来通过RPC验证。如果默认工作目录包含文件gui_rpc_auth.cfg，boinccmd会从该文件读取密码。

• -h, --help

显示全部命令的帮助。

• -V, --version

显示程序版本。

命令

账户信息与添加

• --lookup_account 项目网址 注册邮箱 密码

寻找账户并输出账户密匙（注：不是添加账户）。

• --create_account 项目网址 注册邮箱 密码 用户名

用给定的邮箱、密码、用户名创建指定项目下的账户。

• --project_attach 项目网址 账户密匙

添加账户。

• --join_acct_mgr 项目网址 用户名 密码

添加账户管理器（如果已经添加，则进行通信）。

• --quit_acct_mgr

退出当前项目管理器。

状态信息

• --get_state

输出完整的客户端状态。

• --get_results

输出所有的任务状态。

• --get_simple_gui_info

输出项目状态和计算中的任务状态。

• --get_file_transfers

输出所有传输中的文件。

• --get_project_status

输出所有项目的状态。

• --get_disk_usage

输出所有项目的磁盘使用状况。

• --get_proxy_settings

获取代理服务器设置。

• --get_messages seqno

输出编号在seqno之后的信息（可以省略seqno）。

• --get_host_info

获得当前连接到的主机的信息。

控制操作

• --result 项目网址 任务名
  {suspend | resume | abort | graphics_window | graphics_fullscreen}
  [--desktop dt | --window_station ws | --display dp]

对任务执行操作

suspend

暂停，暂时停止工作。

resume

恢复，恢复计算。

abort

中止，放弃计算。

graphics_window

窗口显示图形。可以选择图形服务器。使用window_station (Windows系统) 或者 display (X11) 参数。

graphics_fullscreen'

全屏显示图形。

• --project 项目网址
  {reset | detach | update | suspend | resume |
  nomorework | allowmorework | detach_when_done}

对项目执行操作。

reset

重置，删除当前项目的所有任务和文件并重新获取。

detach

删除任务，删除当前项目的所有任务。

update

更新，联络项目服务器。

suspend

暂停，暂停当前项目所有任务。

resume

恢复，恢复计算当前项目所有任务。

nomorework

禁止下载任务。

allowmorework

允许下载任务。

detach_when_done

退出项目。

• --file_transfer 项目网址 文件名 {retry | abort}

重试（retry）或中止（abort）文件传输。

• --set_run_mode {always | auto | never} [持续时间]

设置运行模式。

always 一直运行。

auto 按照默认设置运行。

never 停止计算。

如果“持续时间”参数为0或未指定，则始终维持当前模式。否则，超过指定的秒数后，恢复原先模式。

• --set_network_mode {always | auto | never} [持续时间]

设置网络使用模式，参数含义同上。

• --set_proxy_settings HTTP代理服务器地址 HTTP端口 用户名 密码
  SOCKS代理 代理服务器地址 SOCKS端口 SOCKS版本 SOCK5用户名 SOCK5密码

设置代理服务器。所有参数都是必须的。

• --run_benchmarks

执行CPU基准测试。

• --set_screensaver_mode {on | off} 黑屏时间
  [--desktop dt | --window_station ws | --display dp]

客户端开始或停止图形屏保，“黑屏时间”（秒）过后黑屏。可选参数指定使用何种图形服务器：desktop 、windows_station (Windows系统) 或者 display (X11)。

• --read_global_prefs_override

客户端读取global_prefs_override.xml，并使用文件中指定的全局设置。

• --quit

退出客户端。

• --read_cc_config

重新读取配置文件cc_config.xml。

• --set_debts URL1 STD1 LTD1 [URL2 STD2 LTD2 ...]

设置各个项目的长期和短期资源占用。

• --get_project_config 项目网址

从网上读取项目设置。

• --get_project_config_poll

• --network_available

• --get_cc_status

读取设置文件cc_config.xml