svcadm(1M)을 검색하려면 섹션에서 1M 을 선택하고, 맨 페이지 이름에 svcadm을 입력하고 검색을 누른다.
dax_set_debug(3dax)
dax_set_debug(3DAX) DAX Library Functions dax_set_debug(3DAX)
NAME
dax_set_debug, DAX_DEBUG_EXTRA - set debugging options
SYNOPSIS
cc [ flag... ] file... -ldax [ library...]
#include <dax.h>
dax_status_t
dax_set_debug(dax_context_t *ctx, uint64_t options);
DESCRIPTION
This function sets options to check arguments in the libdax functions
that use ctx.
The following are the values for the options parameter, and they can be
logically OR'd together:
DAX_DEBUG_ARG Check function arguments for validity before submit‐
ting them to DAX. Checks all conditions that return
DAX_EINVAL and DAX_ETHREAD. If this option is dis‐
abled, skips the checking of DAX_EINVAL and
DAX_ETHREAD. This reduces function CPU call time for
programs that have been debugged. The results are
undefined if checking is skipped and the arguments
are not valid.
DAX_DEBUG_EXTRA Perform more expensive consistency checks on the
data that requires accessing multiple elements of a
vector, such as summing aux_data lengths. Not recom‐
mended for production code.
DAX_DEBUG_SYNC Wait for the DAX command to complete before return‐
ing from the post functions. In other words, execute
the command synchronously. This flag can only be set
if there are no outstanding requests in the queue.
If the command is posted with one of the dax_post()
DAX_PIPE_XXXX flags, the pipe is not used. Not rec‐
ommended for production code.
DAX_DEBUG_PERF Enable the DAX DTrace probes. If you omit this
option, DTrace probes are not invoked.
DAX_DEBUG_ALL Enable all debugging options
DAX_DEBUG_OFF Disable all debugging options
In addition, adds the options specified by the DAX_DEBUG_OPTIONS envi‐
ronment variable to the enabled set. Its format is a comma separated
list of option names with no whitespace. Recognized names are arg,
extra, and all.
Disables an option if it is not specified either in options or in
DAX_DEBUG_OPTIONS.
If the function returns an error, there is no change in the debug
options.
RETURN VALUES
DAX_SUCCESS Operation completed successfully
DAX_ETHREAD The calling thread did not create ctx
DAX_EINVAL Unrecognized flag in the options
DAX_EQFULL DAX_DEBUG_SYNC is requested and one of the queues in ctx
has outstanding requests.
USAGE
After debugging the application, to optimize performance, disable
debugging by using the DAX_DEBUG_OFF option. Bugs that would be caught
on function entry with DAX_DEBUG_ARG may instead be caught during DAX
execution and cause errors such as DAX_EPARSE or DAX_EDATAFMT, but this
is not guaranteed; the function may return DAX_SUCCESS but produce
incorrect output.
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
tab() box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) ATTRIBUTE TYPEAT‐
TRIBUTE VALUE _ Availabilitysystem/library _ Interface StabilityCommit‐
ted
SEE ALSO
libdax(3LIB), dax_thread_init(3DAX), dax_dtrace(3DAX)
Oracle Solaris 11.4 03 Mar 2017 dax_set_debug(3DAX)