wiki:UnixClientPackage

Version 8 (modified by Eric Myers, 10 years ago) (diff)

filenames and paths in monospace.

Unix client package layout

The purpose of this page is to describe the layout of files for installation of the BOINC client software on Unix machines. It is desirable, as much as is possible, to keep things the same so that volunteers who are not Unix experts can still understand what is what and what is where an ask questions, without having to get into specifics of which distro they are using.

Items we need to specify:

Working directory

This is /var/lib/boinc on Fedora, but /var/lib/boinc-client on Debian. Can we agree on only one of these?

Configuration files for the core client

These are cc_config.xml, remote_hosts.cfg, etc.) Debian, for example, puts these in /etc/boinc-client/ and has appropriate symlinks in the working directory

WHY? -EAM

It is policy in Debian that all configuraton files must reside in /etc -FST That makes sense only for files which the sysadmin would edit to change configuration (like /etc/default/boinc-client) but not these .xml files, which are basically only saved state. They are not really "configuration" files in the Unix sense. -EAM

Executable files

The proper names of these are being debated (April 2008). If there are changes, old names can be supported for a while with soft-links.

  • /usr/bin/boinc_client
  • /usr/bin/boincmgr
  • /usr/bin/boinc_cmd

init script to start/stop daemon

  • /etc/init.d/boinc or /etc/init.d/boinc-client ?

Again, let's try to pick one name for all distros.

config file read by the init script

  • /etc/default/boinc-client on Debian
  • /etc/default/boinc on Fedora

Can we make these the same for both?

Unix 'man' pages

Under /usr/share/man/man1 the files:

  • boinc.1
  • boinc_client.1
  • boincmgr.1
  • boinc_cmd.1

Change the names as needed to match any changes in command names.

bash command completion script