.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "EXIM_MSGDATE 8"
.TH EXIM_MSGDATE 8 2024-04-07 "perl v5.38.2" EXIM4
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
.Vb 1
\&  exim_msgdate \-  Utility to convert an exim message\-id to a human readable date+time
.Ve
.SH SYNOPSIS
.IX Header "SYNOPSIS"
\&\fBexim_msgdate\fR [ \-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 ...]
.PP
\&\fBexim_msgdate\fR \-\-help|\-\-man
.SH DESCRIPTION
.IX Header "DESCRIPTION"
\&\fBexim_msgdate\fR is a tool which converts an exim message-id to a human
readable form, usuall just the date+time, but with the \fI\-\-pid\fR option
the process id as well.
.SH "Message IDs:"
.IX Header "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.
.IP XXXXXX-XXXXXX-XX 4
.IX Item "XXXXXX-XXXXXX-XX"
found in the exim logfile,
.IP EXXXXXX-XXXXXX-XX 4
.IX Item "EXXXXXX-XXXXXX-XX"
found in the Message-Id header,
.IP XXXXXX 4
.IX Item "XXXXXX"
just the first six characters of the message id.
.SH OPTIONS
.IX Header "OPTIONS"
.SS "Time Zones and Unix Time"
.IX Subsection "Time Zones and Unix Time"
.IP "\fB\-u | \-\-unix\fR" 4
.IX Item "-u | --unix"
Display time as seconds since 1 Jan 1970, the Unix Epoch.
.IP "\fB\-\-GMT\fR \fB\-u|\-\-UTC\fR \fB\-z|\-\-zulu\fR" 4
.IX Item "--GMT -u|--UTC -z|--zulu"
Display time in GMT/UTC \- we assume these are the same.
Zulu time is another name for GMT.
.IP "\fB\-l | \-\-local\fR" 4
.IX Item "-l | --local"
Display time in the local time-zone.
.Sp
Do not confuse this with the \-\-localhost_number option.
.PP
The default is the local timezone.
.SS "User Assistance Options"
.IX Subsection "User Assistance Options"
.IP \fB\-\-help\fR 4
.IX Item "--help"
A brief list of the options
.IP \fB\-\-man\fR 4
.IX Item "--man"
A more detailed manual for \fBexim_msgdate\fR
.IP \fB\-\-debug\fR 4
.IX Item "--debug"
Information about what went wrong, mostly for developers.
.SS "Specialized Options"
.IX Subsection "Specialized Options"
.IP "\fB\-\-base\fR n | \fB\-\-base36\fR | \fB\-\-base62\fR" 4
.IX Item "--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.
.Sp
The default matches \f(CW\*(C`exim\*(C'\fR; in this installation it is base\-62.
.IP \fB\-\-pid\fR 4
.IX Item "--pid"
Report the process id as well as the date and time in the message-id.
.IP "\fB\-\-localhost_number\fR n" 4
.IX Item "--localhost_number n"
If the Exim configuration option \fBlocalhost_number\fR 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).
\&\f(CW\*(C`Exim_msgdate\*(C'\fR reads the Exim config file (see \-\-C) to find this value,
but it can be overridden with this option.
.Sp
The value is an integer between 0 and 16, or the value "none" which
means there is no localhost_number.
.Sp
Do not confuse this with the \-\-local option, which displays times
 in the local timezone.
.IP "\fB\-\-C\fR \fBfull path to exim configuration file\fR" 4
.IX Item "--C full path to exim configuration file"
This overrides the usual exim search path.
We set \f(CW\*(C`localhost_number\*(C'\fR from the exim configfile.
.IP \fB\-dexim_path\fR 4
.IX Item "-dexim_path"
The test test harness passes the full path of the \f(CW\*(C`exim\*(C'\fR binary,
or here the \f(CW\*(C`exim_msgdate\*(C'\fR being tested. Not currently used.
.SH "SEE ALSO:"
.IX Header "SEE ALSO:"
\&\fBexim\fR\|(8)
.PP
Exim spec.txt chapter 4 <https://exim.org/exim-html-current/doc/html/spec_html/ch-how_exim_receives_and_delivers_mail.html#SECTmessiden>