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 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.
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
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