'\" -*- coding: us-ascii -*-
.if \n(.g .ds T< \\FC
.if \n(.g .ds T> \\F[\n[.fam]]
.de URL
\\$2 \(la\\$1\(ra\\$3
..
.if \n(.g .mso www.tmac
.TH boinc 1 "03 February 2020" "" ""
.SH NAME
boinc \- The BOINC client program.
.SH SYNOPSIS
'nh
.fi
.ad l
\fBboinc\fR \kx
.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
'in \n(.iu+\nxu
[\fIoptions\fR]
'in \n(.iu-\nxu
.ad b
'hy
.SH DESCRIPTION
The BOINC "client", \fBboinc\fR, is the heart of BOINC.
It controls which project applications are run on your computer,
downloading "Tasks" and uploading the resulting files from completed
tasks. \fBboinc\fR is usually run in the background, ideally as a
daemon. It can then be controlled either by a graphical tool called the
BOINC Manager, \fBboincmgr\fR(1), or a command-line tool called
\fBboinccmd\fR(1), by means of Remote Procedure Calls (RPCs) over port
31416.
.PP
The BOINC client can be controlled by command-line options,
configuration files, and environment variables. Standard usage is simply
to start the client running in the background.
.SH OPTIONS
These command-line options for \fBboinc\fR can be used to control
how BOINC is started. Once the client has started, you should use a
separate program, (\fBboincmgr\fR(1) or \fBboinccmd\fR(1)) which communicates
with it by means of Remote Procedure Calls (RPCs).
.SS "GENERAL OPTIONS"
.TP 
\*(T<\fB\-\-help\fR\*(T>
Show options.
.TP 
\*(T<\fB\-\-version\fR\*(T>
Show version info.
.TP 
\*(T<\fB\-\-run_cpu_benchmarks\fR\*(T>
Run the CPU benchmarks.
.TP 
\*(T<\fB\-\-check_all_logins\fR\*(T>
For idle detection, check remote logins too.
.TP 
\*(T<\fB\-\-daemon\fR\*(T>
Run as daemon. Will redirect stderr and stdout to syslog.
.TP 
\*(T<\fB\-\-dir \fR\*(T>\fIpath\fR
Use given dir as the client working directory.
.TP 
\*(T<\fB\-\-no_gpus\fR\*(T>
Don't check for GPUs.
.TP 
\*(T<\fB\-\-no_info_fetch\fR\*(T>
Don't fetch project list or client version info from
boinc.berkeley.edu.
.TP 
\*(T<\fB\-\-skip_cpu_benchmarks\fR\*(T>
Don't run CPU benchmarks.
.TP 
\*(T<\fB\-\-start_delay \fR\*(T>\fIX\fR 
Delay starting apps for X secs.
.SS "PROJECT OPTIONS"
.TP 
\*(T<\fB\-\-attach_project \fR\*(T>\fIURL\fR\*(T<\fB \fR\*(T>\fIkey\fR 
Attach to a project using URL and authenticator.
.TP 
\*(T<\fB\-\-show_projects\fR\*(T>
Show attached projects.
.TP 
\*(T<\fB\-\-detach_project \fR\*(T>\fIURL\fR 
Detach from project specified by URL.
.TP 
\*(T<\fB\-\-reset_project \fR\*(T>\fIURL\fR 
Reset (clear) the projectspecified by URL.
.TP 
\*(T<\fB\-\-update_prefs \fR\*(T>\fIURL\fR 
Contact the project specified by URL to update preferences
.SS "COMMUNICATION OPTIONS"
.TP 
\*(T<\fB\-\-allow_remote_gui_rpc\fR\*(T>
Allow RPC connections from remote hosts.
.TP 
\*(T<\fB\-\-gui_rpc_port \fR\*(T>\fIport\fR 
Port for RPCs.
.TP 
\*(T<\fB\-\-no_gui_rpc\fR\*(T>
Omits creation of a socket as required for the remote control
of the client. Consequently the client cannot be controlled by
external tools like GUIs (\fBboincmgr\fR etc.) or the console
command tool (\fBboinccmd\fR).
.SS "DEBUGGING OPTIONS"
.TP 
\*(T<\fB\-\-abort_jobs_on_exit\fR\*(T>
When client exits, abort and report tasks.
.TP 
\*(T<\fB\-\-allow_multiple_clients\fR\*(T>
Allow more than one client instance per host.
.TP 
\*(T<\fB\-\-exit_after_app_start \fR\*(T>\fIN\fR 
Exit N seconds after an app starts. Useful to look at the
files in the slot directory.
.TP 
\*(T<\fB\-\-exit_after_finish\fR\*(T>
Exit right after finishing a task. Useful to look at the
files in the slot directory.
.TP 
\*(T<\fB\-\-exit_before_start\fR\*(T>
Exit right before starting a task. Useful to look at the
files in the slot directory.
.TP 
\*(T<\fB\-\-exit_before_upload\fR\*(T>
Exit right before starting an upload.
.TP 
\*(T<\fB\-\-exit_when_idle\fR\*(T>
Exit when there are no more tasks to work on.
.TP 
\*(T<\fB\-\-fetch_minimal_work\fR\*(T>
Fetch only 1 task per device.
.TP 
\*(T<\fB\-\-file_xfer_giveup_period \fR\*(T>\fIN\fR
Give up on file transfers after N sec.
.TP 
\*(T<\fB\-\-master_fetch_interval \fR\*(T>\fIN\fR
Limiting the period of project master file dowload retries.
.TP 
\*(T<\fB\-\-master_fetch_period \fR\*(T>\fIN\fR
Reload a project's master file after N RPC failures.
.TP 
\*(T<\fB\-\-master_fetch_retry_cap \fR\*(T>\fIN\fR
Exponential backoff limit for downloading project master files.
.TP 
\*(T<\fB\-\-no_priority_change\fR\*(T>
Run applications at same priority as client.
.TP 
\*(T<\fB\-\-pers_giveup \fR\*(T>\fIN\fR
Giveup time for persistent file transfer errors.
.TP 
\*(T<\fB\-\-pers_retry_delay_max \fR\*(T>\fIN\fR
Maximum time (sec) for file transfer exponential backoff.
.TP 
\*(T<\fB\-\-pers_retry_delay_min \fR\*(T>\fIN\fR
Minimum time (sec) for file transfer exponential backoff.
.TP 
\*(T<\fB\-\-redirectio\fR\*(T>
Redirect stdout and stderr to log files
(\*(T<\fIstdoutdae.txt\fR\*(T> and \*(T<\fIstderrdae.txt\fR\*(T>).
.TP 
\*(T<\fB\-\-retry_cap \fR\*(T>\fIN\fR
Limit the maximum exponential backoff time.
.TP 
\*(T<\fB\-\-sched_retry_delay_max \fR\*(T>\fIN\fR
Maximum time (sec) for project RPC exponential backoff.
.TP 
\*(T<\fB\-\-sched_retry_delay_min \fR\*(T>\fIN\fR
Minimum time (sec) for project RPC exponential backoff.
.TP 
\*(T<\fB\-\-unsigned_apps_ok\fR\*(T>
Allow unsigned apps (for testing).
.SH "ACCESS CONTROL FOR GUI RPC"
By default the client accepts GUI RPC connections only from
programs on the same host, which means that any user on this host can
control the client.
.SH "SEE ALSO"
\fBboinccmd\fR(1), \fBboincmgr\fR(1)
.PP
.URL https://boinc.berkeley.edu/wiki/Client_configuration#Command-line_options ""
.SH COPYRIGHT
Copyright \(co 2007-2020 University of California.
.PP
Permission is granted to copy, distribute and/or modify this
document under the terms of the GNU Free Documentation License,
Version 1.2 or any later version published by the Free Software
Foundation; with no Invariant Sections, no Front-Cover Texts, and no
Back-Cover Texts.