PUTMAIL(1)

📦
version 3.21 · 8 versions
, in ubuntu stonking

💌 PUTMAIL 💌

okay bestie, so we're talking about putmail(1) — the User Commands girlie whose whole job is incorporating mail to a mailbox ✨ she's from the GNU Mailutils crew and she's got a LOT of options, so grab a strawberry drink and let's go 🍓

✨ NAME ✨

putmail — incorporates mail to a mailbox 💖

🦋 SYNOPSIS 🦋

putmail [OPTION...] [URL...]

👑 DESCRIPTION 👑

putmail -- incorporates mail to a mailbox.

(that's it. that's the whole vibe. she puts mail in mailboxes. iconic behavior, no cap 💅)

🌸 Global debugging settings 🌸

  • --debug-level=LEVEL — sets the Mailutils debugging level, so you can control how chatty the debugging gets 👀
  • --[no-]debug-line-info — shows source info alongside debugging messages (or with the no- version, doesn't ✨)
  • -M, --mailer=MAILER — uses the URL you give as the default mailer 📬

🧚 Sieve options 🧚

  • --clear-include-path — clears the Sieve include path 🧹
  • --clear-library-path, --clearpath — clears the Sieve library path 🧹 (yes bestie, two names, same slay)
  • -I, --includedir=DIR — appends DIR to the list of directories searched for include files
  • -L, --libdir=DIR — appends DIR to the list of directories searched for library files
  • --libdir-prefix=DIR — adds DIR to the beginning of the list of directories searched for library files (front of the line, main character energy 👑)

💌 Delivery options 💌

  • -f, -r, --from=EMAIL — specifies the sender's name

📜 Scripting options 📜

  • -l, --language=STRING — defines the scripting language for the next --script option
  • --message-id-header=STRING — uses this header to identify messages when logging Sieve actions
  • -s, --script=PATTERN — sets the name pattern for user-defined mail filter
  • -x, --script-debug=FLAGS — enables script debugging; the FLAGS are:
    • g — guile stack traces
    • t — sieve trace (MU_SIEVE_DEBUG_TRACE)
    • i — sieve instructions trace (MU_SIEVE_DEBUG_INSTR)
    • l — sieve action logs

🎀 Configuration handling 🎀

  • --config-file=FILE — loads this configuration file; implies --no-config (yes, she's bringing consequences)
  • --config-lint — checks configuration file syntax and exits
  • --config-verbose — verbosely logs parsing of the configuration files
  • --no-config — does NOT load site and user configuration files
  • --no-site-config — does NOT load the site-wide configuration file
  • --no-user-config — does NOT load the user configuration file
  • --set=PARAM=VALUE — sets a configuration parameter

⭐ Informational options ⭐

  • --config-help — shows a configuration file summary
  • --show-config-options — shows compilation options
  • -?, --help — gives this help list 🫶
  • --usage — gives a short usage message
  • -V, --version — prints program version
⚠️ bestie listen — mandatory or optional arguments to long options are ALSO mandatory or optional for any corresponding short options. it's giving "same rules, shorter name", periodt.

😭 REPORTING BUGS 😭

Found a bug? spill the tea to <bug-mailutils@gnu.org> 💀

Copyright © 2007-2025 Free Software Foundation, inc. License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>

This is free software: you are free to change and redistribute it.

There is NO WARRANTY, to the extent permitted by law. (not a single one. zero. nada. fr fr 😭)

🌈 SEE ALSO 🌈

The complete GNU mailutils documentation is maintained as a Texinfo manual. If the mailutils-doc package is installed, this command

info mailutils

should give you access to the complete manual ✨

You can also find this manual online in the GNU mailutils webpage: <https://www.gnu.org/software/mailutils/manual/index.html>.

🙈 Please note: this manpage was automatically generated by the Debian mailutils packagers. Do NOT file bugs for its content to the GNU Mailutils upstream authors. (they did not write this bestie, they're just the parents 💅)

and that's the whole page, babe 🫶 brought to you by FSF, dated August 2026, and yeah — this is the PUTMAIL(1) girlie signing off, stay incorporating mail into mailboxes, mwah 💖🎀🦋

📦 where this page comes from