setiathome(1)		User Commands

NAME
    setiathome - the SETI@home client program

SYNOPSIS
    setiathome [options]

DESCRIPTION
    setiathome is the UNIX version of the SETI@home client.
    It downloads radio telescope data from a network server,
    analyzes the data looking for signals of extraterrestrial origin,
    and uploads results to the server, repeating this cycle indefinitely.
    See http://setiathome.ssl.berkeley.edu for more information.

    The first time you run setiathome it will interactively
    ask you for email address, name, country etc.
    This info is stored in a file and no interaction is
    needed when you run the program subsequently.

    After this you can run setiathome in the background,
    and direct its output to /dev/null if you like.

    setiathome can be freely aborted and restarted.
    It saves its state in files, and will pick up where it left off.

    If you wish setiathome to be started automatically, you may wish to
    setup a cron job.  If you add the following line to your crontab:

    0 * * * * cd <setidir>; ./setiathome -nice 19 > /dev/null 2> /dev/null

    Where <setidir> is the directory where the setiathome client has
    been installed, this cron job will attempt to start the client
    at the top of every hour.  If it is already running, the next
    invocation will do nothing.  If the client is not running, it will
    be started.  For more information on cron jobs see the crontab(1)
    manual page.

    The following script will stop SETI@home:

    #! /bin/sh
    kill `ps aux | grep setia | grep -v grep | awk '{print $2}'`

    If the environment variable HTTP_PROXY is defined,
    setiathome will connect through a proxy server,
    specified as hostname or hostname:port.

OPTIONS
    -login
	Login or create new account.

    -countries
	Show list of country codes.
    
    -version
	Show software version
    
    -nice N
	Set "nice" priority to N (default 1);

    -email
	Send email (to login email address) on errors.
	Useful if you run in background directed to /dev/null.

    -proxy hostname:port
	Connect to SETI@home server via specified proxy server and port.

    -stop_after_process
	stop after processing current work unit.
	Do not send result.

    -stop_after_xfer
	stop after current work unit has been sent to the SETI
	server and a new work unit has been obtained.
	(see also: stop_after_send.txt mentioned in FILES below)
    
    -verbose
	print a running summary of the work being done
    
    -nolock
	omit the multiple-instance check, which uses file locking
	(not available on some NFS systems)

FILES
    The program generates several files with .txt extension
    in the directory from which it's run.
    These should not be modified.

    If you want to run multiple instances of setiathome
    (on a multiprocessor machine, or on multiple machines
    that share a filesystem) each one must be run
    in a different directory.

    setiathome uses a lock file (lock.txt) to prevent
    multiple instances from running in the same directory.

    To finish up your current work unit, return your result, and not
    download a new work unit, while the client is running, touch
    a file named "stop_after_send.txt" in the client directory.
    When the processing is finished, and the result sent, the
    client will stop.