smfi_replacebody(3n) [hpux man page]

smfi_replacebody(3N)													      smfi_replacebody(3N)

NAME

       smfi_replacebody() - replaces the data in the sendmail message body

SYNOPSIS

PARAMETERS

       ctx	 Specifies the opaque context structure.

       bodyp	 Specifies  a  pointer to the start of the new body data, which does not have to be null-terminated.  If bodyp is set to NULL, the
		 length of the body is considered to be 0 (zero).  The body data must be in CR or LF form.

       bodylen	 Specifies the number of data bytes pointed by bodyp.

DESCRIPTION

       replaces the body of the current message.  can be called only from the routine and can be called more than once.  When is called more  than
       once, the subsequent calls append data to the new body of the message.

   Notes
       o  As the message body may be very large, setting may significantly affect filter performance.

       o  If a filter sets but does not call the original body remains unchanged.

       o  The filter order is important for the routine.  Filters placed later in the sequence will observe the changes

RETURN VALUE

       fails and returns due to the following reasons:

       o  The value of bodyp is equal to NULL and the value of bodylen is greater than 0.
       o  Changing the body in the current connection state is invalid.
       o  Network error occurs.
       o  The is not set when the function is called.

AUTHOR

       was developed by the Sendmail Inc.

SEE ALSO

       smfi_chgheader(3N), smfi_insheader(3N), smfi_addrcpt(3N), smfi_addheader(3N), smfi_delrcpt(3N).

       on

															      smfi_replacebody(3N)

smfi_chgheader()(3N)													      smfi_chgheader()(3N)

NAME

       smfi_chgheader() - changes or deletes a sendmail message header

SYNOPSIS

PARAMETERS

       ctx	 Specifies the opaque context structure.

       headerf	 Specifies the header name, which is a non-NULL, null-terminated string.

       hdridx	 Specifies  the  header  index	value (1-based).  A hdridx value of 1 modifies the first occurrence of a header named If hdridx is
		 greater than the number of times appears, a new copy of is added.

DESCRIPTION

       changes the value of a header for the current message.  can be called only from the routine.

   Notes
       o  While can be used to add new headers, it is more efficient to use

       o  A filter that calls must set the flag in the structure passed to

       o  The filter order is important for Filter placed later in the sequence will observer the changes already done by earlier filters.

       o  The name and the value of the header are not checked for standards compliance.  However, each line of the  header  must  be  under  2048
	  characters.	If longer headers are needed, multi-line header must be used.  To make a multi-line header, insert a linefeed (ASCII 0x0a,
	  or 
 in C) followed by at least one whitespace character, such as, a space (ASCII 0x20) or tab (ASCII 0x09, or 	 in C).  The  linefeed
	  must	not be preceded by a carriage return (ASCII 0x0d); the MTA adds this automatically.  It is the responsibility of the filter writer
	  to ensure that standards are not violated.

RETURN VALUE

       returns due to the following reasons:

       o  headerf contains a NULL value.
       o  Modifying headers in the current connection state is invalid.
       o  Memory allocation fails.
       o  Network error occurs.
       o  is not set when is called.

       returns on success.

EXAMPLES

AUTHOR

       was developed by the Sendmail Inc.

SEE ALSO

       smfi_addheader(3N), smfi_insheader(3N), smfi_addrcpt(3N), smfi_delrcpt(3N), smfi_replacebody(3N).

       on

															      smfi_chgheader()(3N)