name_close()

Updated: April 19, 2023

Close a server connection that was opened by name_open()

Synopsis:

#include <sys/iofunc.h>
#include <sys/dispatch.h>

int name_close( int coid );

Arguments:

coid
A side-channel connection ID returned by name_open().

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The name_close() function closes a server connection that was opened by name_open().

Returns:

Zero for success, or -1 if an error occurs (errno is set).

Errors:

EINVAL
The side-channel connection ID specified by coid is invalid.
EPERM
The process is not allowed to close SYSMGR_COID.

Examples:

See the “Client side of the code” section in name_attach().

Classification:

QNX Neutrino

Safety:  
Cancellation point Yes
Interrupt handler No
Signal handler Yes
Thread Yes