ChannelDestroy(), ChannelDestroy_r()

Destroy a communications channel

Synopsis:

#include <sys/neutrino.h>

int ChannelDestroy( int chid );

int ChannelDestroy_r( int chid );

Library:

libc

Description:

The ChannelDestroy() and ChannelDestroy_r() functions are identical except in the way they indicate errors. See the Returns section for details.

These kernel calls remove a channel specified by the channel ID chid argument. Once destroyed, any attempt to receive messages or pulses on the channel will fail. Any threads that are blocked on the channel by calling MsgReceivev() or MsgSendv() will be unblocked and return with an error.

When the channel is destroyed, all server connection IDs become invalid. The client connections are also marked invalid but remain in existence until the client removes them by calling ConnectDetach(). An attempt by the client to use one of these invalid connections using MsgSendv() or MsgSendPulse() will return with an error.

A server typically destroys its channels prior to its termination. If it fails to do so, the kernel destroys them automatically when the process dies.

Blocking states

These calls don't block.

Returns:

The only difference between these functions is the way they indicate errors:

ChannelDestroy()

If an error occurs, -1 is returned and errno is set. Any other value returned indicates success.

ChannelDestroy_r()

EOK is returned on success. This function does NOT set errno. If an error occurs, any value in the Errors section may be returned.

Errors:

EINVAL

The channel specified by chid doesn't exist.

Classification:

QNX 6

See also:

ChannelCreate(), MsgReceivev()