IMPUT(1p)

πŸ“¦
version 153 Β· 2 versions
, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble

πŸ’Œ IMPUT(1p) β€” put mail/news message into networks πŸ’Œ

okay so bestie, welcome to imput β€” part of IM (Internet Message), the Internet Message commands crew. This is the little program that yeets your mail and news posts out into the world. Let's get into it πŸ’–


✨ NAME ✨

imput β€” put mail/news message into networks πŸ¦‹


🌸 SYNOPSIS 🌸

imput [OPTIONS] [MSG]

πŸ’… DESCRIPTION πŸ’…

So the imput command dispatches your mail/news message by way of SMTP/NNTP. That's the whole vibe. πŸ“¨

This command is provided by IM (Internet Message).

Now here's the part where you gotta wire it up depending on what mail thing you're using, and honestly it's giving "plug it in and slay":

πŸŽ€ With UCB Mail

Define the "sendmail" environment variable with value "imput".

πŸŽ€ With Mew 1.x

Eval (setq mew-prog-imput "imput").

πŸŽ€ With MH

Define sendproc in ~/.mh_profile like "sendproc: imput".

πŸŽ€ With sendmail.el (if you are using VM or ...)

Eval (setq sendmail-program "imput").

πŸŽ€ With mh-e (4 or later)

Eval (setq mh-send-prog "imput").

πŸŽ€ With pine

Define "sendmail-path" in ~/.pinerc, for example:

sendmail-path=/usr/local/bin/imput -Report -ObeyHeader -IgnoreDot

πŸŽ€ With applications which use sendmail

Replace sendmail to this program β€” but if daemon sendmail is required, original sendmail should be renamed to sendmail.bin or something else for starting daemon mode sendmail and for newaliasing. πŸ‘‘

πŸŽ€ With applications which use inews

Header generation by command line option not supported. Yeah, that's just not a thing here, sorry bestie. 😭


⭐ OPTIONS ⭐

Okay this is the big one. Every single flag, no skips, we're eating the whole plate πŸ“

  • --version β€” Output version information and exit.
  • --help β€” Display help message and exit.
  • --debug={on,off} β€” Set all debug options.
  • --debugflag=DEBUG_OPTION β€” Set specific debug options (separated with ,).
  • --verbose={on,off} β€” Print verbose messages when running.
  • --require=STRING β€” User defined perl script to be required.
  • --smtpservers=STRING β€” List of SMTP servers (separated with ,).

Each element should be server[/remote_port][%local_port]

  • --emgsmtpsvrs=STRING β€” List of SMTP servers for Emergency Use (i.e. error reporting).
  • --trynextonfatal={on,off} β€” Try next SMTP server even if permanent failure.
  • --nntpservers=STRING β€” List of NNTP servers (separated with ,).

