User Tools

Site Tools


solaris:dtrace_dof_create.3dtrace

dtrace_dof_create


NAME

dtrace_dof_create, dtrace_dof_destroy - DTrace Object Format interface

SYNOPSIS

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)

DESCRIPTION

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.

RETURN VALUES

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.

ERRORS

The dtrace_dof_create() function will fail if:

EINVAL

dtp or pgp is NULL, or an invalid bit is set in flags.

EDT_NOMEM

The system was unable to allocate memory during the processing of this function.

The dtrace_dof_destroy() function will fail if:

EINVAL

dtp is NULL.

USAGE

The possible values for the flags argument to the dtrace_dof_create() function are listed below:

DTRACE_D_STRIP

Strip non-loadable sections from the object.

DTRACE_D_PROBES

Include provider and probe definitions, for user-defined providers.

ATTRIBUTES

See attributes(7) for descriptions of the following attributes:

SEE ALSO

libdtrace(3LIB), dtrace_errno(3DTRACE)


solaris/dtrace_dof_create.3dtrace.txt · Last modified: 2023/07/19 08:57 by A User Not Logged in