about summary refs log tree commit diff
path: root/man/mgenmid.1
diff options
context:
space:
mode:
authorChristian Neukirchen <chneukirchen@gmail.com>2016-08-01 17:21:39 +0200
committerChristian Neukirchen <chneukirchen@gmail.com>2016-08-01 17:21:39 +0200
commit78fec302cb21c2ecb1abc613eaa3f1fb21a32c76 (patch)
treef3315322c9094eb68ee2b48f803b82bdabffcb87 /man/mgenmid.1
parent400c6793d673c7a978178ae01d718053cdf23cb3 (diff)
downloadmblaze-78fec302cb21c2ecb1abc613eaa3f1fb21a32c76.tar.gz
mblaze-78fec302cb21c2ecb1abc613eaa3f1fb21a32c76.tar.xz
mblaze-78fec302cb21c2ecb1abc613eaa3f1fb21a32c76.zip
add mgenmid
Diffstat (limited to 'man/mgenmid.1')
-rw-r--r--man/mgenmid.158
1 files changed, 58 insertions, 0 deletions
diff --git a/man/mgenmid.1 b/man/mgenmid.1
new file mode 100644
index 0000000..8cf2d96
--- /dev/null
+++ b/man/mgenmid.1
@@ -0,0 +1,58 @@
+.Dd August 1, 2016
+.Dt MGENMID 1
+.Os
+.Sh NAME
+.Nm mgenmid
+.Nd generate a Message-ID
+.Sh SYNOPSIS
+.Nm
+.Sh DESCRIPTION
+.Nm
+generates a fresh Message-ID and prints it.
+The Message-ID consists of a timestamp,
+a random value,
+and a fully qualified domain name.
+.Pp
+The fully qualified domain name is computed by:
+.Bl -enum
+.It
+Using
+.Sq Li "FQDN:"
+from
+.Pa "~/.santoku/profile"
+(if set).
+.It
+Resolving the current hostname.
+.It
+Using the host part of the address in
+.Sq Li "Local-Mailbox:"
+from
+.Pa "~/.santoku/profile"
+(if set).
+.El
+.Pp
+If these steps don't result in a fully qualified domain name,
+.Nm
+fails.
+.Sh EXIT STATUS
+.Ex -std
+.Sh SEE ALSO
+.Rs
+.%A M. Curtin
+.%A J. Zawinski
+.%D July 1998
+.%R draft-ietf-usefor-message-id-01.txt
+.%T Recommendations for generating Message IDs
+.Re
+.Sh AUTHORS
+.An Christian Neukirchen Aq Mt chneukirchen@gmail.com
+.Sh LICENSE
+.Nm
+is in the public domain.
+.Pp
+To the extent possible under law,
+the creator of this work
+has waived all copyright and related or
+neighboring rights to this work.
+.Pp
+.Lk http://creativecommons.org/publicdomain/zero/1.0/