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;

The function dc_prf_utrace_put() acquires a user-specific performance verification trace (prf trace).

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.

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.