Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   10987 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

smfi_setmlreply(3N)					   smfi_setmlreply(3N)

NAME
       smfi_setmlreply()  - sets default SMTP error reply code to a multi-line
       response

SYNOPSIS
PARAMETERS
       ctx     Specifies the opaque context structure.

       rcode   Specifies the 3-digit (RFC 821/2821)  SMTP  reply  code,	 as  a
	       null-terminated string.

	       rcode  must  not	 be a NULL value, and must be a valid or reply
	       code.

       xcode   Specifies the extended (RFC 1893 or 2034) reply code.  An xcode
	       must  conform  to RFC 1893/2034 code.  If xcode is set to NULL,
	       an extended code is not used.

       Specifies the remaining arguments, which are single lines of text.
	       A maximum of 32 arguments can be	 specified.   These  arguments
	       are  used as the text part of the SMTP reply.  The list must be
	       terminated with a NULL value.

DESCRIPTION
       The routine directly sets the SMTP error reply code for a connection.

       Only and replies are accepted.

       The list of arguments in must be terminated with a NULL value.

       is used on subsequent errors from the filter.  can be called  from  any
       of the functions other than

   Notes
       ·  Values passed to are not checked for standards compliance.

       ·  The  message parameter must contain only printable characters; other
	  characters may lead to undefined behavior.  For example, a CR or  LF
	  will	cause  the  call  to fail, single (percentage) characters will
	  cause the text to be ignored.	 If a is required in a string, use the
	  format.

       ·  For more information on reply codes and their meanings, see RFC 821,
	  2821, 1893, and 2034.

       ·  If the reply code, that is, rcode, is given a code but is  used  for
	  the message, the custom reply is not used.

	  Similarly, if rcode is given a code but is used for the message, the
	  custom reply is not used.

	  In neither of the last two cases, an error is returned to the Milter
	  and silently ignores the reply code.

       ·  If  the  Milter  returns  and sets the reply code to '421', the SMTP
	  server terminates the SMTP session with a '421' error code.

RETURN VALUE
       fails and returns for the following reasons:

       ·  Invalid rcode or xcode argument value.
       ·  Memory-allocation failure.
       ·  Carriage return or line feed in a text line.
       ·  Length of any text line is more than the value (980).
       ·  More than 32 lines of text replies are provided.

       returns on successful completion.

EXAMPLES
       Consider the following sample code:

       The following is the SMTP response of the sample code:

AUTHOR
       The routine was developed by the Sendmail Inc.

SEE ALSO
       smfi_getsymval(3N),  smfi_getpriv(3N),	smfi_setreply(3N),   smfi_set‐
       priv(3N).

       on

							   smfi_setmlreply(3N)

Vote for polarhome