| 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,
after calling smfi_setconn() and smfi_register(),
but 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 create the socket implicitly
(without removing a potentially existing UNIX domain socket). |  | 
|---|
| 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: 
    Otherwise, it will return MI_SUCCESSThe 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() or smfi_register()
	have not been called.
 |