1<HTML> 2<HEAD><TITLE>smfi_setconn</TITLE></HEAD> 3<BODY> 4<!-- 5$Id: smfi_setconn.html,v 1.18 2013-11-22 20:51:39 ca Exp $ 6--> 7<H1>smfi_setconn</H1> 8 9<TABLE border="0" cellspacing=4 cellpadding=4> 10<!---------- Synopsis -----------> 11<TR><TH valign="top" align=left width=100>SYNOPSIS</TH><TD> 12<PRE> 13#include <libmilter/mfapi.h> 14int smfi_setconn( 15 char *oconn; 16); 17</PRE> 18Set the socket through which this filter should communicate with sendmail. 19</TD></TR> 20 21<!----------- Description ----------> 22<TR><TH valign="top" align=left>DESCRIPTION</TH><TD> 23<TABLE border="1" cellspacing=1 cellpadding=4> 24<TR align="left" valign=top> 25<TH width="80">Called When</TH> 26<TD>smfi_setconn must be called once before <A href="smfi_main.html">smfi_main</A>.</TD> 27</TR> 28<TR align="left" valign=top> 29<TH width="80">Effects</TH> 30<TD>Sets the socket through which the filter communicates with sendmail.</TD> 31</TR> 32</TABLE> 33</TD></TR> 34 35<!----------- Arguments ----------> 36<TR><TH valign="top" align=left>ARGUMENTS</TH><TD> 37 <TABLE border="1" cellspacing=0> 38 <TR bgcolor="#dddddd"><TH>Argument</TH><TH>Description</TH></TR> 39 <TR valign="top"><TD>oconn</TD> 40 <TD>The address of the desired communication socket. 41 The address should be a NULL-terminated string in "proto:address" 42 format: 43 <UL> 44 <LI><CODE>{unix|local}:/path/to/file</CODE> -- A named pipe. 45 <LI><CODE>inet:port@{hostname|ip-address}</CODE> -- An IPV4 socket. 46 <LI><CODE>inet6:port@{hostname|ip-address}</CODE> -- An IPV6 socket. 47 </UL> 48 </TD></TR> 49 </TABLE> 50</TD></TR> 51 52<!----------- Return values ----------> 53<TR> 54<TH valign="top" align=left>RETURN VALUES</TH> 55 56<TD>smfi_setconn will not fail on an invalid address. 57The failure will only be detected in <A href="smfi_main.html">smfi_main</A>. 58Nevertheless, smfi_setconn may fail for other reasons, e.g., 59due to a lack of memory. 60</TD> 61</TR> 62 63<TR> 64<TH valign="top" align=left>NOTES</TH> 65 66<TD> 67<UL> 68 <LI>If possible, filters should not run as root when communicating 69 over unix/local domain sockets. 70 <LI>Unix/local sockets should have their permissions set to 71 0600 (read/write permission only for the socket's owner) or 72 0660 (read/write permission for the socket's owner and group) 73 which is useful if the sendmail RunAsUser option is used. 74 The permissions for a unix/local domain socket are determined as 75 usual by <CODE>umask</CODE>, which should be set to 007 or 077. 76 Note some operating systems (e.g, Solaris) don't use the 77 permissions of the socket. On those systems, place the socket in a 78 protected directory. 79</UL> 80</TD> 81</TR> 82 83</TABLE> 84 85<HR size="1"> 86<FONT size="-1"> 87Copyright (c) 2000, 2003 Proofpoint, Inc. and its suppliers. 88All rights reserved. 89<BR> 90By using this file, you agree to the terms and conditions set 91forth in the LICENSE. 92</FONT> 93</BODY> 94</HTML> 95