Skip to main content

chainmail forward

Forward a message to new recipients, with the original's attachments unless --no-attachments.

The new text, if any, goes above the forwarded original. The account is the one the message is on. The body and attachment options are as for send. At least one of --to, --cc and --bcc is required.

Running the same command again within 7 days reports the first forward instead of sending twice: without --idempotency-key, the key is derived from the ref, the recipients, the body and files, and --no-attachments. To send again on purpose, pass a new --idempotency-key.

--draft saves the forward to Drafts instead of sending it. --dry-run writes it as MIME to stdout, as send --dry-run does. Policy holds apply as for send.

Usage​

chainmail forward <ref> --to <address> [flags]

Examples​

chainmail forward cm1:work:INBOX:7:42 --to bob@example.com --body "FYI, see below."
chainmail forward cm1:work:INBOX:7:42 --to bob@example.com --no-attachments --draft

Flags​

      --attach stringArray       attach this file (repeatable)
      --bcc stringArray          a blind-copied recipient, kept out of the message itself (repeatable)
      --body string              the body as Markdown, or - to read it from stdin
      --body-file string         read the Markdown body from this file
      --cc stringArray           a copied recipient (repeatable)
      --draft                    save the message to Drafts instead of sending it
      --dry-run                  write the message as MIME to stdout instead of sending it
      --html-file string         send this HTML file as the body, with --body as its text part when given
      --idempotency-key string   the key that stops a repeat from sending again (default: derived from the message)
      --inline stringArray       show image file F inline where the body refers to NAME, as NAME=F (repeatable)
      --no-attachments           leave out the original's attachments
      --no-signature             leave out the account's signature
      --text                     send the body as plain text instead of Markdown
      --to stringArray           a recipient, "Name <a@b>" or "a@b" (repeatable)

Global flags​

      --output string   output format: json or table (default $CHAINMAIL_OUTPUT, then cli.toml, then table on a terminal, json otherwise)
      --socket string   daemon socket (default $CHAINMAIL_SOCKET, then cli.toml, then /run/chainmail/chainmail.sock)

See also​