Diagnostics

Three types of messages exist in MHonarc: Informative messages, Warnings, and Errors. Informative messages give you the current status of MHonarc's execution. Warnings signify undesired conditions, but are not critical in MHonarc's exection. Errors signify critical conditions that inhibit MHonarc from finishing its task.

This section describes the various diagnostics MHonarc may produce.

       

Informative messages

Informative messages may be suppressed via the -quiet command-line option. Only the more important Informative messages are listed here.

       

Could not process message with given Content-Type: ...

MHonarc will output this statement in filtered mail messages for content-types it is unable to process. See Default Filters in MIME for content-types that MHonarc supports by default. See Writing Filters for adding new filters into MHonarc.

This is the only Informative message that does not go to standard output, but into the actual filtered mail message.

No new messages

No mail messages exist when performing an add operation to an archive. This can occur if an empty MH mail folder, or empty mailbox file, is passed to MHonarc.

Requiring MIME filter libraries ...

Indicates MHonarc is loading external libraries for filtering mail messages. MHonarc will output each library it loads. See MIME for more information of filter libraries.

Trying to lock mail archive ...

The statement means that a lock file is in place for the archive you are trying to update. Normally, an existing lock file implies that another MHonarc process is currently using the archive, and other MHonarc processes will wait awhile to see if the archive will be unlocked.

However, there are times when a lock file exists, but no MHonarc process is modifying the archive. This can occur if MHonarc is abnormally terminated. If you know that no other MHonarc process is editting the archive you are try to modify, then manually remove the lock file and rerun MHonarc.

See Archive Integrity for more information.

       

Warnings

       

Warning: Could not find date for message

MHonarc was unable to find a received/sent date for a mail message. With respect to other mail messages, a message with no received/sent date is first in chronological order.

Warning: Database version (<dbversion>) does not match program version ...

Indicates that the version of MHonarc updating an archive is different from the version of MHonarc that created the database file for an archive. Problems can arise if the database file changes in format from different version of MHonarc. See the release notes of the MHonarc distribution if changes in the databse format has effects on older archives.

Warning: Unable to create <outdir>/<dbfile>

Indicates MHonarc was unable to create the database file <dbfile> for the mail archive created/modified in <outdir>. This message can occur if <outdir> permissions changed during MHonarc execution, the existing <dbfile> is read-only, or the file system is full.

This message can be severe because no future add operations can be performed to the archive.

Warning: Unable to open footer: <footer>

MHonarc was unable to open the footer file, <footer>, for inclusion into the index page. Make sure <footer> exists, and is readable by you.

Warning: Unable to open header: <header>

MHonarc was unable to open the header file, <header>, for inclusion into the index page. Make sure <header> exists, and is readable by you.

Warning: Unable to open mail folder: <folder>

MHonarc was unable to open the specified MH mail <folder> for reading. Make sure <folder> exists and is readable, and executable by you.

Warning: Unable to open mailbox: <mbox>

MHonarc was unable to open the specified <mbox> for reading. Make sure <mbox> exists and is readable by you.

Warning: Unable to open message: <folder>/<message>

MHonarc was unable to open the specified MH mail message <folder>/<message> for reading. Make sure <folder>/<message> exists and is readable by you.

Warning: Undefined time zone: "<timezone>"

MHonarc has found an unrecognized timezone acronym, <timezone>, in a mail message. You can tell MHonarc about other timezone acronyms, and their hour offset to UTC, by using the TIMEZONES resource element of the Resource File.

The timezone UTC (or GMT) is used for an undefined timezone acronym

       

Errors

       

ERROR: Unable to create <file>

MHonarc was unable to create <file>. This message can occur if the directory being written to is not writable, a read-only file with the same name exists, or the file system is full.

ERROR: Unable to open resource file: <file>

MHonarc was unable to open the resource file, <file>, for reading. Make sure <file> exists, and is readable by you.

ERROR: Unable to open <file>

MHonarc was unable to open <file> for reading. Make sure <file> exists, and is readable by you.

ERROR: Unable to require base64.pl

The base64.pl library is needed for MHonarc to decode Base64 encoded messages. base64.pl is part of the MHonarc distribution. Make sure you properly installed MHonarc via the installation program. See also the PERLINC resource element.

ERROR: Unable to require newgetopt.pl

The newgetopt.pl library is needed for MHonarc to parse the command-line. newgetopt.pl is part of the standard Perl distribution. Make sure Perl has been correctly installed at your site.

ERROR: Unable to require qprint.pl

The qprint.pl library is needed for MHonarc to decode Quoted-Printable encoded messages. qprint.pl is part of the MHonarc distribution. Make sure you properly installed MHonarc via the installation program. See also the PERLINC resource element.

ERROR: Unable to require timelocal.pl

The timelocal.pl library is needed for MHonarc to process dates in messages. timelocal.pl is part of the standard Perl distribution. Make sure Perl has been correctly installed at your site.

ERROR: Unable to require <file>

This message signifies MHonarc was unable to require the MIME filter library <file>. Make sure you properly installed MHonarc via the installation program. If <file> is your own custom filter, make sure you properly registered it in the Resource File. See also Specifying Filters and the PERLINC resource element.

ERROR: Unrecognized mode

This indicates an internal error in MHonarc. Make sure no one has modified the MHonarc source code. Contact the author of MHonarc if you get this message.

       

[Prev:Notes]
[ToC]


MHonArc 1.0.0 -- Diagnostics