1168515Sgshapiro<HTML> 2168515Sgshapiro<HEAD><TITLE>xxfi_header</TITLE></HEAD> 3168515Sgshapiro<BODY> 4132943Sgshapiro<!-- 5266692Sgshapiro$Id: xxfi_header.html,v 1.18 2013-11-22 20:51:39 ca Exp $ 6132943Sgshapiro--> 7168515Sgshapiro<H1>xxfi_header</H1> 890792Sgshapiro 9168515Sgshapiro<TABLE border="0" cellspacing=4 cellpadding=4> 1090792Sgshapiro<!---------- Synopsis -----------> 11168515Sgshapiro<TR><TH valign="top" align=left width=100>SYNOPSIS</TH><TD> 12168515Sgshapiro<PRE> 1390792Sgshapiro#include <libmilter/mfapi.h> 1490792Sgshapirosfsistat (*xxfi_header)( 15168515Sgshapiro SMFICTX *ctx, 16168515Sgshapiro char *headerf, 17168515Sgshapiro char *headerv 1890792Sgshapiro); 19168515Sgshapiro</PRE> 2090792SgshapiroHandle a message header. 21168515Sgshapiro</TD></TR> 2290792Sgshapiro 2390792Sgshapiro<!----------- Description ----------> 24168515Sgshapiro<TR><TH valign="top" align=left>DESCRIPTION</TH><TD> 25168515Sgshapiro<TABLE border="1" cellspacing=1 cellpadding=4> 26168515Sgshapiro<TR align="left" valign=top> 27168515Sgshapiro<TH width="80">Called When</TH> 28168515Sgshapiro<TD>xxfi_header is called once for each message header.</TD> 29168515Sgshapiro</TR> 30168515Sgshapiro<TR align="left" valign=top> 31168515Sgshapiro<TH>Default Behavior</TH> 32168515Sgshapiro<TD>Do nothing; return SMFIS_CONTINUE.</TD> 33168515Sgshapiro</TR> 34168515Sgshapiro</TABLE> 3590792Sgshapiro 3690792Sgshapiro<!----------- Arguments ----------> 37168515Sgshapiro<TR><TH valign="top" align=left>ARGUMENTS</TH><TD> 38168515Sgshapiro <TABLE border="1" cellspacing=0> 39168515Sgshapiro <TR bgcolor="#dddddd"><TH>Argument</TH><TH>Description</TH></TR> 40168515Sgshapiro <TR valign="top"><TD>ctx</TD> 41168515Sgshapiro <TD>Opaque context structure. 42168515Sgshapiro </TD></TR> 43168515Sgshapiro <TR valign="top"><TD>headerf</TD> 44168515Sgshapiro <TD> Header field name. 45168515Sgshapiro </TD></TR> 46168515Sgshapiro <TR valign="top"><TD>headerv</TD> 47168515Sgshapiro <TD>Header field value. 48159609Sgshapiro The content of the header may include folded white space, 49159609Sgshapiro i.e., multiple lines with following white space 50159609Sgshapiro where lines are separated by LF (not CR/LF). 51159609Sgshapiro The trailing line terminator (CR/LF) is removed. 52168515Sgshapiro </TD></TR> 53168515Sgshapiro </TABLE> 54168515Sgshapiro</TD></TR> 5590792Sgshapiro 5690792Sgshapiro<!----------- Notes ----------> 57168515Sgshapiro<TR> 58168515Sgshapiro<TH valign="top" align=left>NOTES</TH> 59168515Sgshapiro<TD> 60168515Sgshapiro<UL> 61168515Sgshapiro<LI>Starting with sendmail 8.14, spaces after the colon in a header 62168515Sgshapirofield are preserved if requested using the flag 63168515Sgshapiro<A HREF="xxfi_negotiate.html#SMFIP_HDR_LEADSPC"><CODE>SMFIP_HDR_LEADSPC</CODE></A>. 64168515SgshapiroThat is, the header 6590792Sgshapiro 66168515Sgshapiro<PRE> 67168515SgshapiroFrom: sender <f@example.com> 68168515SgshapiroTo: user <t@example.com> 69168515SgshapiroSubject:no 70168515Sgshapiro</PRE> 71168515Sgshapiro 72168515Sgshapirowill be sent to a milter as 73168515Sgshapiro 74168515Sgshapiro<PRE> 75168515Sgshapiro"From", " sender <f@example.com>" 76168515Sgshapiro"To", " user <t@example.com>" 77168515Sgshapiro"Subject", "no" 78168515Sgshapiro</PRE> 79168515Sgshapiro 80168515Sgshapirowhile previously 81168515Sgshapiro(or without the flag 82168515Sgshapiro<A HREF="xxfi_negotiate.html#SMFIP_HDR_LEADSPC"><CODE>SMFIP_HDR_LEADSPC</CODE></A>) 83168515Sgshapiroit was: 84168515Sgshapiro 85168515Sgshapiro<PRE> 86168515Sgshapiro"From", "sender <f@example.com>" 87168515Sgshapiro"To", "user <t@example.com>" 88168515Sgshapiro"Subject", "no" 89168515Sgshapiro</PRE> 90168515Sgshapiro 91168515Sgshapiro 92168515Sgshapiro<LI>Later filters will see header changes/additions made by earlier ones. 93168515Sgshapiro<LI>For much more detail about header format, please see 94168515SgshapiroRFC <A href="http://www.rfc-editor.org/rfc/rfc822.html">822</A> 95168515Sgshapiroand 96168515SgshapiroRFC <A href="http://www.rfc-editor.org/rfc/rfc2822.html">2822</A> 97168515Sgshapiro</UL> 98168515Sgshapiro</TD> 99168515Sgshapiro</TR> 100168515Sgshapiro</TABLE> 101168515Sgshapiro 102168515Sgshapiro<HR size="1"> 103168515Sgshapiro<FONT size="-1"> 104261363SgshapiroCopyright (c) 2000, 2003, 2006 Proofpoint, Inc. and its suppliers. 10590792SgshapiroAll rights reserved. 106168515Sgshapiro<BR> 10790792SgshapiroBy using this file, you agree to the terms and conditions set 108112810Sgshapiroforth in the LICENSE. 109168515Sgshapiro</FONT> 110168515Sgshapiro</BODY> 111168515Sgshapiro</HTML> 112