This chapter alphabetically presents each calibration function your loadable module calls to interface with KCMS Calibrator Tool. For each function, the chapter provides its purpose, arguments, and return values.
Once a module is dynamically opened, Calibrator Tool uses dlsym(3DL) to access the module functions by their symbolic names. Then it adds the names to the process symbol space.
int KCMSCMonClose (void);
Returns 0 if successful; returns any other nonzero value if unsuccessful.
int KCMSCMonInit (KCMSCVisuals *vis_data);
KCMSCMonInit() accepts a pointer to a KCMSCVisuals structure passed to it from the Calibrator Tool main program and is used by the module for initialization. Examples of initialization tasks the module might perform include:
Starting its own GUI-based application
Setting everything necessary to measure monitor data
Doing nothing, if the measurements were previously stored in a file by the end user
Returns 0 if successful; returns any other nonzero value if the hardware fails to initialize.
int KCMSCMonMeasure (KCMSCData *measured_data);
It performs the number of measurement sets specified by the value of the size field in the KCMSCData structure (alternately, it can be programmed to read all the measurements previously created).
It uses the measurement values to fill in the appropriate fields in the KCMSCData structure.
Returns 0 if successful; returns any other nonzero value if the collection of data was interrupted either by the user or by failure of the hardware to measure the data.