NAME

profil − execution time profile

SYNOPSIS

void profil (buff, bufsiz, offset, scale)
char ∗buff;
int bufsiz, offset, scale;

DESCRIPTION

Buff points to an area of core whose length (in bytes) is given by bufsiz. After this call, the user’s program counter (pc) is examined each clock tick (60th second); offset is subtracted from it, and the result multiplied by scale. If the resulting number corresponds to a word inside buff, that word is incremented.

The scale is interpreted as an unsigned, fixed-point fraction with binary point at the left: 0177777 (octal) gives a 1-1 mapping of pc’s to words in
 
buff; 077777 (octal) maps each pair of instruction words together. 02(octal) maps all instructions onto the beginning of buff (producing a non-interrupting core clock). 

Profiling is turned off by giving a scale of 0 or 1.  It is rendered ineffective by giving a bufsiz of 0.  Profiling is turned off when an exec is executed, but remains on in child and parent both after a fork. Profiling will be turned off if an update in buff would cause a memory fault. 

RETURN VALUE

A 0 is returned upon success.  The only time this service fails is on the CX/RT kernel, when profiling has not been enabled.  In this case profil returns a −1 and errno will be set to EACCES. 

WARNING

In the CX/RT kernel, profiling is not supported by default.  To enable the profil system call the USERPROFILE flag must be specified in the configuration file. 

NOTE

The format of a profile file is not guaranteed to be portable across systems provided by different vendors.  In particular, Motorola 88000 programs which are certified to conform to the 88open Compatibility Standards may not be profilable on a foreign system. 

SEE ALSO

monitor(3C). 
prof(1) in the CX/UX User’s Reference Manual. 

CX/UX Programmer’s Reference Manual