| SYNOPSIS |
#include <libmilter/mfapi.h>
int smfi_opensocket(
bool rmsocket
);
Attempt to create the interface socket MTAs will use to connect to the
filter.
|
|---|
| DESCRIPTION |
| Called When |
Called only from program mainline, before calling
smfi_main(). |
| Effects |
smfi_opensocket attempts to create the socket specified previously by
a call to smfi_setconn() which will be the interface between MTAs
and the filter. This allows the calling application to ensure that the
socket can be created. If this is not called, smfi_main() will
do so implicitly. |
|
|---|
| ARGUMENTS |
| Argument | Description |
|---|
| rmsocket |
A flag indicating whether or not the library should try to
remove any existing UNIX domain socket before trying to create
a new one.
|
|
|---|
| RETURN VALUES |
smfi_opensocket will fail and return MI_FAILURE if:
- The interface socket could not be created for any reason.
- rmsocket was true, and either the socket could
not be examined, or exists and could not be removed.
- smfi_setconn() has not been called.
Otherwise, it will return MI_SUCCESS
|