smfi_setreply(3N)smfi_setreply(3N)NAMEsmfi_setreply() - sets the default SMTP error reply code
SYNOPSISPARAMETERS
ctx Specifies the opaque context structure.
rcode Specifies the 3-digit (RFC 821/2821) SMTP reply code as a
null-terminated string. rcode cannot be set to NULL value.
rcode must be a valid or reply code.
xcode Specifies the extended (RFC 1893/2034) reply code. An xcode
must conform to RFC 1893/2034. If xcode is set to NULL, an
extended code is not used.
message Specifies the text part of the SMTP reply. If message is set
to NULL, an empty message is used.
DESCRIPTION
The routine directly sets the SMTP error reply code for a connection.
Only and replies are accepted. uses this code on subsequent error
replies from the Milter function.
can be called from any function except the function.
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, CR or LF
causes the call to fail, a single (percentage) character can cause
the text to be ignored. If a (percentage) character must be used in
a string, it must be used as
· For more information on reply codes and their meanings, see RFC 821,
2821, 1893, or 2034.
· If the reply code (rcode) given is a code but is used for the mes‐
sage, the normal reply is not used.
If the reply code (rcode) given is a code but is used for the mes‐
sage, the custom reply is not used.
In neither of these 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 the SMTP server
terminates the SMTP session with a error code.
RETURN VALUE
fails and returns if the rcode or xcode argument is invalid or a memory
allocation failure occurs; otherwise; returns
AUTHOR
The routine was developed by the Sendmail Inc.
SEE ALSOsmfi_getsymval(3N), smfi_getpriv(3N), smfi_setreply(3N), smfi_set‐
priv(3N).
on
smfi_setreply(3N)