smfi_setmlreply(3n) [hpux man page]

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  termi-
	       nated 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
       o  Values passed to are not checked for standards compliance.

       o  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.

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

       o  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.

       o  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:

       o  Invalid rcode or xcode argument value.
       o  Memory-allocation failure.
       o  Carriage return or line feed in a text line.
       o  Length of any text line is more than the value(980).
       o  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_setpriv(3N).

       on

															       smfi_setmlreply(3N)

Check Out this Related Man Page

Mail::SendEasy::SMTP(3pm)				User Contributed Perl Documentation				 Mail::SendEasy::SMTP(3pm)

NAME

       Mail::SendEasy::SMTP - Handles the communication with the SMTP server without dependencies.

DESCRIPTION

       This module will handle the communication with the SMTP server.	It hasn't dependencies and supports authentication.

USAGE

	 use Mail::SendEasy ;

	 $smtp = Mail::SendEasy::SMTP->new( 'domain.foo' , 25 , 120 ) ;

	 if ( !$smtp->auth ) { warn($smtp->last_response_line) ;}

	 if ( $smtp->MAIL("FROM:<$mail{from}>") !~ /^2/ ) { warn($smtp->last_response_line) ;}

	 if ( $smtp->RCPT("TO:<$to>") !~ /^2/ ) { warn($smtp->last_response_line) ;}

	 if ( $smtp->RCPT("TO:<$to>") !~ /^2/ ) { warn($smtp->last_response_line) ;}

	 if ( $smtp->DATA =~ /^3/ ) {
	   $smtp->print("To: foo@foo") ;
	   $smtp->print("Subject: test") ;
	   $smtp->print("
") ;
	   $smtp->print("This is a sample MSG!") ;
	   if ( $smtp->DATAEND !~ /^2/ ) { warn($smtp->last_response_line) ;}
	 }

	 $smtp->close ;

METHODS

   new ($host , $port , $timeout , $user , $pass)
       Create the SMTP object and connects to the server.

   connect
       Connect to the server.

   auth_types
       The authentication types supported by the SMTP server.

   auth($user , $pass)
       Does the authentication.

   print (data)
       Send data to the socket connection.

   cmd (CMD , @MORE)
       Send a command to the server.

   response
       Returns the code response.

       If wantarray returns an ARRAY with the response lines.

   last_response
       Returns an ARRAY with the response lines.

   last_response_msg
       The last response text.

   last_response_line
       The last response line (code and text).

   close
       QUIT and close the connection.

AUTHOR

       Graciliano M. P. <gm@virtuasites.com.br>

COPYRIGHT

       This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

perl v5.12.4							    2004-04-09						 Mail::SendEasy::SMTP(3pm)

Linux and UNIX Man Pages

smfi_setmlreply(3n) [hpux man page]

Check Out this Related Man Page