INSTALLING ICBM

To run ICBM, you will need a Perl interpreter with ithreads support
(first suported in Perl-5.6.0) and the following Perl modules:

    Getopt::Long
    POSIX.pm
    Socket.pm
    Curses.pm
    Term::ANSIColor
    Term::ReadKey
    Pod::Usage
    Net::ICB

You should already have most of these if your installed Perl
distribution was anywhere even close to complete and properly
configured.  You will probably have to install Term::ANSIColor,
which can be downloaded and installed from CPAN.

Net::ICB is now bundled with icbm since there is no official
Gentoo dev-perl/Net-ICB package, and nothing I am aware of EXCEPT
icbm uses it anyway.  It should be installed in /usr/share/icb/Net.
If you choose a different location, you will need to edit the
'use lib' line at the beginning of the icbm file.

You will also need the following modules for encryption:

    Crypt::Blowfish
    Crypt::CBC
    Crypt::DH
    Digest::SHA1
    MIME::Base64
    Math::BigInt
    Math::BigInt::GMP
    Compress::Zlib

Finally, if you want to run the supplied primegen tool to generate
a new primes table (not recommended as it will break interoperability;
you should probably do this ONLY if operating on a private network),
you will need the following additional modules:

    Math::Pari
    Crypt::Random
    Crypt::Primes

Once you have all required modules installed, copy the icbm executable
to any location in your PATH.

If you already have an icbserverdb file in one of the following
locations...

    /usr/local/share/icb/icbserverdb
    /usr/local/lib/icb/icbserverdb
    /usr/local/lib/icbserverdb
    /usr/share/icb/icbserverdb
    /usr/lib/icb/icbserverdb
    /usr/lib/icbserverdb

...ICBM can use it as-is.  Copy the primes file to the same location.

If you do not have one, then create an icb directory in one of the
locations above and copy the provided icbserverdb file and primes file
there.

The icbserverdb file may also be found as $HOME/.icbserverdb, for
backwards compatibility with older ICB clients only.  In this case,
there is no corresponding permitted location for the primes file, and
it is recommended you create a shared icb directory as described above.


Finally, if you wish, create a $HOME/.icbm directory.  Optionally, copy
the provided colors file to $HOME/.icbm/colors, sample_commands to
$HOME/.icbm/commands, sample_defaults to $HOME/.icbm/defaults, and
sample_hooks to $HOME/.icbm/hooks.

You're now ready to start icbm any time you want to.  Read README.ICBM
or run icbm -man to find out the details.

Have fun!

