Components

The BOINC client software can be run in a command-line (non-graphical) environment. This involves two programs:

Instructions for installing these programs, and for automatic startup of the core client, are here.

The core client (boinc_client)

command-line options

"; list_start(); list_item("-help", "Show client options." ); list_item("-version", "Show client version." ); list_item("-attach_project URL account_key", "Attach this computer to a new project." ); list_item("-show_projects", "Print a list of projects to which this computer is attached." ); list_item("-detach_project URL", "Detach this computer from a project." ); list_item("-reset_project URL", "Clear pending work for a project. Use this if there is a problem that is preventing your computer from working." ); list_item("-update_prefs URL", "Contact a project's server to obtain new preferences. This will also report completed results and get new work if needed." ); list_item("-return_results_immediately", "Contact scheduler as soon as any result done." ); list_item("-run_cpu_benchmarks", "Run CPU benchmarks. Do this if you have modified your computer's hardware." ); list_item("-check_all_logins", "If 'run if user active' preference is off, check for input activity on all current logins; default is to check only local mouse/keyboard" ); list_item("-exit_when_idle", "Get, process and report work, then exit." ); list_item("-allow_remote_gui_rpc", "Allow GUI RPCs from remote hosts" ); list_item("-dir abs_path", "Use the given directory as BOINC home" ); list_item("-no_gui_rpc", "Don't allow GUI RPCs; don't try to create socket." ); list_end(); echo "

The core client has the following optional environment variables: "; list_start(); list_item("HTTP_PROXY", "URL of HTTP proxy"); list_item("HTTP_USER_NAME", "User name for proxy authentication"); list_item("HTTP_USER_PASSWD", "Password for proxy authentication"); list_item("SOCKS4_SERVER", "URL of SOCKS 4 server"); list_item("SOCKS5_SERVER", "URL of SOCKS 5 server"); list_item("SOCKS5_USER", "User name for SOCKS authentication"); list_item("SOCKS5_PASSWD", "Password for SOCKS authentication"); list_end(); echo "

The command tool (boinc_cmd)

The command-line interface program has the following interface:

boinc_cmd [--host hostname] [--passwd passwd] command
The commands are as follows: "; list_start(); list_item("--help, -h", "help (show commands)"); list_item("--version, -V", "show version"); list_item("--get_state", "show client state"); list_item("--get_results", "show results"); list_item("--get_file_transfers", "show file transfers"); list_item("--get_project_status", "show status of all projects"); list_item("--get_disk_usage", "Show disk usage by project"); list_item("--result URL result_name
{suspend | resume | abort | graphics_window | graphics_fullscreen}
{--window_station ws} {--desktop dt} {--display dp} ", "Do operation on a result, identified by the project master URL and the result name. " ); list_item("--project URL
{reset | detach | update | suspend | resume | nomorework | allowmorework} ", "Do operation on a project, identified by its master URL. " ); list_item("--project_attach URL auth","Attach to an account"); list_item("--file_transfer URL filename {retry | abort} ", "Do operation on a file transfer" ); list_item("--get_run_mode","Get current run mode"); list_item("--set_run_mode {always | auto | never}", "Set run mode.
always: do work (network + CPU) always
auto: do work only when allowed by preferences
never: don't do work (same as suspending all projects) " ); list_item("--get_network_mode","Get current network mode"); list_item("--set_network_mode {always | auto | never}", "Set network mode
Like set_run_mode but applies only to network transfers " ); list_item("--get_proxy_settings", "Get proxy settings"); list_item( "--set_proxy_settings http_server_name http_server_port http_user_name http_user_passwd socks_server_name socks_server_port socks_version socks5_user_name socks5_user_passwd ", "Set proxy settings (all fields are mandatory)" ); list_item("--get_messages seqno", "show messages with sequence numbers beyond the given seqno" ); list_item("--get_host_info", "Show host info"); list_item("--acct_mgr_rpc URL name password", "Instruct core client to contact an account manager server." ); list_item("--run_benchmarks", "Run CPU benchmarks"); list_item("--get_screensaver_mode", ""); list_item( "--set_screensaver_mode on|off blank_time
{--desktop desktop}
{--window_station window_station}
{--display display} ", "Tell the core client to start or stop doing fullscreen graphics, and going to black after blank_time seconds. The optional arguments specify which desktop/windows_station (Windows) or display (X11) to use. " ); list_item("--quit", ""); list_end(); page_tail(); ?>