Skip to content

John McEleney / mailutils

Go to a project
Toggle navigation
Toggle navigation pinning
Commit 4d8141cf 4d8141cf92b2efa977ea0f214663b79e58ba0e1b by Sergey Poznyakoff
Options

Remove mail.local and mail.remote, Maidag should be used instead. 

* mail.local: Remove.
* mail.remote: Remove.
* Makefile.am, configure.ac: Update.
* doc/texinfo/mailutils.texi: Rebuild master menu.
* doc/texinfo/programs.texi: Update.
1 parent 52284527
Inline Side-by-side
Showing 4 changed files with 1 additions and 244 deletions
......@@ -50,8 +50,6 @@ SUBDIRS = \
messages\
comsat\
readmsg\
mail.local\
mail.remote\
dotlock\
mh\
movemail\
......
......@@ -1312,10 +1312,6 @@ AC_CONFIG_FILES([Makefile
maidag/Makefile
mail/Makefile
mail/testsuite/Makefile
mail.local/Makefile
mail.local/testsuite/Makefile
mail.remote/Makefile
mail.remote/testsuite/Makefile
mailbox/Makefile
mailbox/testsuite/Makefile
messages/Makefile
......
......@@ -137,8 +137,6 @@ Mailutils Programs
* guimb:: Mailbox Scanning and Processing Language.
* maidag:: General-purpose Mail Delivery Agent.
* mail.local:: Deliver Mail to the Local Mailbox.
* mail.remote:: Pseudo-Sendmail Interface for Mail Delivery.
* mimeview:: Universal File Viewer.
......@@ -283,11 +281,6 @@ Maidag Scripting
* Sieve Maidag Filters::
* Scheme Maidag Filters::
@command{mail.local} --- Deliver Mail to the Local UNIX Mailbox
* Invocation:: Mail.local options
* Mail.local Config::
mimeview
* Mimeview Invocation::
......
......@@ -33,8 +33,6 @@ syntax.
* guimb:: Mailbox Scanning and Processing Language.
* maidag:: General-purpose Mail Delivery Agent.
* mail.local:: Deliver Mail to the Local Mailbox.
* mail.remote:: Pseudo-Sendmail Interface for Mail Delivery.
* mimeview:: Universal File Viewer.
......@@ -4667,7 +4665,7 @@ Set debugging level
@end table
The Scheme programs produced by @command{sieve.scm} can be used with
@command{guimb} or @command{mail.local}.
@command{guimb} or @command{maidag}.
@c ***********************************************************************
......@@ -5441,234 +5439,6 @@ Reuse existing address (@acronym{LMTP} mode). Default is @samp{yes}.
@end deffn
@page
@node mail.local
@section @command{mail.local} --- Deliver Mail to the Local UNIX Mailbox
@pindex mail.local
@command{Mail.local} reads the standard input up to an end-of-file
and appends the received data to the local mailboxes in @acronym{UNIX}
mailbox format. This program is superseded by @command{maidag}
(@pxref{maidag}) and will be decommissioned in future releases.
@menu
* Invocation:: Mail.local options
* Mail.local Config::
@end menu
@node Invocation
@subsection Invoking @command{mail.local}
General usage of @command{mail.local} program is:
@smallexample
mail.local [@var{option}...] @var{recipient} [@var{recipient} ...]
@end smallexample
@noindent
If recipient part is a FQDN, @command{mail.local} will attempt to
deliver to a virtual host.
@table @option
@item -f @var{addr}
@itemx --from @var{addr}
Specify the sender's name. This option forces @command{mail.local} to
add @samp{From } envelope to the beginning of the message. If it is
not specified, @command{mail.local} first looks into the first line
from the standard input. If it starts with @samp{From }, it is assumed
to contain a valid envelope. If it does not, @command{mail.local}
creates the envelope by using current user name and date.
@item -q
@itemx --quota-db @var{file}
Specify path to DBM mailbox quota database (@pxref{Mailbox Quotas}).
@item --quota-query
Specify SQL query that should be used to obtain user mailbox
quotas from the SQL database (@pxref{Mailbox Quotas}).
@item -s @var{pattern}
@itemx --source @var{pattern}
Set name pattern for user-defined mail filters written in Scheme. The
metacharacters @samp{%u} and @samp{%h} in the pattern are expanded to
the current recipient user name and home directory correspondingly.
This option is available only if the package has been configured to
use Guile extension language.
@item -S @var{pattern}
@itemx --sieve @var{pattern}
Set name pattern for user-defined mail filters written is Sieve. The
metacharacters @samp{%u} and @samp{%h} in the pattern are expanded to
the current recipient user name and home directory correspondingly.
@item -t @var{number}
@itemx --timeout @var{number}
Wait @var{number} seconds for acquiring the lockfile. If it doesn't
become available after that amount of time, return failure. The timeout
defaults to 5 minutes.
@item -x @var{flags}
@itemx --debug @var{flags}
Enable debugging. The debugging information will be output using syslog.
The @var{flags} is a string consisting of the following flags:
Debug flags are:
@table @samp
@item g
Start with guile debugging evaluator and backtraces. This is convenient
for debugging user-defined filters.
@item T
Enable libmailutil traces (@code{MU_DEBUG_TRACE}).
@item P
Enable network protocol traces (@code{MU_DEBUG_PROT})
@item t
Enable sieve trace (@code{MU_SIEVE_DEBUG_TRACE})
@item l
Enable sieve action logs
@end table
The digits in the range @samp{0} -- @samp{9} used in @var{flags} set
@command{mail.local} debugging level.
@item -v
@itemx --version
Display program version and exit.
@item --ex-multiple-delivery-success
Don't return errors when delivering to multiple recipients.
@item --ex-quota-tempfail
Return temporary failure if disk or mailbox quota is exceeded. By
default, 'service unavailable' is returned if the message exceeds
the mailbox quota.
@end table
@node Mail.local Config
@subsection Mail.local Configuration
The behavior of mail.local is affected by the following configuration
statements:
@multitable @columnfractions 0.3 0.6
@headitem Statement @tab Reference
@item debug @tab @xref{Debug Statement}.
@item mailbox @tab @xref{Mailbox Statement}.
@item locking @tab @xref{Locking Statement}.
@item pam @tab @xref{PAM Statement}.
@item sql @tab @xref{SQL Statement}.
@item virtdomain @tab @xref{Virtdomain Statement}.
@item radius @tab @xref{Radius Statement}.
@item ldap @tab @xref{LDAP Statement}.
@item auth @tab @xref{Auth Statement}.
@item mailer @tab @xref{Mailer Statement}.
@end multitable
Additionally, @command{mail.local} defines the following configuration
statements for its use:
@deffn {Mail.local Config} ex-multiple-delivery-success @var{bool}
In case of multiple delivery, exit with code 0 if at least one
delivery has succeeded.
@end deffn
@deffn {Mail.local Config} ex-quota-tempfail @var{bool}
Indicate temporary failure if the recipient is over his mail quota.
By default, permanent failure is returned.
@end deffn
@deffn {Mail.local Config} quota-db @var{file}
Set the name of DBM quota database file.
@end deffn
@deffn {Mail.local Config} sieve-filter @var{pattern}
Set file name or name pattern of the Sieve filter file.
The following meta-sequences are expanded in @var{pattern}:
@table @asis
@item ~
@itemx %h
Expands to the recipient home directory.
@item %u
Expands to the recipient user name.
@end table
@end deffn
@deffn {Mail.local Config} message-id-header @var{name}
When logging Sieve actions, identify messages by the value of this
header.
@end deffn
@deffn {Mail.local Config} guile-filter @var{pattern}
File name or name pattern for Guile filter file. See
@code{sieve-filter} above, for the description if @var{pattern}.
@end deffn
@deffn {Mail.local Config} debug @var{flags}
Set additional debugging flags. Valid flags are:
@table @asis
@item g
Print @command{guimb} stack traces.
@item t
Enable @command{sieve} trace (@code{MU_SIEVE_DEBUG_TRACE}).
@item i
Enable @command{sieve} instructions trace
(@code{MU_SIEVE_DEBUG_INSTR}).
@item l
Log executed Sieve actions.
@end table
@end deffn
@page
@node mail.remote
@section @command{mail.remote} --- Pseudo-Sendmail Interface for Mail Delivery
@pindex mail.remote
The @command{mail.remote} utility reads the standard input, which must
be formatted as an RFC-2822 email message, and forwards it to the
specified remote @acronym{SMTP} server. This utility is superseded by
@command{maidag} and will be decommissioned in future releases. For a
description of how to use @command{maidag} for remote delivery,
@ref{Remote Mailbox Delivery}.
This section provides a short overview of the @command{mail.remote}
utility.
@smallexample
$ mail.remote [@var{option}...] @var{rcpt} [@var{rcpt}...]
@end smallexample
Options are:
@table @option
@item -b @var{arg}
Ignored, for compatibility with @command{sendmail}.
@item -d
@itemx --debug
Print envelope commands in @acronym{SMTP} protocol transaction. If
specified more than once, the data part of the protocol transaction
is also printed.
@item -f @var{addr}
@itemx --from=@var{addr}
Override the default from address.
@item -i
@itemx -o @var{arg}
Ignored, for for compatibility with @command{sendmail}.
@item -t
@itemx --read-recipients
Read recipient addresses from the message headers.
@item --debug-auth
Debug authentication functions.
@end table
@page
@node mimeview
@section mimeview
@pindex mimeview
......