Configuration

There are two ways to configure the programs.

1. Via the file ~/.wcginitrc
2. Via the individual programs

We'll discuss these two possiblities now.

Configuring the programs via the file ~/.wcginitrc

To put this to use, you need to supply several variables (and their values, of course) and store these items into the file ~/.wcginitrc.

wcgformat

For wcgformat there is no special variable to configure.
However …
This is a good moment to create the file ~/.wcginitrc and to limit access to it as it may contain vulnerable information:

$ touch ~/.wcginitrc && chmod 600 ~/.wcginitrc

wcglog

For wcglog there are two special variables to configure:

The final location and name of the logfile is constructed by wcglog from one of the words in each individual value of $SEARCHDIRS and $SEARCHNAMS, so $SEARCHDIRS/$SEARCHNAMS may yield "tmp/wcg" in the end, as an example. The words in each individual value, like e.g. "WCG" and "wcg", are separated by spaces only.

Note: Since wcglog doesn't know the exact location of the logfile, therefore there are two ways to specify the location of the logfile; one way is to specify its path/name on the commandline, the other way is through the configuration, using the variables SEARCHDIRS and SEARCHNAMS. In the latter case, wcglog will add the string ".log" to the end of the name of the logfile.

wcgmembercmp

For wcgmembercmp there are two special variables to configure:

wcgresults

For wcgresults there are at least two special variables to configure:

wcgstats

For wcgstats there are at least two special variables to configure, in addition you can also add variables for your device(s):

Note: Once you have configured the variables MAILADDR and PASSWORD successfully, you'll be able to generate a list of your devices, like so as an example:

$ wcgstats -ZZZ
DEVICES=0; let n=0; # Start counting the number of devices.
let n++; DEVICE_ID[$n]=1234567; DEVICENAME[$n]="desktop"
let n++; DEVICE_ID[$n]=2345678; DEVICENAME[$n]="laptop"
let n++; DEVICE_ID[$n]=3456789; DEVICENAME[$n]="smartphone"
DEVICES=$n  # The total number of devices.

This will also give you the opportunity to add the output to your configuration file:

$ wcgstats -ZZZ >> ~/.wcginitrc

Final note: the special variable-names are in capitals only.

In the end, the contents of your file ~/.wcginitrc may look something like this:

SEARCHDIRS="BOINC data logdir misc"
SEARCHNAMS="WCG wcg results"
USERNAME=my_username
TEAMNAME=my_teamname
MEMBER=my_username
VERIFY=c0de1234567890987654321ed0c
MAILADDR=my_address@example.com
PASSWORD=Impossible2Guess
DEVICES=0; let n=0; # Start counting the number of devices.
let n++; DEVICE_ID[$n]=1234567; DEVICENAME[$n]="desktop"
let n++; DEVICE_ID[$n]=2345678; DEVICENAME[$n]="laptop"
let n++; DEVICE_ID[$n]=3456789; DEVICENAME[$n]="smartphone"
DEVICES=$n  # The total number of devices.

Configuring the programs individually

In this case you will have to edit each individual program that you want to put to good use.
There is a section designated by the word "CONFIGURE" surrounded by hashtags in each program where you can edit the values of the variables.
It might also be a good idea to limit access to the individual programs as they may contain vulnerable information, e.g. like so:

$ for s in format log membercmp results stats; do f=~/bin/wcg$s; [ -f $f ] && chmod 700 $f; done

After configuring each individual program there is no need to configure it again when you download a newer version of the program: each executable program that needs configuring has an option -U to update the old version of the program to the new version.