OpenTP1 Version 7 Programming Reference C Language
dc_prf_utrace_put - Acquire user-specific performance verification traces
Format
ANSI C, C++
#include <dcprf.h> int dc_prf_utrace_put(unsigned short event_id, unsigned short datalen, char *buffaddr, DCLONG flags) |
K&R C
#include <dcprf.h> int dc_prf_utrace_put(event_id, datalen, buffaddr, flags) unsigned short event_id; unsigned short datalen; char *buffaddr; DCLONG flags; |
Description
The function dc_prf_utrace_put() acquires a user-specific performance verification trace (prf trace).
Arguments whose values are set in the UAP
event_id
Specify the event ID of the event to be acquired. The range of available event IDs is 0x0001 to 0x0040.
datalen
Specify the data length of the trace data to be acquired. The specifiable data length is 4 bytes to 256 bytes. The data length must be a multiple of 4 bytes.
buffaddr
Specify the leading pointer of the buffer holding the trace data to be acquired.
flags
Specify DCNOFLAGS.
Return values
Return value | Return value (numeric) | Explanation |
---|---|---|
DC_OK | 0 | Normal termination. |
DCPRFER_PARAM | -4601 | The value specified for an argument is invalid. |
Notes
Even if the function dc_prf_utrace_put() returns the value DC_OK, the trace has not necessarily been properly acquired. This is because data may be lost during trace acquisition processing if multiple processes issue acquisition requests simultaneously because no lock is used.
All Rights Reserved. Copyright (C) 2006, 2010, Hitachi, Ltd.