Files
bongo/man/bongo-sendmail.1
Mario Fetka c8b250e9b0
Debian Trixie package bundle / packages (push) Successful in 22m11s
Implement durable C local mail submission
2026-07-24 11:05:19 +02:00

63 lines
2.2 KiB
Groff

.TH BONGO-SENDMAIL 1 "July 2026" "Bongo @BONGO_V_STR@" "Bongo mail submission"
.SH "NAME"
bongo-sendmail \(em submit a message to the local Bongo Queue
.SH "SYNOPSIS"
.PP
.B bongo-sendmail
.RI [ options ]
.SH "DESCRIPTION"
.PP
The
.B bongo-sendmail
command provides the common sendmail-compatible local submission interface.
It passes a bounded and validated request to
.BR bongopostdrop (8),
which commits it atomically to Bongo's protected local maildrop. The Queue
agent then imports the message through its normal incoming path. No Bongo
system credential and no SMTP listener are required.
.PP
.B bongo-sendmail
will continue to read input from standard input until it sees either a dot alone on a line, or reaches the end of file.
.SH "OPTIONS"
.PP
A summary of options is included below.
.TP
.BI \-r " envelope_from"
Set the sender address on the mail envelope. This is an alias for
.BR \-f .
.TP
.BI \-f " envelope_from"
Set the sender address on the mail envelope.
.TP
.BI \-F " full_name"
Supply the display name used for a generated From header when the message has
no From header.
.TP
.BR \-i
Read the entire standard input until the end of the file.
.TP
.BR \-bm
Read from standard input until a dot appears alone on a line.
.TP
.BR \-o
-oi is equivalent to -i; other arguments are ignored.
.TP
.BR \-t
Extract recipient addresses from the To, Cc, and Bcc headers. Bcc headers
and their continuations are removed from the stored message.
.SH "SECURITY"
The frontend never reads Bongo's Queue credential. The installed
.B bongopostdrop
helper is set-group-ID to the dedicated
.B bongopostdrop
group and has access only to the local maildrop directory. Maildrop records
are treated as hostile input and validated again by the Queue agent.
.SH "SEE ALSO"
.BR bongopostdrop (8),
.BR bongoqueue (8)
.SH "AUTHOR"
.PP
This manual page was originally written by Alex Hudson <home@alexhudson.com> for the
.B Debian
system (but may be used by others) and was updated by Jonny Lamb <jonnylamb@jonnylamb.com>. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 2, as published by the Free Software Foundation.