Go to main content

man pages section 3: Extended Library Functions, Volume 2

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

dtrace_ctlfd (3DTRACE)

Name

dtrace_ctlfd - DTrace control file descriptor

Synopsis

    cc [ flag... ] file... -ldtrace [ library... ]
     #include <dtrace.h>

     int dtrace_ctlfd(dtrace_hdl_t *dtp)

Description

The dtrace_ctlfd() function returns the file descriptor that's being used to communicate with the /dev/dtrace.

Return Values

On successful completion, the dtrace_ctlfd() function returns the file descriptor being used to communicate with the /dev/dtrace. On failure, the function returns -1 and sets the DTrace error number to indicate the reason for the failure. See the dtrace_errno(3DTRACE) man page for more information.

Errors

The dtrace_ctlfd() function will fail if:

EINVAL

dtp is NULL.

Attributes

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

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Architecture
all
Availability
system/dtrace
Interface Stability
Committed
MT-Level
Safe

See Also

libdtrace(3LIB), dtrace_errno(3DTRACE)