smfi_setconn(3N)														  smfi_setconn(3N)

NAME

       smfi_setconn() - sets the socket for filter to communicate with sendmail

SYNOPSIS

PARAMETERS

       oconn	 Specifies the address of the desired communication socket.  The address must be a NULL-terminated string in the following format:

		 Specifies a named pipe.

		 Specifies an IPV4 socket, using either a
		      hostname or an ip-address.

		 Specifies an IPV6 socket, using either a
		      hostname or an ip-address..

DESCRIPTION

       The routine sets the socket through which the filter must communicate with must be called only once before the 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 RunAsUser option is used.

       The permissions for a UNIX/local domain socket are determined using the the 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

       does not fail due to an invalid address.  The failure can only be detected in the routine.

AUTHOR

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

       on

																  smfi_setconn(3N)