cnet's Application Programming Interface

NAME

CNET_set_debug_string - place a short string on cnet's GUI.

SYNOPSIS

#include <cnet.h> int CNET_set_debug_string(CnetEvent ev, char *string);

DESCRIPTION

This function enables a short label to be placed on one of the debug buttons of cnet's GUI. If string is NULL or the empty string, the label on the indicated button is removed. If cnet is being executed without its GUI, this function is always successful, but has no effect.

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_BADEVENT

The value of ev is not one of the events EV_DEBUG0..EV_DEBUG4.