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