		    Setiathome Enhanced for OpenBSD/amd64
		    =====================================

    This is a single how-to, where i describe how i did set setiathome up.
    However i didn't have a chance to try the package out on other computers,
    only on my own box, so maybe there are things i left out accidentally.
    Feel free to contact me, if there's more to do with it.

1.Unpack
    After you got the separate Boinc package, extract it.
    At me these files are in /usr/local/bin, i will refer to these directories
    mentioned here as defaults.
    Extract setiathome_enhanced into a temporary directory. There is a library
    called libfftw3f, it is good to have this here, or you can just put it in
    your libraries directory.
    I made then a work-directory for the project /usr/local/boinc.
    Also i made a separate log file for boinc /var/log/boinc.log, but it's just
    how i like.

2.Add new user to run boinc
    Add a new user, for example boinc with the home directory /usr/local/boinc,
    and with some shell, like /bin/ksh.
    It is better to run boinc with an unprivileged user, as running by root.
    This user will be used to execute boinc at boot time.
    
3.First run
    It is a good idea to check out the command switches boinc accepts with
    /usr/local/bin/boinc_client -help.
    Let's follow as instructed on boinc website, so in our case we need to
    run boinc once first, to create the project specific directories:
    /usr/local/bin/boinc_client -dir /usr/local/boinc -attach_project http://setiathome.berkeley.edu *YOUR-PROJECT-KEY*
    The project key was emailed to you, when you subscribed to the project.
    This will run boinc and attaches to setiathome if done properly.
    You will see the scheduler tells us that the platform is not found,
    this is because OpenBSD is not yet supported by the project and we won't
    get any supported setiathome application automatically. That's why we
    need the separate setiathome package, we recently unpacked to a temp dir.
    Ok now boinc is still unable to do anything, so exit with Ctrl-C.
    
4.Setup Setiathome
    Now copy the extracted setiathome files from the temp dir to the newly
    created project dir /usr/local/boinc/projects/setiathome.berkeley.edu
    Boinc will call setiathome from this directory, when work is sent to it.
    Make sure all files are owned by our created user boinc, with chown.
    You can add boinc now to the startup script too:
    in /etc/rc.local:
    
    echo -n 'starting local daemons:'
    #Add your local startup actions here.
    
    #Boinc
    echo -n ' boinc'
    cd /usr/local/boinc
    su boinc -c 'nice -n 19 /usr/local/bin/boinc_client -dir /usr/local/boinc' >> /var/log/boinc.log 2>&1 &
    
    echo '.'
    
    This will run boinc with low priority and will log all output to boinc.log.
    The -c switch will pass all the parameters followed it, to the shell
    defined at the user boinc we created before. The '&' sign at the end will
    put boinc into the background.
    
5.See it in action
    You better make a run-by-hand here first before rebooting, to check that
    everything is working or not and to update your preferences:
    /usr/local/bin/boinc_client -dir /usr/local/boinc -update_prefs http://setiathome.berkeley.edu
    Hopefully you will get now to the point where the scheduler will be asked
    to send work for you. Maybe you need to wait here some more as i needed too
    until you get some work, but it will come sooner or later.
    After it starts crunching, you can safely exit and reboot and see it
    working via the logfile or via boinc_cmd (after you set up a sane password
    in gui_rpc_auth.cfg). 
    Well done!
    
6.Notes
    Feel free to contact me, if something went wrong, or something is left out
    what is needed but i forgot and we will then figure it out.
    I had many problems with this to work too, but others can help, so
    don't hesitate to ask. My address is summoner at enternet dot hu.
    Many thanx goes here to Lars Bausch, who helped me a lot with this port.
    
    Happy crunching!
    