gromox-eml2mt(8)

📦 version 3.6, in alpine 3.24

🦋 gromox-eml2mt(8) — Gromox admin reference 🦋

🌸 Name 🌸

gromox-eml2mt — Utility for analysis/importing various formats. That's the whole name, and yes it's giving "one utility, many format moods" main character energy. 👑

✨ Synopsis ✨

gromox-eml2mt [-Ppt] file.eml[...]

gromox-ical2mt [-Ppt] file.ics[...]

gromox-mbox2mt [-Ppt] file.mbox[...]

gromox-tnef2mt [-Ppt] file.tnef[...]

gromox-vcf2mt [-Ppt] file.vcf[...]

🦋 Description 🦋

okay so, the way that gromox-eml2mt works is it reads one or more RFC5322-formatted e-mail messages and re-exports the data in a Gromox-specific mailbox transfer format to stdout for consumption by pipe by the gromox-import(8) program. Each file must contain at most one RFC5322 message. 📨

When called as gromox-mbox2mt, the input is treated as RFC4155-formatted Unix mailbox. 📦

When called as gromox-ical2mt, the input is treated as RFC5545-formatted calendaring and scheduling objects (.ics). 📅

When called as gromox-vcf2mt, the input is treated as RFC4770/6530-formatted vCard objects (.vcf). 🪪

When called as gromox-tnef2mt, the input is treated as a MS-OXTNEF object. 📎

no cap, eml2mt will resolve email addresses to Gromox objects already, so the emitted data stream should be consumed by a gromox-import invocation on the same Gromox cluster. 🔗

All objects in the output stream are unanchored so that the -B option of gromox-import can be used to select placement. (Prior to Gromox 2.46, some modes like --ical and --vcard emitted an anchor.) ⚠️

💅 Options 💅

  • --decap=n — Once a MAPI message object is constructed, select attachment number n's embedded message as the "top-level" message and discard the rest of the outer message. n is 1-based. 🪄
  • --ical — Treat all file arguments as iCalendar input. This is the default if the program was invoked as gromox-ical2mt. 📅
  • --loglevel n — Maximum verbosity of general logging (not connected to -p, -t or -v). 1=crit, 2=error, 3=warn, 4=notice, 5=info, 6=debug. Default: 4 (notice). 🗣️
  • --mail — Treat all file arguments as Internet Mail input. This is the default if the program was invoked as gromox-eml2mt. 📧
  • --mbox — Treat all file arguments as Unix mboxes. This is the default if the program was invoked as gromox-mbox2mt. 📦
  • --oneoff — Do not resolve email addresses to EX addresses, but to ONEOFF instead. This way, streams created by eml2mt can be imported into other Gromox clusters that do not have the same user set. 🌍
  • --tnef — Treat all file arguments as Transport Neutral Encapsulation Format objects. This is the default if the program was invoked as gromox-tnef2mt. 📎
  • --vcard — Treat all file arguments as vCard input. This is the default if the program was invoked as gromox-vcf2mt. 🪪
  • -P — Enable super-pedantic mode when parsing VCARDs and reject everything that is not recognized. (Not recommended) 🚨
  • -p — Show properties in detail (enhances -t). Using -p twice prints properties with human-readable mnemonic names. The BIN2TXT_MODE environment variable can be set to control how binary properties are presented; possible values are "co" (C string representation with octal escapes), "cstr" (C string representation, any form), "hex" (two-hex-nibble representation), and "txt" (compact representation for light-binary text-heavy content). 🔍
  • -t — Show a diagnostic tree view of the source data as it is being read. 🌳

🌈 Examples 🌈

Import of an RFC5322 message (sometimes with .eml file extension) to drafts:

gromox-eml2mt msg.eml | gromox-import -u recipient@domain.example -B drafts

Import of calendar objects:

gromox-ical2mt meeting.ics | gromox-import -u recipient@domain.example

👑 See also 👑

gromox(7), gromox-export(8), gromox-import(8) — go read these too, bestie, they're part of the lore. 📚

💖 That's the page, bestie! Source/version: Gromox. Manual: gromox-eml2mt(8). Date: not printed in the footer, so it's giving timeless icon energy. Periodt. 💅✨

📦 where this page comes from