oam/knowledge base/boinccmd.md

Boinccmd

Table of contents

1. TL;DR
2. Gotchas
3. Further readings
4. Sources

TL;DR

# Use a project manager.
boinccmd --acct_mgr attach 'http://bam.boincstats.com' 'username' 'password'
boinccmd --acct_mgr info
boinccmd --acct_mgr sync
boinccmd --acct_mgr detach

# Reread the configuration files.
# Includes any 'app_config.xml' file existing in the projects' folders.
boinccmd --read_cc_config

# Get the host's status.
boinccmd --get_simple_gui_info
boinccmd --get_state

# List the current tasks.
boinccmd --get_tasks
boinccmd --get_tasks | grep -i -C 8 'executing'

# Request projects' update.
boinccmd --project http://www.worldcommunitygrid.org/ update

# Get file transfers.
boinccmd --get_file_transfers

# Retry file transfers.
boinccmd --file_transfer \
  'https://www.sidock.si/sidock/' \
  'corona_RdRp_v2_sidock_00475839_r2_s-20_0_r356677380_0' \
  retry

# Toggle getting work units from a project.
boinccmd --project http://www.worldcommunitygrid.org/ allowmorework
boinccmd --get_project_status \
| grep "master URL" \
| awk -F ": " '{print $2}' \
| xargs -n 1 -t -I {} boinccmd --project {} nomorework

Gotchas

• boinccmd looks for the gui_rpc_auth.cfg file in the same directory it is launched from.

Further readings

• Boinccmd tool

Sources

All the references in the further readings section, plus the following: