This is the 2.1 ColdCore.

           ** THIS IS NOT IN THE VALID GENESIS 1.0 TEXT FORMAT **

I am releasing this core for developmental purposes only, it should NOT be
used to build upon, if you find problems, please let us know so we can
update them on the Cold Dark (where the core comes from).  Any requests for
help in upgrading from this core to the 1.0 Genesis format will be summarily
ignored, I dont have the time to do it, sorry!

A 1.0 Genesis formatted ColdCore will be made available as soon as Genesis
can handle the format.

dumpsplit
=========

The db is currently in a single file named 'coldcore'.  You can split this
into seperate files with the 'dumpsplit' perl script.  To do this type:

    dumpsplit -s coldcore

This will create a subdirectory 'src', where it will write the files.  You
can unsplit a core by typing:

    dumpsplit -u

Since 'src' is the default source directory, this should work ok.  It will
write the unsplit core to 'textdump' (the default dump format).  Type
'dumpsplit' without arguments to get a usage description.

dumpbreak
=========

If you simply want to edit the core before compiling it, but you are unable
to because there are lines too long for your buffer, break the lines with
'dumpbreak'.  To do this type:

    dumpbreak -b coldcore > coldcore.broken

And to unbreak it type:

    dumpbreak -u coldcore.broken > coldcore

dumpdb (textdumping)
====================

The 'dumpdb' script is used in sync with $sys.dump_db().  Executing
dumpdb should connect you the server as 'dumpguest' (a $guest).  Get
the connection of this guest and pass it to $sys.dump_db().  If you
have a noisy system it is suggested to block out .tell() and .ptell()
on dumpguest.  As an admin you could type:

-------
@program dump.tell
arg [args];
.
@program dump.ptell
arg [args];
.
@as $sys eval .dump_db($user_dumpguest.connections()[1]);

(wait until it returns)

/log names

@as $sys eval $user_me.tell(.dump_names());

/log off
-------

It is in this crufty format for now, until all of the file functions
are online.

Running the core
================

To compile the db you can either use:

    coldcc -t coldcore

Or you can move 'coldcore' to 'textdump'.

To run the db after compiling it with coldcc, simply type genesis (if you 
are in the base directory).  I would suggest typing -h with both executables
to find their usages.  When Genesis 1.0 is available there will be a
'control' executable which will handle compiling and execution of the driver.

------------------

-Brandon Gillespie