Pass information about dynamically compiled functions to the Collector for recording in the experiment. The parameter list is described in the following table.
Table 3–1 Parameter List for collector_func_load()
Parameter |
Definition |
---|---|
name |
The name of the dynamically compiled function that is used by the performance tools. The name does not have to be the actual name of the function. The name need not follow any of the normal naming conventions of functions, although it should not contain embedded blanks or embedded quote characters. |
alias |
An arbitrary string used to describe the function. It can be NULL. It is not interpreted in any way, and can contain embedded blanks. It is displayed in the Summary tab of the Analyzer. It can be used to indicate what the function is, or why the function was dynamically constructed. |
sourcename |
The path to the source file from which the function was constructed. It can be NULL. The source file is used for annotated source listings. |
vaddr |
The address at which the function was loaded. |
size |
The size of the function in bytes. |
lntsize |
A count of the number of entries in the line number table. It should be zero if line number information is not provided. |
lntable |
A table containing lntsize entries, each of which is a pair of integers. The first integer is an offset, and the second entry is a line number. All instructions between an offset in one entry and the offset given in the next entry are attributed to the line number given in the first entry. Offsets must be in increasing numeric order, but the order of line numbers is arbitrary. If lntable is NULL, no source listings of the function are possible, although disassembly listings are available. |