dtrace_dof_create, dtrace_dof_destroy - DTrace Object Format interface
cc [ flag... ] file... -ldtrace [ library... ] #include <dtrace.h> void *dtrace_dof_create(dtrace_hdl_t *dtp, dtrace_prog_t *pgp, uint_t flags) void dtrace_dof_destroy(dtrace_hdl_t *dtp, void *dof)
The dtrace_dof_create() function creates a DTrace Object Format (DOF) object, given a compile D program represented by the pgp argument. The dtp argument is the DTrace handle returned by the dtrace_open(3DTRACE) function. The flags argument specifies options for the DOF output.
The dtrace_dof_destroy() function deallocates an existing DOF object.
On successful completion, the dtrace_dof_create() function returns a pointer to a valid DOF object. On failure, the function returns NULL and sets the DTrace error number to indicate the reason for the failure. See the dtrace_errno(3DTRACE) man page for more information.
The dtrace_close() function does not return any value, although it sets the DTrace error number to indicate the reason for failure. See the dtrace_errno(3DTRACE) man page for more information.
The dtrace_dof_create() function will fail if:
dtp or pgp is NULL, or an invalid bit is set in flags.
The system was unable to allocate memory during the processing of this function.
The dtrace_dof_destroy() function will fail if:
dtp is NULL.
The possible values for the flags argument to the dtrace_dof_create() function are listed below:
Strip non-loadable sections from the object.
Include provider and probe definitions, for user-defined providers.
See attributes(7) for descriptions of the following attributes:
|