smfi_opensocket(3n) [hpux man page]

smfi_opensocket(3N)													       smfi_opensocket(3N)

NAME

       smfi_opensocket() - attempts to create the interface socket that MTAs use to connect to the filter

SYNOPSIS

PARAMETERS

       The contains the following parameters:

       rmsocket  A  flag  that	indicates whether the library must try to remove any existing UNIX domain socket before attempting to create a new
		 socket.

DESCRIPTION

       The routine is used to create the socket specified previously by a call to the routine, which is the interface between Mail Transfer Agents
       (MTAs) and the filter.  The routine allows the calling application to ensure that the socket can be created.  If is not called, the routine
       does it implicitly.

       The routine is called only from program mainline before calling the routine.

RETURN VALUE

       Following are the possible reasons when the routine fails and returns

       o  The interface socket is not created.
       o  When rmsocket is true, either the socket is not examined or the socket exists and cannot be removed.
       o  The routine is not called.

AUTHOR

       The routine was developed was the Sendmail Inc.

SEE ALSO

       smfi_main(3N), smfi_register(3N), smfi_setconn(3N), smfi_settimeout(3N), smfi_setbacklog(3N), smfi_setdbg(3N), smfi_stop(3N).

       on

															       smfi_opensocket(3N)

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)