cnet's Application Programming Interface

NAME

CNET_check_version - ensure compatability between cnet and user protocols.

SYNOPSIS

#include <cnet.h>

void CNET_check_version(char *current_version);

DESCRIPTION

This function compares the current version of the cnet simulator with the version of the <cnet.h> header file that was used to compile the currently running user protocol. A typical invocation is:

CNET_check_version(CNET_VERSION);

where the string constant CNET_VERSION is defined in the <cnet.h> header file included by the user's protocol. A version mismatch indicates that there may be some incompatability between cnet and the protocol. The user's code should be recompiled.

RETURN VALUE

On success, the function simply returns. On failure, an error message is printed to C's stderr stream and cnet terminates.