svcadm(8)을 검색하려면 섹션에서 8 을 선택하고, 맨 페이지 이름에 svcadm을 입력하고 검색을 누른다.
dax_get_props(3dax)
dax_get_props(3DAX) DAX Library Functions dax_get_props(3DAX)
NAME
dax_get_props - get properties
SYNOPSIS
cc [ flag... ] file... -ldax [ library...]
#include <dax.h>
dax_status_t dax_get_props(dax_context_t *ctx, dax_props_t *props);
DESCRIPTION
This function returns in props the properties of DAX for the API ver‐
sion used to create the ctx.
The members of props are:
max_elem_bits Maximum number of bits in a bit-sized ele‐
ment. DAX supports any number of bits from 1
to max_elem_bits.
max_elem_bytes Maximum number of bytes in a fixed-width
byte-sized element such that DAX supports
any number of bytes from 1 to
max_elem_bytes.
max_log_elem_bytes Maximum number of bytes in a fixed-width
byte-sized element for power-of-2 sizes. DAX
supports sizes of 2^i where i can have any
value from 0 to max_log_elem_bytes, inclu‐
sive. In some versions of the libdax
library, 2^max_log_elem_bytes may be larger
than max_elem_bytes.
max_var_elem_bytes Maximum number of bytes in a variable-width
byte-sized element. DAX supports any number
of bytes from 1 to max_var_elem_bytes.
max_rle_elem_bits Maximum number of bits in the length element
of a run-length vector. DAX supports any
number of bits from 1 to max_rle_elem_bits
by powers of 2.
max_width_elem_bits Maximum number of bits in the width element
of a widths vector. DAX supports any number
of bits from 1 to max_width_elem_bits by
powers of 2.
max_scan_value_bytes Maximum number of significant bytes in
dax_int_t, used as the scan value and scan
range comparison value(s).
dst_align Required alignment in bytes for the destina‐
tion buffer in all DAX operations.
dst_pad Required length in bytes for rounding and
additional padding in all DAX operations.
For more information, see the
dax_vec_t(3DAX) man page.
zip_align Required alignment for a dax_zip_create_con‐
tig() codec.
zip_align_best The optimal alignment for a codec in the
dax_zip_create_contig() function. This may
be larger than zip_align.
trans_bitmap_align Required alignment for a dax_translate()
bitmap.
trans_bitmap_align_best The optimal alignment for a bitmap in the
dax_translate() function. This may be larger
than trans_bitmap_align.
large_elem_align Required alignment in bytes of byte-sized
input elements whose width is greater than
max_elem_bytes.
max_native_bitmap Maximum number of bits in a dax_translate()
bitmap that DAX supports natively. DAX can
support more bits but with lower efficiency.
max_zip_symbols Maximum number of symbols in a zip codec.
max_zip_contig The maximum buffer size for the
dax_zip_get_contig() function.
zip_constrained If the sum of zip symbol lengths is con‐
strained to 14 bytes as described in
dax_zip_create(), this is 1, else 0.
zip_native If the codec in dax_zip_create_contig() is
passed directly to DAX without conversion,
this is 1, else 0.
ones_saturates When an index written to the destination
buffer for the ONES_INDEX flag is too large
and the written value saturates at the maxi‐
mum value, this is 1. If DAX generates an
error for indices that are too large, this
is 0.
pipe If the dax_post() functions support the
DAX_PIPE_SRC, DAX_PIPE_AUX, and
DAX_PIPE_MASK flags, this is 1, else 0.
max_src_len Maximum number of src elements in a single
DAX hardware command. For larger vectors,
libdax breaks the vector into multiple DAX
commands.
max_dst_len Maximum number of dst vector bytes in a sin‐
gle DAX hardware command. For larger vec‐
tors, libdax breaks the vector into multiple
DAX commands.
debug_options A mask of the dax_set_debug() options sup‐
ported by this version.
log_options A mask of the dax_set_log() options sup‐
ported by this version.
The values of the properties for each version of the libdax API are as
follows.
tab(); lw(NaNi) lw(NaNi) lw(NaNi) lw(NaNi) lw(NaNi) lw(NaNi) Prop‐
ertylibdax Version 1libdax Version 2 max_elem_bits1624
max_elem_bytes1616 max_log_elem_bytes44 max_var_elem_bytes1616
max_rle_elem_bits88 max_width_elem_bits88 max_scan_value_bytes1616
max_native_bitmap32K64K max_zip_symbols10241024 max_zip_contig40988192
zip_constrained10 zip_native01 ones_saturates11 dst_align6464
dst_pad6464 zip_align1616 zip_align_best168192 trans_bitmap_align6416
trans_bitmap_align_best40968192 large_elem_align11 max_src_len16M16M
max_dst_len64M64M debug_optionsT{
DAX_DEBUG_ARG
DAX_DEBUG_EXTRA
DAX_DEBUG_SYNC
DAX_DEBUG_PERF
T}T{
DAX_DEBUG_ARG
DAX_DEBUG_EXTRA
DAX_DEBUG_SYNC
DAX_DEBUG_PERF
T} log_optionsT{
DAX_LOG_ERROR
DAX_LOG_ENTRY
DAX_LOG_PERF
DAX_LOG_RETURN
DAX_LOG_VERBOSE
DAX_LOG_WARNING
T}T{
DAX_LOG_ERROR
DAX_LOG_ENTRY
DAX_LOG_PERF
DAX_LOG_RETURN
DAX_LOG_VERBOSE
DAX_LOG_WARNING
T}
Note -
If the function returns an error, props is not modified.
RETURN VALUES
DAX_SUCCESS Operation completed successfully
DAX_ETHREAD The calling thread did not create ctx
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
dax_scan_value(3DAX), dax_zip_create(3DAX), dax_copy(3DAX),
dax_vec_t(3DAX), dax_set_debug(3DAX), dax_set_log(3DAX)
Oracle Solaris 11.4 17 Aug 2017 dax_get_props(3DAX)