xref: /freebsd/contrib/sendmail/contrib/etrn.0 (revision aa0a1e58)
1System Administration Commands                           etrn(1M)
2
3
4NAME
5     etrn - start mail queue run
6
7SYNOPSIS
8     etrn [-v] server-host [client-hosts]
9
10DESCRIPTION
11     SMTP's  ETRN  command  allows  an  SMTP client and server to
12     interact, giving the server an opportunity to start the pro�
13     cessing  of  its  queues for messages to go to a given host.
14     This is meant to be used in start-up conditions, as well  as
15     for mail nodes that have transient connections to their ser�
16     vice providers.
17
18     The etrn utility initiates an SMTP  session  with  the  host
19     server-host  and sends one or more ETRN commands as follows:
20     If no client-hosts are specified, etrn looks up  every  host
21     name  for  which  sendmail(1M)  accepts  email and, for each
22     name, sends an ETRN command with that name as the  argument.
23     If  any  client-hosts are specified, etrn uses each of these
24     as arguments for successive ETRN commands.
25
26OPTIONS
27     The following option is supported:
28
29     -v    The normal mode of operation for etrn is to do all  of
30	   its  work  silently.   The -v option makes it verbose,
31	   which causes etrn to display  its  conversations  with
32	   the remote SMTP server.
33
34ENVIRONMENT
35     No environment variables are used.
36
37FILES
38     /etc/mail/sendmail.cf
39	   sendmail configuration file
40
41SEE ALSO
42     sendmail(1M), RFC 1985.
43
44CAVEATS
45     Not all SMTP servers support ETRN.
46
47CREDITS
48     Leveraged from David Muir Sharnoff's expn.pl script.  Chris�
49     tian von Roques added support for args and fixed a couple of
50     bugs.
51
52AVAILABILITY
53     The  latest  version  of  etrn  is  available in the contrib
54     directory of the sendmail distribution through anonymous ftp
55     at ftp://ftp.sendmail.org/ucb/src/sendmail/.
56
57AUTHOR
58     John T. Beck    <john@beck.org>
59