NAME
smfi_setconn() — sets the socket for filter to communicate with sendmail
SYNOPSIS
#include #include <libmilter/mfapi.h>
int smfi_setconn(
char *oconn;
};
xxx
PARAMETERS
- oconn
Specifies the address of the desired communication socket.
The
address must be a NULL-terminated string
in the following
proto:address
format:
- {unix|local}:path_to_file
Specifies a named pipe.
- inet:port@{hostname|ip-address}
Specifies an IPV4 socket, using either a
hostname
or an
ip-address.
- inet6:port@{hostname|ip-address}
Specifies an IPV6 socket, using either a
hostname
or an
ip-address..
DESCRIPTION
The
smfi_setconn()
routine sets the socket through which the filter must
communicate with
sendmail.
smfi_setconn()
must be called only once
before the
smfi_main()
function.
Notes
Filters must not be run as root when communicating
over UNIX/local domain sockets.
The permissions for UNIX/local sockets must be set to 0600
(read/write permission only for the owner of the socket) or 0660
(read/write permission for the owner and group of the socket).
These
permissions are useful when the
sendmail
RunAsUser
option is used.
The
permissions for a UNIX/local domain socket are determined using the
the
umask
command, which must be set to 007 or 077.
Some operating systems, such as Solaris, do not use the permissions of
the socket.
Therefore, place the socket in a protected
directory in such systems.
RETURN VALUE
smfi_setconn()
does not fail due to an invalid address.
The failure can only be
detected in the
smfi_main()
routine.
AUTHOR
smfi_setconn()
was developed by the Sendmail Inc.
SEE ASLO
smfi_main(3N),
smfi_register(3N),
smfi_settimeout(3N),
smfi_opensocket(3N),
smfi_setbacklog(3N),
smfi_setdbg(3N),
smfi_stop(3N).
Sendmail 8.13.3 Programmer's Guide
on
docs.hp.com.