GPGMAILTUNL(1p)

💌 NAME 💌

gpgmailtunl — it wraps an email message up all cozy inside the body of another email. Encrypt it, tuck it in, send it off. Literally a whole tunnel for your mail, bestie. 🦋

---

✨ SYNOPSIS ✨

gpgmailtunl [options] --encrypt | --decrypt

---

🌸 DESCRIPTION 🌸

Okay so picture this: gpgmailtunl is a filter program. It does one of two things, and it does them slay:

• It encrypts an email message using the Gnu Privacy Guard and sends it off to another recipient, or
• It decrypts an email message and forwards it, all naked and unencrypted, to another destination.

The vibe? Exchanging emails across an open network between two systems you actually trust. 💅

---

🎀 TYPICAL USAGE 🎀

This one's made to be run by other programs — think procmail or sendmail — to build an email tunnel between two systems. Like, it's out here working behind the scenes.

And ngl, it is not as secure as using gpg as an end-user program. But it may be convenient in certain cases, and sometimes convenient is enough, iykyk. 🫶

---

🔐 ENCRYPTION 🔐

To encapsulate one email inside another, you just pipe the message into gpgmailtunl. That's it. That's the whole move. 💖

✨ OPTIONS ✨

So here's the whole options-getting situation, verbatim, iconic, untouched:

GetOptions( \%opt, "encrypt", "decrypt", "sign", "secret-file=s",
"from=s", "to=s", "subject=s", "homedir=s", "local-user=s",
"recipient=s",        )
  or usage;

And now the breakdown, one by one, no skips:

• to — the address your encrypted message gets sent to. This is the only required field, so like, do not forget it, bestie. 💀
• recipient — sets the keyid used to encrypt the outgoing message. If you leave it unset, gpgmailtunl will go hunting for a key that matches the to option.
• subject — sets the subject line of the outgoing message. Defaults to "Encrypted mail" if you don't say anything.
• from — sets the From header line of the outgoing message (the outer one, the one that contains your encrypted message inside). If you don't set it, sendmail will supply a default one for you. 🎀
• sign — use this and the outgoing message gets signed. If you're doing that, you should probably use the local-user and secret-file options too. Makes sense, right?
• secret-file — the file the secret gets read from, to unlock the private key used to sign the message. 🔑
• local-user — the keyid of the user that should sign the outgoing message. If you don't specify, the default user gets used.
• homedir — sets an alternate gpg home directory. (That's where the keyrings live, bestie. ✨)

---

🕵️ DECRYPTION 🕵️

To extract an email so it can be forwarded to its final user, you pipe the encrypted email into gpgmailtunl using the decrypt switch. Easy.

Once it's decrypted, the encapsulated email message gets sent to the original destinator of the message. 💖

✨ OPTIONS ✨

• homedir — sets an alternate gpg home directory. (Again: that's where the keyrings are stored. 📁)
• secret-file — the file the secret gets read from, to unlock the private key used to decrypt the message. 🔓

---

👑 AUTHOR 👑

Francis J. Lacoste <francis.lacoste@iNsu.COM> 🫶

---

📜 COPYRIGHT 📜

Copyright (c) 1999, 2000 iNsu Innovations Inc.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. 🌈

---

🦋 SEE ALSO 🦋

gpg(1) gpgmailtunl(1) GnuPG(3)

---

okay that's the whole page, you ate it up honestly 💅 this was gpgmailtunl(1p) from the User Contributed Perl Documentation, and your girl is living her best life on perl v5.36.0, dated 2022-10-13. slay, bye! 🎀✨