###################################################
#                                                 #
#   P  R  I  C  E  F  A  R  M  E  R  .  C  O  M   #
#                                                 #
#            Farm@Home Client Toolkit             #
#                                                 #
###################################################


System Requirements
-------------------
- Unix System (Win98 port abandoned for now)
- Perl 5.005_03 Minimum (5.6 OK)
- Various Perl libraries and their dependencies (see below)
- GNU patch 2.5.4


Installation Instructions
-------------------------

1.  Unpack the distribution tarfile into your home directory.  This creates
    a "farm/" directory:

      tar -zxvf farm1.2.0.tgz

2.  Become root and do the following (replace "/home/whatever_dir" with the full
    path to your home directory):

      su -
      cd /usr/local
      ln -s /home/whatever_dir/farm ./
 
3.  Still as root, cd to the farm/dist directory:

      cd /usr/local/farm/dist

4.  Install the prerequisite packages (requires CPAN module) as root:

      ./installmods

5.  Exit from root:

      exit

6.  Change to the farm/bin directory:

     cd /usr/local/farm/bin

7.  Check the farmathome script's dependencies.  You should get a message saying
    "farmathome syntax OK":

     perl -cw farmathome

8.  Change to the farm/etc directory and read instructions for the optional config file

    cd /usr/local/farm/etc
    more config.dist

9.  Run the program: 

      Usage instructions:
         ./farmathome --help

      Basic operation:
         nohup ./farmathome --email=user@host &


That's it -- you should start seeing packets processing!
