MHonArc v2.5 -- Appendix: Utility Programs

# Appendix: Utility Programs

This appendix describes the additional utility programs that are included in the MHonArc distribution. The utility programs are installed with mhonarc during the installation process.

- mha-dbedit
- mha-dbrecover
- mha-decode

## mha-dbedit

mha-dbedit allows modifications to be made to an archive database without regenerating any archive pages.

Typical usage:

        shell> mha-dbedit -rcfile res.mrc -outdir /path/to/archive

## mha-dbrecover

mha-dbrecover recreates an archive database from the individual message pages. This program is useful if an archive database gets corrupted, or accidentally deleted.

Typical usage:

        shell> mha-dbrecover -outdir /path/to/archive

If the archive used different resource settings from the defaults for controling filenames, then you must specify those settings when invoking mha-dbrecover. For example, if you are using "`shtml`" for HTMLEXT, then you should invoke mha-dbrecover like the following:

        shell> mha-dbrecover -htmlext shtml -outdir /path/to/archive

mha-dbrecover will only recreate non-layout message related data. If the archive had resource settings that were different than the the defaults, then those resource settings must be specified when invoking mha-dbrecover. For example:

        shell> mha-dbrecover -rcfile res.mrc -outdir /path/to/archive

## mha-decode

mha-decode is a utility program unrelated to MHonArc archives. mha-decode provides basic MIME decoding capabilites for messages.

If given mail folders as input, all messages within in the mail folders will be decoded. All message parts are written to files. If a filename is specified for a message part, that filename will be used when writing the part to a file. If no filename is specified in the message, a unique name will be used based upon the content-type of the message part.

A single message can be decoded by using the `-single` option.

Only MHonArc options that affect parsing of mail folders are applicable for mha-decode. The following options are applicable: `-conlen`, `-mhpattern`, `-msgsep`, `-noconlen`, `-outdir`, `-perlinc`, `-rcfile`, `-single`, `-umask`.

Example usage:

        shell> mha-decode inbox

Use `-outdir` to have all decoded data placed into a separate directory:

        shell> mha-decode -outdir /var/tmp inbox

And to decode a single message:

        shell> mha-decode -single msg.822

or from standard input:

        shell> some_program | mha-decode -single