NAME

ACE_Timeprobe - This class is used to instrument code. This is accomplished by inserting time probes at different location in the code. ACE_Timeprobe then measures the time difference between two time probes.

SYNOPSIS

template<class ACE_LOCK> class ACE_Timeprobe { public: typedef ACE_Timeprobe<ACE_LOCK> SELF; typedef ACE_Unbounded_Set<ACE_Event_Descriptions> EVENT_DESCRIPTIONS; ACE_Timeprobe (u_long size = ACE_DEFAULT_TIMEPROBE_TABLE_SIZE); ~ACE_Timeprobe (void); void timeprobe (u_long event); void timeprobe (const char *id); int event_descriptions ( const char **descriptions, u_long minimum_id ); void print_times (void); void print_absolute_times (void); void reset (void); ACE_Timeprobe (const ACE_Timeprobe<ACE_LOCK> &); ACE_Unbounded_Set<ACE_Event_Descriptions> &event_descriptions ( void ); ACE_Unbounded_Set<ACE_Event_Descriptions> &sorted_event_descriptions ( void ); u_int *current_slot_vme_address (void); const char *find_description_i (u_long i); void sort_event_descriptions_i (void); ACE_timeprobe_t *timeprobes (void); ACE_LOCK &lock (void); u_long max_size (void); u_long current_size (void); protected: EVENT_DESCRIPTIONS event_descriptions_; EVENT_DESCRIPTIONS sorted_event_descriptions_; u_int *current_slot_vme_address_; ACE_timeprobe_t *timeprobes_; ACE_LOCK lock_; u_long max_size_; u_long current_size_; };

DESCRIPTION

This class provides a lightweight implementation for measuring the time required to execute code between two time probes. When a time probe executes, it records the time, the id of the calling thread, and an event description. The event description can either be an unsigned long or a string (char *). If string are used, care must be taken cause only pointer copies are done and the string data is *not* copied.

The recorded time probes can then be printed by calling print_times. If you have used unsigned longs as event descriptions in any of your time probes, you must have provided an event description table that maps the unsigned longs to readable strings. This map is a simple array of strings, and the event number is used as the index into the array when looking for the event description. If you have only used strings for the event description, this map is not necessary.

Multiple maps can also be used to chunk up the time probes. Each one can be added by calling event_descriptions. Different tables are used internally by consulting the minimum_id for each table. It is up to the user to make sure that multiple tables do not share the same event id range.

PUBLIC MEMBERS

typedef ACE_Timeprobe<ACE_LOCK> SELF;

typedef ACE_Unbounded_Set<ACE_Event_Descriptions> EVENT_DESCRIPTIONS;

ACE_Timeprobe (u_long size = ACE_DEFAULT_TIMEPROBE_TABLE_SIZE);

~ACE_Timeprobe (void);

void timeprobe (u_long event);

void timeprobe (const char *id);

int event_descriptions (const char **descriptions, u_long minimum_id);

void print_times (void);

void print_absolute_times (void);

void reset (void);

ACE_Timeprobe (const ACE_Timeprobe<ACE_LOCK> &);

ACE_Unbounded_Set<ACE_Event_Descriptions> &event_descriptions (void);

ACE_Unbounded_Set<ACE_Event_Descriptions> &sorted_event_descriptions (
    void
    );

u_int *current_slot_vme_address (void);

const char *find_description_i (u_long i);

void sort_event_descriptions_i (void);

ACE_timeprobe_t *timeprobes (void);

ACE_LOCK &lock (void);

u_long max_size (void);

u_long current_size (void);

PROTECTED MEMBERS

EVENT_DESCRIPTIONS event_descriptions_;

EVENT_DESCRIPTIONS sorted_event_descriptions_;

u_int *current_slot_vme_address_;

ACE_timeprobe_t *timeprobes_;

ACE_LOCK lock_;

u_long max_size_;

u_long current_size_;