xref: /freebsd/contrib/sendmail/src/helpfile (revision d39bd2c1388b520fcba9abed1932acacead60fba)
106f25ae9SGregory Neil Shapiro#vers	2
206f25ae9SGregory Neil Shapirocpyr
35dd76dd0SGregory Neil Shapirocpyr	Copyright (c) 1998-2000, 2002, 2004-2007 Proofpoint, Inc. and its suppliers.
406f25ae9SGregory Neil Shapirocpyr	    All rights reserved.
506f25ae9SGregory Neil Shapirocpyr	Copyright (c) 1983, 1995-1997 Eric P. Allman.  All rights reserved.
606f25ae9SGregory Neil Shapirocpyr	Copyright (c) 1988, 1993
706f25ae9SGregory Neil Shapirocpyr	    The Regents of the University of California.  All rights reserved.
806f25ae9SGregory Neil Shapirocpyr
906f25ae9SGregory Neil Shapirocpyr
1006f25ae9SGregory Neil Shapirocpyr	By using this file, you agree to the terms and conditions set
1106f25ae9SGregory Neil Shapirocpyr	forth in the LICENSE file which can be found at the top level of
1206f25ae9SGregory Neil Shapirocpyr	the sendmail distribution.
1306f25ae9SGregory Neil Shapirocpyr
1406f25ae9SGregory Neil Shapirosmtp	This is sendmail version $v
1506f25ae9SGregory Neil Shapirosmtp	Topics:
1606f25ae9SGregory Neil Shapirosmtp		HELO	EHLO	MAIL	RCPT	DATA
1706f25ae9SGregory Neil Shapirosmtp		RSET	NOOP	QUIT	HELP	VRFY
1806f25ae9SGregory Neil Shapirosmtp		EXPN	VERB	ETRN	DSN	AUTH
1906f25ae9SGregory Neil Shapirosmtp		STARTTLS
2006f25ae9SGregory Neil Shapirosmtp	For more info use "HELP <topic>".
21af9557fdSGregory Neil Shapirosmtp	To report bugs in the implementation see
22af9557fdSGregory Neil Shapirosmtp		http://www.sendmail.org/email-addresses.html
2306f25ae9SGregory Neil Shapirosmtp	For local information send email to Postmaster at your site.
2406f25ae9SGregory Neil Shapirohelp	HELP [ <topic> ]
2506f25ae9SGregory Neil Shapirohelp		The HELP command gives help info.
2606f25ae9SGregory Neil Shapirohelo	HELO <hostname>
2706f25ae9SGregory Neil Shapirohelo		Introduce yourself.
2806f25ae9SGregory Neil Shapiroehlo	EHLO <hostname>
2906f25ae9SGregory Neil Shapiroehlo		Introduce yourself, and request extended SMTP mode.
3006f25ae9SGregory Neil Shapiroehlo	Possible replies include:
3106f25ae9SGregory Neil Shapiroehlo		SEND		Send as mail			[RFC821]
3206f25ae9SGregory Neil Shapiroehlo		SOML		Send as mail or terminal	[RFC821]
3306f25ae9SGregory Neil Shapiroehlo		SAML		Send as mail and terminal	[RFC821]
3406f25ae9SGregory Neil Shapiroehlo		EXPN		Expand the mailing list		[RFC821]
3506f25ae9SGregory Neil Shapiroehlo		HELP		Supply helpful information	[RFC821]
3606f25ae9SGregory Neil Shapiroehlo		TURN		Turn the operation around	[RFC821]
3706f25ae9SGregory Neil Shapiroehlo		8BITMIME	Use 8-bit data			[RFC1652]
3806f25ae9SGregory Neil Shapiroehlo		SIZE		Message size declaration	[RFC1870]
3906f25ae9SGregory Neil Shapiroehlo		VERB		Verbose				[Allman]
4006f25ae9SGregory Neil Shapiroehlo		BINARYMIME	Binary MIME			[RFC1830]
4106f25ae9SGregory Neil Shapiroehlo		PIPELINING	Command Pipelining		[RFC1854]
4206f25ae9SGregory Neil Shapiroehlo		DSN		Delivery Status Notification	[RFC1891]
4306f25ae9SGregory Neil Shapiroehlo		ETRN		Remote Message Queue Starting	[RFC1985]
4406f25ae9SGregory Neil Shapiroehlo		STARTTLS	Secure SMTP			[RFC2487]
4506f25ae9SGregory Neil Shapiroehlo		AUTH		Authentication			[RFC2554]
4606f25ae9SGregory Neil Shapiroehlo		ENHANCEDSTATUSCODES	Enhanced status codes	[RFC2034]
4740266059SGregory Neil Shapiroehlo		DELIVERBY	Deliver By			[RFC2852]
48*d39bd2c1SGregory Neil Shapiroehlo		SMTPUTF8	Internationalized Email		[RFC6530]
494e4196cbSGregory Neil Shapiromail	MAIL From:<sender> [ <parameters> ]
5006f25ae9SGregory Neil Shapiromail		Specifies the sender.  Parameters are ESMTP extensions.
5106f25ae9SGregory Neil Shapiromail		See "HELP DSN" for details.
524e4196cbSGregory Neil Shapirorcpt	RCPT To:<recipient> [ <parameters> ]
5306f25ae9SGregory Neil Shapirorcpt		Specifies the recipient.  Can be used any number of times.
5406f25ae9SGregory Neil Shapirorcpt		Parameters are ESMTP extensions.  See "HELP DSN" for details.
5506f25ae9SGregory Neil Shapirodata	DATA
5606f25ae9SGregory Neil Shapirodata		Following text is collected as the message.
57*d39bd2c1SGregory Neil Shapirodata		End with a single dot on a line by itself.
5806f25ae9SGregory Neil Shapirorset	RSET
5906f25ae9SGregory Neil Shapirorset		Resets the system.
6006f25ae9SGregory Neil Shapiroquit	QUIT
6106f25ae9SGregory Neil Shapiroquit		Exit sendmail (SMTP).
6206f25ae9SGregory Neil Shapiroauth	AUTH mechanism [initial-response]
6306f25ae9SGregory Neil Shapiroauth		Start authentication.
6406f25ae9SGregory Neil Shapirostarttls	STARTTLS
6506f25ae9SGregory Neil Shapirostarttls		Start TLS negotiation.
6606f25ae9SGregory Neil Shapiroverb	VERB
6706f25ae9SGregory Neil Shapiroverb		Go into verbose mode.  This sends 0xy responses that are
682fb4f839SGregory Neil Shapiroverb		not RFC821 standard (but should be).  They are recognized
6906f25ae9SGregory Neil Shapiroverb		by humans and other sendmail implementations.
7006f25ae9SGregory Neil Shapirovrfy	VRFY <recipient>
7106f25ae9SGregory Neil Shapirovrfy		Verify an address.  If you want to see what it aliases
7206f25ae9SGregory Neil Shapirovrfy		to, use EXPN instead.
7306f25ae9SGregory Neil Shapiroexpn	EXPN <recipient>
7406f25ae9SGregory Neil Shapiroexpn		Expand an address.  If the address indicates a mailing
7506f25ae9SGregory Neil Shapiroexpn		list, return the contents of that list.
7606f25ae9SGregory Neil Shapironoop	NOOP
7706f25ae9SGregory Neil Shapironoop		Do nothing.
7806f25ae9SGregory Neil Shapirosend	SEND FROM:<sender>
7906f25ae9SGregory Neil Shapirosend		replaces the MAIL command, and can be used to send
8006f25ae9SGregory Neil Shapirosend		directly to a users terminal.  Not supported in this
8106f25ae9SGregory Neil Shapirosend		implementation.
8206f25ae9SGregory Neil Shapirosoml	SOML FROM:<sender>
8306f25ae9SGregory Neil Shapirosoml		Send or mail.  If the user is logged in, send directly,
8406f25ae9SGregory Neil Shapirosoml		otherwise mail.  Not supported in this implementation.
8506f25ae9SGregory Neil Shapirosaml	SAML FROM:<sender>
8606f25ae9SGregory Neil Shapirosaml		Send and mail.  Send directly to the user's terminal,
8706f25ae9SGregory Neil Shapirosaml		and also mail a letter.  Not supported in this
8806f25ae9SGregory Neil Shapirosaml		implementation.
8906f25ae9SGregory Neil Shapiroturn	TURN
9006f25ae9SGregory Neil Shapiroturn		Reverses the direction of the connection.  Not currently
9106f25ae9SGregory Neil Shapiroturn		implemented.
924e4196cbSGregory Neil Shapiroetrn	ETRN [ <hostname> | @<domain> | \#<queuename> ]
9306f25ae9SGregory Neil Shapiroetrn		Run the queue for the specified <hostname>, or
9406f25ae9SGregory Neil Shapiroetrn		all hosts within a given <domain>, or a specially-named
9506f25ae9SGregory Neil Shapiroetrn		<queuename> (implementation-specific).
96af9557fdSGregory Neil Shapirodsn	MAIL From:<sender> [ RET={ FULL | HDRS} ] [ ENVID=<envid> ]
97af9557fdSGregory Neil Shapirodsn	RCPT To:<recipient> [ NOTIFY={NEVER,SUCCESS,FAILURE,DELAY} ]
9806f25ae9SGregory Neil Shapirodsn			     [ ORCPT=<recipient> ]
9906f25ae9SGregory Neil Shapirodsn		SMTP Delivery Status Notifications.
10006f25ae9SGregory Neil Shapirodsn	Descriptions:
10106f25ae9SGregory Neil Shapirodsn		RET	Return either the full message or only headers.
10206f25ae9SGregory Neil Shapirodsn		ENVID	Sender's "envelope identifier" for tracking.
10306f25ae9SGregory Neil Shapirodsn		NOTIFY	When to send a DSN. Multiple options are OK, comma-
10406f25ae9SGregory Neil Shapirodsn			delimited. NEVER must appear by itself.
10506f25ae9SGregory Neil Shapirodsn		ORCPT	Original recipient.
10606f25ae9SGregory Neil Shapiro-bt	Help for test mode:
10706f25ae9SGregory Neil Shapiro-bt	?		 :this help message.
10806f25ae9SGregory Neil Shapiro-bt	.Dmvalue	 :define macro `m' to `value'.
10906f25ae9SGregory Neil Shapiro-bt	.Ccvalue	 :add `value' to class `c'.
11006f25ae9SGregory Neil Shapiro-bt	=Sruleset	 :dump the contents of the indicated ruleset.
11106f25ae9SGregory Neil Shapiro-bt	=M		 :display the known mailers.
11206f25ae9SGregory Neil Shapiro-bt	-ddebug-spec	 :equivalent to the command-line -d debug flag.
11306f25ae9SGregory Neil Shapiro-bt	$$m		 :print the value of macro $$m.
11406f25ae9SGregory Neil Shapiro-bt	$$=c		 :print the contents of class $$=c.
11506f25ae9SGregory Neil Shapiro-bt	/mx host	 :returns the MX records for `host'.
1162fb4f839SGregory Neil Shapiro-bt	/gethostbyname host [family]  :calls gethostbyname() for `host'.
1172fb4f839SGregory Neil Shapiro-bt	/dnslookup host [qtype] [flags]	 :Does a qtype DNS lookup for `host'.
11806f25ae9SGregory Neil Shapiro-bt	/parse address	 :parse address, returning the value of crackaddr, and
11906f25ae9SGregory Neil Shapiro-bt			  the parsed address.
1202fb4f839SGregory Neil Shapiro-bt	/sender address	 :parse sender address, returning the value of
1212fb4f839SGregory Neil Shapiro-bt			  setsender.
1222fb4f839SGregory Neil Shapiro-bt	/expand string	 :expands string, returning the value of expand.
12306f25ae9SGregory Neil Shapiro-bt	/try mailer addr :rewrite address into the form it will have when
12406f25ae9SGregory Neil Shapiro-bt			  presented to the indicated mailer.
12506f25ae9SGregory Neil Shapiro-bt	/tryflags flags	 :set flags used by parsing.  The flags can be `H' for
12606f25ae9SGregory Neil Shapiro-bt			  Header or `E' for Envelope, and `S' for Sender or `R'
12706f25ae9SGregory Neil Shapiro-bt			  for Recipient.  These can be combined, `HR' sets
12806f25ae9SGregory Neil Shapiro-bt			  flags for header recipients.
12906f25ae9SGregory Neil Shapiro-bt	/canon hostname	 :try to canonify hostname.
13006f25ae9SGregory Neil Shapiro-bt	/map mapname key :look up `key' in the indicated `mapname'.
1312fb4f839SGregory Neil Shapiro-bt	/header header	 :parses header, returning header flags
13206f25ae9SGregory Neil Shapiro-bt	/quit		 :quit address test mode.
13306f25ae9SGregory Neil Shapiro-bt	rules addr	 :run the indicated address through the named rules.
13406f25ae9SGregory Neil Shapiro-bt			  Rules can be a comma separated list of rules.
13506f25ae9SGregory Neil Shapirocontrol	Help for smcontrol:
13606f25ae9SGregory Neil Shapirocontrol	help		This message.
13706f25ae9SGregory Neil Shapirocontrol	restart		Restart sendmail.
13806f25ae9SGregory Neil Shapirocontrol	shutdown	Shutdown sendmail.
13906f25ae9SGregory Neil Shapirocontrol	status		Show sendmail status.
140d0cef73dSGregory Neil Shapirocontrol	mstat		Show sendmail status (machine readable format).
141605302a5SGregory Neil Shapirocontrol	memdump		Dump allocated memory list (for debugging only).
142