HP-UX Reference (11i v3 07/02) - 3 Library Functions N-Z (vol 7)

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

441

442

443

444

445

446

447

448

449

450

smﬁ_opensocket(3N) smﬁ_opensocket(3N)

NAME

smﬁ_opensocket() - attempts to create the interface socket that MTAs use to connect to the ﬁlter

SYNOPSIS

#include <libmilter/mfapi.h>

int smfi_opensocket (

bool

rmsocket

);

PARAMETERS

The smfi_opensocket()

contains the following parameters:

rmsocket A ﬂag that indicates whether the library must try to remove any existing UNIX domain socket

before attempting to create a new socket.

DESCRIPTION

The

smfi_opensocket()

routine is used to create the socket speciﬁed previously by a call to the

smfi_setconn() routine, which is the interface between Mail Transfer Agents (MTAs) and the ﬁlter.

The smfi_setconn() routine allows the calling application to ensure that the socket can be created. If

smfi_opensocket()

is not called, the smfi_main() routine does it implicitly.

The

smfi_opensocket()

routine is called only from program mainline before calling the

smfi_main() routine.

RETURN VALUE

Following are the possible reasons when the smfi_opensocket()

routine fails and returns

MI_FAILURE:

• The interface socket is not created.

• When rmsocket is true, either the socket is not examined or the socket exists and cannot be removed.

• The smfi_setconn()

routine is not called.

AUTHOR

The

smfi_opensocket()

routine was developed was the Sendmail Inc.