svLinkFailure(2DL)

NAME | SYNOPSIS | API RESTRICTIONS | FEATURES | DESCRIPTION | PARAMETERS | RETURN VALUES | ATTRIBUTES

NAME

svLinkFailure- Notify that a communication failure with a remote site has occurred

SYNOPSIS

#include <ipc/extDtLink.h>

int svLinkFailure(unsigned int site, int reason);

API RESTRICTIONS

The function or functions documented here may not be used safely in all application contexts with all APIs provided in the ChorusOS 5.0 product.

See API(5FEA) for details.

FEATURES

IPC_REMOTE

DESCRIPTION

The svLinkFailure() system call notifies the microkernel that a failure was detected on the communication link with a remote site.

PARAMETERS

The site parameter designates the remote site with which the communication link is broken.

The reason parameter is a negative error code which specifies the reason of the failure. Currently, the reason parameter is ignored by the system which internally uses the K_ELINKFAILURE error code.

When invoked, the svLinkFailure() system call closes the connection established with the remote site, if any, and cancels all ipcCall(2K) issued by local threads to ports which are located on the remote site. Each of these threads will be returned the K_ELINKFAILURE error code.

RETURN VALUES

The svLinkFailure() system call returns a value of 0 when successful. Otherwise, the K_EINVAL error code is returned.

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Interface Stability	Evolving

ChorusOS 5.0  Last Revised December 2001

NAME | SYNOPSIS | API RESTRICTIONS | FEATURES | DESCRIPTION | PARAMETERS | RETURN VALUES | ATTRIBUTES