cnet's Application Programming Interface

NAME

CNET_disable_application - suppress the generation of new messages for delivery to other nodes

SYNOPSIS

#include <cnet.h> int CNET_disable_application(CnetAddr destaddr);

DESCRIPTION

CNET_disable_application suppresses the Application Layer from generating new messages to the destination node with the indicated network address.

If the value of destaddr is the symbolic constant ALLNODES, then message generation will be disabled for all other nodes. This function should be called when a harried node runs out of buffer space or, perhaps, while routing information is being gathered.

RETURN VALUE

The value 0 is returned on success. On failure, the value -1 is returned, and the global variable cnet_errno is set to one of the following values to describe the error:

ER_BADARG

The value of destaddr indicates the current node.

ER_NOTSUPPORTED

The current node does not have an Application layer.

SEE ALSO

CNET_enable_application.