m4_comment([$Id: utilities.so,v 10.25 2001/03/05 19:15:07 bostic Exp $])m4_ref_title(Architecture,    Supporting utilities, @utilities, arch/script, env/intro)m4_p([dnlThe following are the standalone utilities that provide supportingfunctionality for the m4_db environment:])m4_tagbeginm4_tag(m4_ref(berkeley_db_svc), [dnlThe m4_ref(berkeley_db_svc) utility is the m4_db RPC server thatprovides standard server functionality for client applications.])m4_tag(m4_ref(db_archive), [dnlThe m4_ref(db_archive) utility supports database backup and archival,and log file administration.  It facilitates log reclamation and thecreation of database snapshots.  Generally, some form of log archivalmust be done if a database environment has been configured for loggingor transactions.])m4_tag(m4_ref(db_checkpoint), [dnlThe m4_ref(db_checkpoint) utility runs as a daemon process, monitoringthe database log and periodically issuing checkpoints.  It facilitateslog reclamation and the creation of database snapshots.  Generally, someform of database checkpointing must be done if a database environment hasbeen configured for transactions.])m4_tag(m4_ref(db_deadlock), [dnlThe m4_ref(db_deadlock) utility runs as a daemon process, periodicallytraversing the database lock structures and aborting transactions when itdetects a deadlock.  Generally, some form of deadlock detection must bedone if a database environment has been configured for locking.])m4_tag(m4_ref(db_dump), [dnlThe m4_ref(db_dump) utility writes a copy of the database to a flat-textfile in a portable format.])m4_tag(m4_ref(db_load), [dnlThe m4_ref(db_load) utility reads the flat-text file produced bym4_ref(db_dump) and loads it into a database file.])m4_tag(m4_ref(db_printlog), [dnlThe m4_ref(db_printlog) utility displays the contents of m4_db log filesin a human-readable and parsable format.])m4_tag(m4_ref(db_recover), [dnlThe m4_ref(db_recover) utility runs after an unexpected m4_db or systemfailure to restore the database to a consistent state.  Generally, someform of database recovery must be done if databases are being modified.])m4_tag(m4_ref(db_stat)  , [dnlThe m4_ref(db_stat) utility displays statistics for databases and databaseenvironments.])m4_tag(m4_ref(db_upgrade), [dnlThe m4_ref(db_upgrade) utility provides a command-line interface forupgrading underlying database formats.])m4_tag(m4_ref(db_verify), [dnlThe m4_ref(db_verify) utility provides a command-line interface forverifying the database format.])m4_tagendm4_p([dnlAll of the functionality implemented for these utilities is also availableas part of the standard m4_db API.  This means that threaded applicationscan easily create a thread that calls the same m4_db functions as do theutilities.  This often simplifies an application environment by removingthe necessity for multiple processes to negotiate database and databaseenvironment creation and shut down.])m4_page_footer