xref: /freebsd/contrib/sendmail/src/helpfile (revision 5dd76dd0cc19450133aa379ce0ce4a68ae07fb39)
106f25ae9SGregory Neil Shapiro#vers	2
206f25ae9SGregory Neil Shapirocpyr
3*5dd76dd0SGregory 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
14*5dd76dd0SGregory Neil Shapirocpyr	$$Id: helpfile,v 8.49 2013/11/22 20:51:55 ca Exp $$
1506f25ae9SGregory Neil Shapirocpyr
1606f25ae9SGregory Neil Shapirosmtp	This is sendmail version $v
1706f25ae9SGregory Neil Shapirosmtp	Topics:
1806f25ae9SGregory Neil Shapirosmtp		HELO	EHLO	MAIL	RCPT	DATA
1906f25ae9SGregory Neil Shapirosmtp		RSET	NOOP	QUIT	HELP	VRFY
2006f25ae9SGregory Neil Shapirosmtp		EXPN	VERB	ETRN	DSN	AUTH
2106f25ae9SGregory Neil Shapirosmtp		STARTTLS
2206f25ae9SGregory Neil Shapirosmtp	For more info use "HELP <topic>".
23af9557fdSGregory Neil Shapirosmtp	To report bugs in the implementation see
24af9557fdSGregory Neil Shapirosmtp		http://www.sendmail.org/email-addresses.html
2506f25ae9SGregory Neil Shapirosmtp	For local information send email to Postmaster at your site.
2606f25ae9SGregory Neil Shapirohelp	HELP [ <topic> ]
2706f25ae9SGregory Neil Shapirohelp		The HELP command gives help info.
2806f25ae9SGregory Neil Shapirohelo	HELO <hostname>
2906f25ae9SGregory Neil Shapirohelo		Introduce yourself.
3006f25ae9SGregory Neil Shapiroehlo	EHLO <hostname>
3106f25ae9SGregory Neil Shapiroehlo		Introduce yourself, and request extended SMTP mode.
3206f25ae9SGregory Neil Shapiroehlo	Possible replies include:
3306f25ae9SGregory Neil Shapiroehlo		SEND		Send as mail			[RFC821]
3406f25ae9SGregory Neil Shapiroehlo		SOML		Send as mail or terminal	[RFC821]
3506f25ae9SGregory Neil Shapiroehlo		SAML		Send as mail and terminal	[RFC821]
3606f25ae9SGregory Neil Shapiroehlo		EXPN		Expand the mailing list		[RFC821]
3706f25ae9SGregory Neil Shapiroehlo		HELP		Supply helpful information	[RFC821]
3806f25ae9SGregory Neil Shapiroehlo		TURN		Turn the operation around	[RFC821]
3906f25ae9SGregory Neil Shapiroehlo		8BITMIME	Use 8-bit data			[RFC1652]
4006f25ae9SGregory Neil Shapiroehlo		SIZE		Message size declaration	[RFC1870]
4106f25ae9SGregory Neil Shapiroehlo		VERB		Verbose				[Allman]
4206f25ae9SGregory Neil Shapiroehlo		CHUNKING	Chunking			[RFC1830]
4306f25ae9SGregory Neil Shapiroehlo		BINARYMIME	Binary MIME			[RFC1830]
4406f25ae9SGregory Neil Shapiroehlo		PIPELINING	Command Pipelining		[RFC1854]
4506f25ae9SGregory Neil Shapiroehlo		DSN		Delivery Status Notification	[RFC1891]
4606f25ae9SGregory Neil Shapiroehlo		ETRN		Remote Message Queue Starting	[RFC1985]
4706f25ae9SGregory Neil Shapiroehlo		STARTTLS	Secure SMTP			[RFC2487]
4806f25ae9SGregory Neil Shapiroehlo		AUTH		Authentication			[RFC2554]
4906f25ae9SGregory Neil Shapiroehlo		ENHANCEDSTATUSCODES	Enhanced status codes	[RFC2034]
5040266059SGregory Neil Shapiroehlo		DELIVERBY	Deliver By			[RFC2852]
514e4196cbSGregory Neil Shapiromail	MAIL From:<sender> [ <parameters> ]
5206f25ae9SGregory Neil Shapiromail		Specifies the sender.  Parameters are ESMTP extensions.
5306f25ae9SGregory Neil Shapiromail		See "HELP DSN" for details.
544e4196cbSGregory Neil Shapirorcpt	RCPT To:<recipient> [ <parameters> ]
5506f25ae9SGregory Neil Shapirorcpt		Specifies the recipient.  Can be used any number of times.
5606f25ae9SGregory Neil Shapirorcpt		Parameters are ESMTP extensions.  See "HELP DSN" for details.
5706f25ae9SGregory Neil Shapirodata	DATA
5806f25ae9SGregory Neil Shapirodata		Following text is collected as the message.
5906f25ae9SGregory Neil Shapirodata		End with a single dot.
6006f25ae9SGregory Neil Shapirorset	RSET
6106f25ae9SGregory Neil Shapirorset		Resets the system.
6206f25ae9SGregory Neil Shapiroquit	QUIT
6306f25ae9SGregory Neil Shapiroquit		Exit sendmail (SMTP).
6406f25ae9SGregory Neil Shapiroauth	AUTH mechanism [initial-response]
6506f25ae9SGregory Neil Shapiroauth		Start authentication.
6606f25ae9SGregory Neil Shapirostarttls	STARTTLS
6706f25ae9SGregory Neil Shapirostarttls		Start TLS negotiation.
6806f25ae9SGregory Neil Shapiroverb	VERB
6906f25ae9SGregory Neil Shapiroverb		Go into verbose mode.  This sends 0xy responses that are
7006f25ae9SGregory Neil Shapiroverb		not RFC821 standard (but should be)  They are recognized
7106f25ae9SGregory Neil Shapiroverb		by humans and other sendmail implementations.
7206f25ae9SGregory Neil Shapirovrfy	VRFY <recipient>
7306f25ae9SGregory Neil Shapirovrfy		Verify an address.  If you want to see what it aliases
7406f25ae9SGregory Neil Shapirovrfy		to, use EXPN instead.
7506f25ae9SGregory Neil Shapiroexpn	EXPN <recipient>
7606f25ae9SGregory Neil Shapiroexpn		Expand an address.  If the address indicates a mailing
7706f25ae9SGregory Neil Shapiroexpn		list, return the contents of that list.
7806f25ae9SGregory Neil Shapironoop	NOOP
7906f25ae9SGregory Neil Shapironoop		Do nothing.
8006f25ae9SGregory Neil Shapirosend	SEND FROM:<sender>
8106f25ae9SGregory Neil Shapirosend		replaces the MAIL command, and can be used to send
8206f25ae9SGregory Neil Shapirosend		directly to a users terminal.  Not supported in this
8306f25ae9SGregory Neil Shapirosend		implementation.
8406f25ae9SGregory Neil Shapirosoml	SOML FROM:<sender>
8506f25ae9SGregory Neil Shapirosoml		Send or mail.  If the user is logged in, send directly,
8606f25ae9SGregory Neil Shapirosoml		otherwise mail.  Not supported in this implementation.
8706f25ae9SGregory Neil Shapirosaml	SAML FROM:<sender>
8806f25ae9SGregory Neil Shapirosaml		Send and mail.  Send directly to the user's terminal,
8906f25ae9SGregory Neil Shapirosaml		and also mail a letter.  Not supported in this
9006f25ae9SGregory Neil Shapirosaml		implementation.
9106f25ae9SGregory Neil Shapiroturn	TURN
9206f25ae9SGregory Neil Shapiroturn		Reverses the direction of the connection.  Not currently
9306f25ae9SGregory Neil Shapiroturn		implemented.
944e4196cbSGregory Neil Shapiroetrn	ETRN [ <hostname> | @<domain> | \#<queuename> ]
9506f25ae9SGregory Neil Shapiroetrn		Run the queue for the specified <hostname>, or
9606f25ae9SGregory Neil Shapiroetrn		all hosts within a given <domain>, or a specially-named
9706f25ae9SGregory Neil Shapiroetrn		<queuename> (implementation-specific).
98af9557fdSGregory Neil Shapirodsn	MAIL From:<sender> [ RET={ FULL | HDRS} ] [ ENVID=<envid> ]
99af9557fdSGregory Neil Shapirodsn	RCPT To:<recipient> [ NOTIFY={NEVER,SUCCESS,FAILURE,DELAY} ]
10006f25ae9SGregory Neil Shapirodsn			     [ ORCPT=<recipient> ]
10106f25ae9SGregory Neil Shapirodsn		SMTP Delivery Status Notifications.
10206f25ae9SGregory Neil Shapirodsn	Descriptions:
10306f25ae9SGregory Neil Shapirodsn		RET	Return either the full message or only headers.
10406f25ae9SGregory Neil Shapirodsn		ENVID	Sender's "envelope identifier" for tracking.
10506f25ae9SGregory Neil Shapirodsn		NOTIFY	When to send a DSN. Multiple options are OK, comma-
10606f25ae9SGregory Neil Shapirodsn			delimited. NEVER must appear by itself.
10706f25ae9SGregory Neil Shapirodsn		ORCPT	Original recipient.
10806f25ae9SGregory Neil Shapiro-bt	Help for test mode:
10906f25ae9SGregory Neil Shapiro-bt	?		 :this help message.
11006f25ae9SGregory Neil Shapiro-bt	.Dmvalue	 :define macro `m' to `value'.
11106f25ae9SGregory Neil Shapiro-bt	.Ccvalue	 :add `value' to class `c'.
11206f25ae9SGregory Neil Shapiro-bt	=Sruleset	 :dump the contents of the indicated ruleset.
11306f25ae9SGregory Neil Shapiro-bt	=M		 :display the known mailers.
11406f25ae9SGregory Neil Shapiro-bt	-ddebug-spec	 :equivalent to the command-line -d debug flag.
11506f25ae9SGregory Neil Shapiro-bt	$$m		 :print the value of macro $$m.
11606f25ae9SGregory Neil Shapiro-bt	$$=c		 :print the contents of class $$=c.
11706f25ae9SGregory Neil Shapiro-bt	/mx host	 :returns the MX records for `host'.
11806f25ae9SGregory Neil Shapiro-bt	/parse address	 :parse address, returning the value of crackaddr, and
11906f25ae9SGregory Neil Shapiro-bt			  the parsed address.
12006f25ae9SGregory Neil Shapiro-bt	/try mailer addr :rewrite address into the form it will have when
12106f25ae9SGregory Neil Shapiro-bt			  presented to the indicated mailer.
12206f25ae9SGregory Neil Shapiro-bt	/tryflags flags	 :set flags used by parsing.  The flags can be `H' for
12306f25ae9SGregory Neil Shapiro-bt			  Header or `E' for Envelope, and `S' for Sender or `R'
12406f25ae9SGregory Neil Shapiro-bt			  for Recipient.  These can be combined, `HR' sets
12506f25ae9SGregory Neil Shapiro-bt			  flags for header recipients.
12606f25ae9SGregory Neil Shapiro-bt	/canon hostname	 :try to canonify hostname.
12706f25ae9SGregory Neil Shapiro-bt	/map mapname key :look up `key' in the indicated `mapname'.
12806f25ae9SGregory Neil Shapiro-bt	/quit		 :quit address test mode.
12906f25ae9SGregory Neil Shapiro-bt	rules addr	 :run the indicated address through the named rules.
13006f25ae9SGregory Neil Shapiro-bt			  Rules can be a comma separated list of rules.
13106f25ae9SGregory Neil Shapirocontrol	Help for smcontrol:
13206f25ae9SGregory Neil Shapirocontrol	help		This message.
13306f25ae9SGregory Neil Shapirocontrol	restart		Restart sendmail.
13406f25ae9SGregory Neil Shapirocontrol	shutdown	Shutdown sendmail.
13506f25ae9SGregory Neil Shapirocontrol	status		Show sendmail status.
136d0cef73dSGregory Neil Shapirocontrol	mstat		Show sendmail status (machine readable format).
137605302a5SGregory Neil Shapirocontrol	memdump		Dump allocated memory list (for debugging only).
138