NAME

         exim_msgdate -  Utility to convert an exim message-id to a human readable date+time

SYNOPSIS

       exim_msgdate [ -u|--unix | --GMT | --z|-Zulu | --UTC | -l|--local ]
             [ --base 36 | --base 62 | --base36 | --base62 | --b36 | --b62 ]
             [ --pid ] [ --debug ] [ --localhost_number ]
             [ -c c<full path to exim cnfig file> ]
             exim-message-id [ | exim-message-id ...]

       exim_msgdate --help|--man

DESCRIPTION

       exim_msgdate is a tool which converts an exim message-id to a human readable form, usuall just the
       date+time, but with the --pid option the process id as well.

Message IDs:

       Three exim message ID formats are recognized.  In each case the 'X's are taken from the base (see below)
       which depends upon the platform.

       XXXXXX-XXXXXX-XX
           found in the exim logfile,

       EXXXXXX-XXXXXX-XX
           found in the Message-Id header,

       XXXXXX
           just the first six characters of the message id.

OPTIONS

   Time Zones and Unix Time
       -u | --unix
           Display time as seconds since 1 Jan 1970, the Unix Epoch.

       --GMT -u|--UTC -z|--zulu
           Display time in GMT/UTC - we assume these are the same.  Zulu time is another name for GMT.

       -l | --local
           Display time in the local time-zone.

           Do not confuse this with the --localhost_number option.

       The default is the local timezone.

   User Assistance Options
       --help
           A brief list of the options

       --man
           A more detailed manual for exim_msgdate

       --debug
           Information about what went wrong, mostly for developers.

   Specialized Options
       --base n | --base36 | --base62
           The  message-id  is usually encoded in base-62 (0-9A-Za-z), but on systems with case-insensitive file
           systems, such as MacOS and Cygwin, base-36 (0-9A-Z) is used instead.  The installation script  should
           have set the default appropriately, but these options allow the default base to be overridden.

           The default matches "exim"; in this installation it is base-62.

       --pid
           Report the process id as well as the date and time in the message-id.

       --localhost_number n
           If  the  Exim  configuration option localhost_number has been set, the third and final section of the
           message-id will include this and the timer resolution will change (see the Exim Spec.  for  details).
           "Exim_msgdate" reads the Exim config file (see --C) to find this value, but it can be overridden with
           this option.

           The  value  is  an  integer  between  0  and  16,  or  the  value  "none"  which  means  there  is no
           localhost_number.

           Do not confuse this with the --local option, which displays times in the local timezone.

       --C full path to exim configuration file
           This overrides the usual exim search path.  We set "localhost_number" from the exim configfile.

       -dexim_path
           The test harness passes the full path of the "exim" binary, or here the "exim_msgdate" being  tested.
           Not currently used.

SEE ALSO:

       exim(8)

       Exim       spec.txt       chapter       4      <https://exim.org/exim-html-current/doc/html/spec_html/ch-
       how_exim_receives_and_delivers_mail.html#SECTmessiden>

perl v5.40.1                                       2025-09-17                                    EXIM_MSGDATE(8)