Dynamic Probe Class Library

DPCL Class Reference


Chapter 19. Predefined message types

This chapter describes the predefined message types of DPCL.

AIS_DEFAULT_MSG

Synopsis

#include <AisMsgType.h>
extern const int AIS_DEFAULT_MSG;

Description

This constant represents a callback identifier key. This callback chain is used when a message is received that has no callback chain for the message type.

A tool may replace the callback function associated with this key with a new callback function. This is done with the Ais_override_default_callback. It is important to note that the message returned by AIS_DEFAULT_MSG is a string. For example:

void
AisDefaultCB(GCBSysType sys, GCBTagType tag, GCBObjType obj, GCBMsgType msg)
{
    int data_size = sys.msg_size;
    char *data = (char *)msg;
    ...
}

Since this callback is invoked for any message which does not have a registered callback handler, there is no defined format for messages handled by this callback.

See Also

Ais_override_default_callback

AIS_EXIT_MSG

Synopsis

#include <AisMsgType.h>
extern const int AIS_EXIT_MSG;

Description

This constant represents a callback identifier key. It may be used by the daemon processes to send an exit message to the end user, when the daemon processes terminate.

A tool may replace the callback function associated with this key with a new callback function. This is done with the Ais_override_default_callback. It is important to note that the message returned by AIS_EXIT_MSG is a string. For example:

void
AisExitCB(GCBSysType sys, GCBTagType tag, GCBObjType obj, GCBMsgType msg)
{
    int *socket_id = (int *)msg;
    ...
}
 

The message sent to this callback consists of a single integer, which represents the file descriptor for the socket this client used to connect to the daemon.

See Also

Ais_override_default_callback

AIS_PROC_TERMINATE_MSG

Synopsis

#include <AisMsgType.h>
extern const int AIS_PROC_TERMINATE_MSG;

Description

This constant represents a callback identifier key. It may be used by daemon processes to send a message to the end user indicating an application process has terminated.

A tool may replace the callback function associated with this key with a new callback function. This is done with the Ais_override_default_callback. It is important to note that the message returned by AIS_PROC_TERMINATE_MSG is a string. For example:

void
AisProcTermCB(GCBSysType sys, GCBTagType tag, GCBObjType obj, GCBMsgType msg)
{
    int *process_id = (int *)msg;
    ...
}
 

The message is a single integer, the process identifier of the terminated application.

See Also

Ais_override_default_callback


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]