Caution: This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

name_close()

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:

EBADF
The side-channel connection ID specified by coid is invalid.
EINTR
The name_close() call was interrupted by a signal.
ENOSYS
The name_close() function isn't implemented for the filesystem specified by 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

See also:

close(), ConnectDetach(), name_attach(), name_detach(), name_open()

Message Passing chapter of Getting Started with QNX Neutrino