cnet's Application Programming Interface

NAME

CNET_enable_application - permit the generation of new messages for delivery to other nodes

SYNOPSIS

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

DESCRIPTION

CNET_enable_application permits the Application Layer to generate new messages for the destination node with the indicated network address.

If the value of destaddr is the symbolic constant ALLNODES, then message generation will be enabled for all other nodes. Messages are never generated for delivery to oneself. Initially, message generation to all destination nodes is disabled and must be enabled to begin the generation of messages.

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_disable_application, and CNET_read_application.