Each element should be server[/remote_port][%local_port]

  • --nntpauthuser=STRING β€” User name for NNTP authentication.
  • --clientname=STRING β€” Name as a SMTP client (used for SMTP HELO).
  • --sshserver=STRING β€” SSH port relay server.
  • --obeymtadomain={on,off} β€” Do not qualify local addresses with default domain.
  • --fromdomain=STRING β€” Default domain name for sender.
  • --todomain=STRING β€” Default domain name for recipients.
  • --msgiduser=STRING β€” A user name for Message-Id generation.
  • --msgiddomain=STRING β€” A domain name for Message-Id generation.
  • --nomsgidfornews=STRING β€” Strip Message-Id when posting to news system.
  • --user=STRING β€” Local part of the sender address.
  • --address=STRING β€” Address used in From: header; equivalent to User@FromDomain
  • --name=STRING β€” Commentary name for sender.
  • --nameincomment={on,off} β€” Show commentary name in () on From: header.
  • --org=STRING β€” Name of organization for news posting.
  • --subj=STRING β€” A string for subject field.
  • --nscmpl={on,off} β€” Use domain-part completion with nameserver.
  • --showrcpts={on,off} β€” Allow to show recipients in header as To: if no To: in original.
  • --metoo={on,off} β€” Request DCC to me.
  • --dcc=STRING β€” Supplemental DCC address.
  • --fcc=STRING β€” Folder name to save FCC.
  • --receipt={on,off} β€” Need a report of successful delivery.
  • --group=STRING β€” Newsgroup names to be posted in.
  • --jpconv={on,off} β€” Convert japanese character encoding from EUC/SJIS to JIS.
  • --defcode=STRING β€” Default classification of japanese character code (EUC/SJIS/8BIT). Default value is "8bit".
  • --jpheader={on,off} β€” Encode japanese JIS characters to MIME style at header. Default value is "on".
  • --hdrqencoding={on,off} β€” Header encoding type: 0 is B; 1 is Q.
  • --nohdrfolding={on,off} β€” Do not fold long header lines.
  • --sortheader=STRING β€” Header sequence for sorting (labels separated with ,).
  • --8to7={on,off} β€” Convert 8bit body to 7bit by base64/quoted-printable encoding.
  • --8bitlabel=STRING β€” Sub-type label for unknown 8bit body on Content-Type:. Default value is "unknown-8bit".
  • --lines=NUM β€” Line numbers for splitting into partial messages.
  • --sleep=NUM β€” Sleep interval for dispatching each splitted messages. Default value is 10.
  • --log=STRING β€” File name to write delivery log. Default value is "putlog".
  • --syslog={on,off} β€” Use SYSLOG feature instead of writing to a file directly.
  • --report={on,off} β€” Report errors via mail. Default value is "on".
  • --msgid={on,off} β€” Generate Message-Id header line. Default value is "on".
  • --pidmsgid={on,off} β€” Generate Message-Id with Process ID.
  • --uidmsgid={on,off} β€” Generate Message-Id with User ID instead of login name.
  • --date={on,off} β€” Generate Date header line. Default value is "on".
  • --newsgmtdate={on,off} β€” Generate date field in GMT for posting news.
  • --uselines={on,off} β€” Generate Lines header line. Default value is "on".
  • --aliasesfile=STRING β€” List of files for mail address aliasing. Default value is "Aliases".
  • --addrbook=STRING β€” List of Addrbook files.
  • --hostaliases=STRING β€” List of files for domain part completion.
  • --fccpartial={on,off} β€” Save FCC with partial format.
  • --dead=STRING β€” Path of file to save unsent message as a deadletter. Default value is "dead.letter".
  • --justqueuing={on,off} β€” Just store message into queue without attempt of delivery.
  • --queuing={on,off} β€” Store message into queue on delivery failure.
  • --processqueue={on,off} β€” Process queued messages.
  • --queuestatus={on,off} β€” Show list of queued messages.
  • --folder=STRING β€” Path of draft folder directory.
  • --mimebcc={on,off} β€” Use MIME (message/rfc822) style BCC. Default value is "on".
  • --trashmark=STRING β€” Prefix character for draft message file renaming. Default value is "#".
  • --preserve={on,off} β€” Preserve draft message as is even if dispatched successfully.
  • --message=STRING β€” Path/name of draft message.
  • --pgpsign={on,off} β€” Generate PGP signature for body-part.
  • --multipartadd=STRING,STRING... β€” Path/name of message to be added as a part of multipart message.
  • --filenameadd={on,off} β€” Add filename field at Content-Disposition header.
  • --smtp={on,off} β€” Perform SMTP style input mode.
  • --annotate={on,off} β€” Annotate on the parent message (MsgDB required).
  • --dist={on,off} β€” Redistribution mode (using Resent-*:).
  • --distmsg=STRING β€” Path of message for redistribution.
  • --obeyheader={on,off} β€” Collect recipients from message header.
  • --ignoredot={on,off} β€” Ignore DOT for message termination.
  • --newscheck={on,off} β€” No news posting if To, Cc header found even if Newsgroups: exists.
  • --esmtp={on,off} β€” Enforce ESMTP (always begins with EHLO).
  • --newspost={on,off} β€” Enable NNTP. Default value is "on".
  • --addheader=STRING,STRING... β€” Header lines to be added.

🫢 For compatibility with the send command (provided by MH/nmh) 🫢

These ones exist purely so your MH/nmh-adjacent muscle memory doesn't betray you. Here they all are, verbatim, every single one:

-mime
-nomime
-msgid
-nomsgid
-watch
-nowatch
-verbose
-noverbose
-draftmessage=<string>
-draftf=<string>
-draftfolder=<string>
-nodraftfolder
-draftm=<string>
-draft
-alias=<string>
-aliasesfile=<string>
-filter=<string>
-nofilter
-format
-noformat
-forward
-noforward
-push
-nopush
-width=<num>
-split=<num>
-version
-help
-hencode
-nohencode
-library=<string>
-server=<string>
-client=<string>
-bs
-f=<string>
-t
-v
-odb
-odi
-oem
-oi
-i
-om
-m
-odq
-q
-bp
-J
-h
-s=<string>

IM (Internet Message) is copyrighted by IM developing team. You can redistribute it and/or modify it under the modified BSD license. See the copyright file for more details.


and that's the whole page, bestie πŸ’– go forth and dispatch your mail, no cap 🌈✨

this was IM153, dated 2016-10-10, and it lives in section IMPUT(1p) of your friendly neighbourhood manual πŸŽ€ mwah πŸ’…

πŸ“¦ where this page comes from