Clarify a bit, fix up the examples somewhat, etc.

This commit is contained in:
perry 2003-02-18 02:17:38 +00:00
parent e61877243d
commit 399b25deea

View File

@ -1,4 +1,4 @@
.\" $NetBSD: mailer.conf.5,v 1.10 2003/02/17 21:18:46 is Exp $
.\" $NetBSD: mailer.conf.5,v 1.11 2003/02/18 02:17:38 perry Exp $
.\"
.\" Copyright (c) 1998
.\" Perry E. Metzger. All rights reserved.
@ -46,23 +46,31 @@ contains a series of lines of the form
.Op Ar arguments ...
.Pp
The first word of each line is the
.P name
.Pa name
of a program invoking
.Xr mailwrapper 8
which is typically a symbolic link to
.Pa /usr/sbin/sendmail .
(On a typical system,
.Xr mailwrapper 8 .
(For example, on a typical system
.Pa /usr/sbin/sendmail
would be a symbolic link to
.Xr mailwrapper 8 ,
as would
.Xr newaliases 1
and
.Xr mailq 1
would be set up this way.)
.Xr mailq 1 .
Thus,
.Pa name
might be
.Dq sendmail
or
.Dq newaliases
etc.)
.Pp
The second word of each line is the name of the
.Pa program
to actually execute when the first name is invoked.
.Pp
The further
.Pa arguments ,
.Ar arguments ,
if any, are passed to the
.Pa program ,
followed by the arguments
@ -74,13 +82,14 @@ first column of any line.
.Sh FILES
/etc/mailer.conf
.Sh EXAMPLES
The following is an example of how to set up
This example shows how to set up
.Nm
for traditional
to invoke the traditional
.Xr sendmail 8
invocation behavior.
.Bd -literal
# Execute the "real" sendmail program, named /usr/libexec/sendmail/sendmail
program:
.Bd -literal -offset indent
# Execute the "real" sendmail program located in
# /usr/libexec/sendmail/sendmail
sendmail /usr/libexec/sendmail/sendmail
send-mail /usr/libexec/sendmail/sendmail
mailq /usr/libexec/sendmail/sendmail
@ -92,16 +101,21 @@ purgestat /usr/libexec/sendmail/sendmail
This example shows how to invoke the
.Xr postfix 1
MTA suite in place of
.Xr sendmail 8 .
.Bd -literal
.Xr sendmail 8 :
.Bd -literal -offset indent
# Emulate sendmail using postfix
sendmail /usr/libexec/postfix/sendmail
send-mail /usr/libexec/postfix/sendmail
mailq /usr/libexec/postfix/sendmail
newaliases /usr/libexec/postfix/sendmail
.Ed
.Bd -literal
# Send outgoing mail to a smart relay using mini-sendmail without queueing
.Pp
This example shows the use of the mini-sendmail package from pkgsrc
in place of
.Xr sendmail 8 :
Note the use of additional arguments.
.Bd -literal -offset indent
# Send outgoing mail to a smart relay using mini-sendmail
sendmail /usr/pkg/sbin/mini-sendmail -srelayhost
send-mail /usr/pkg/sbin/mini-sendmail -srelayhost
.Ed