@Properties(inherit=hdf5.class) public class H5AC_cache_config_t extends Pointer
Pointer.CustomDeallocator, Pointer.Deallocator, Pointer.NativeDeallocator, Pointer.ReferenceCounter
Constructor and Description |
---|
H5AC_cache_config_t()
Default native constructor.
|
H5AC_cache_config_t(long size)
Native array allocator.
|
H5AC_cache_config_t(Pointer p)
Pointer cast constructor.
|
Modifier and Type | Method and Description |
---|---|
boolean |
apply_empty_reserve()
Boolean flag indicating whether the ageout based decrement
algorithms will maintain a empty reserve when decreasing cache size.
|
H5AC_cache_config_t |
apply_empty_reserve(boolean setter) |
boolean |
apply_max_decrement()
Boolean flag indicating ether an upper limit should be applied to
the size of cache size decreases.
|
H5AC_cache_config_t |
apply_max_decrement(boolean setter) |
boolean |
apply_max_increment()
Boolean flag indicating whether an upper limit should be applied to
the size of cache size increases.
|
H5AC_cache_config_t |
apply_max_increment(boolean setter) |
boolean |
close_trace_file()
Boolean field indicating whether the current trace file
(if any) should be closed.\n
See the above comments on the \ref H5AC_cache_config_t.open_trace_file
"open_trace_file" field.
|
H5AC_cache_config_t |
close_trace_file(boolean setter) |
int |
decr_mode()
Enumerated value indicating the operational mode of the tomatic
cache size decrease code.
|
H5AC_cache_config_t |
decr_mode(int setter) |
double |
decrement()
In the hit rate threshold cache size decrease algorithm, this
parameter contains the factor by which the current max cache size is
multiplied to produce a tentative new cache size.\n
The actual cache size decrease will be clipped to satisfy the
\ref H5AC_cache_config_t.min_size "min_size" specified in the general
configuration, and possibly \ref H5AC_cache_config_t.max_decrement
"max_decrement".\n
The parameter must be be in the interval [0.0, 1.0].\n
If you set it to 1.0, you will effectively
disable cache size decreases.
|
H5AC_cache_config_t |
decrement(double setter) |
long |
dirty_bytes_threshold()
Threshold number of bytes of dirty metadata generation for
triggering synchronizations of the metadata caches serving the target
file in the parallel case.\n Synchronization occurs whenever the number
of bytes of dirty metadata created since the last synchronization exceeds
this limit.\n This field only applies to the parallel case.
|
H5AC_cache_config_t |
dirty_bytes_threshold(long setter) |
double |
empty_reserve()
Empty reserve as a fraction maximum cache size if applicable.\n When
so directed, the ageout based algorithms will not decrease the maximum
cache size unless the empty reserve can be met.\n The parameter must lie
in the interval [0.0, 1.0].
|
H5AC_cache_config_t |
empty_reserve(double setter) |
long |
epoch_length()
Number of cache accesses between runs of the adaptive cache resize
code.
|
H5AC_cache_config_t |
epoch_length(long setter) |
int |
epochs_before_eviction()
In the ageout based cache size reduction algorithms, this field
contains the minimum number of epochs an entry must remain unaccessed in
cache before the cache size reduction algorithm tries to evict it.
|
H5AC_cache_config_t |
epochs_before_eviction(int setter) |
boolean |
evictions_enabled()
A boolean flag indicating whether evictions from the metadata cache
are enabled.
|
H5AC_cache_config_t |
evictions_enabled(boolean setter) |
int |
flash_incr_mode()
Enumerated value indicating the operational mode of the flash cache
size increase code.
|
H5AC_cache_config_t |
flash_incr_mode(int setter) |
double |
flash_multiple()
The factor by which the size of the triggering entry / entry size
increase is multiplied to obtain the initial cache size increment.
|
H5AC_cache_config_t |
flash_multiple(double setter) |
double |
flash_threshold()
The factor by which the current maximum cache size is multiplied to
obtain the minimum size entry / entry size increase which may trigger a
flash cache size increase.
|
H5AC_cache_config_t |
flash_threshold(double setter) |
H5AC_cache_config_t |
getPointer(long i) |
int |
incr_mode()
Enumerated value indicating the operational mode of the automatic
cache size increase code.
|
H5AC_cache_config_t |
incr_mode(int setter) |
double |
increment()
Factor by which the hit rate threshold cache size increment
algorithm multiplies the current cache max size to obtain a tentative
new cache size.\n
The actual cache size increase will be clipped to satisfy the \p max_size
specified in the general configuration, and possibly max_increment
below.\n
The parameter must be greater than or equal to 1.0 -- 2.0 is a reasonable
value.\n
If you set it to 1.0, you will effectively disable cache size increases.
|
H5AC_cache_config_t |
increment(double setter) |
long |
initial_size()
If \ref H5AC_cache_config_t.set_initial_size "set_initial_size"
is set to 1, \p initial_size must contain he desired initial size in
bytes.
|
H5AC_cache_config_t |
initial_size(long setter) |
double |
lower_hr_threshold()
Hit rate threshold used by the hit rate threshold cache size
increment algorithm.\n
When the hit rate over an epoch is below this threshold and the cache
is full, the maximum size of the cache is multiplied by increment
(below), and then clipped as necessary to stay within \p max_size, and
possibly \p max_increment.\n
This field must lie in the interval [0.0, 1.0].
|
H5AC_cache_config_t |
lower_hr_threshold(double setter) |
long |
max_decrement()
Maximum number of bytes by which the maximum cache size can be
decreased in any single step -- if applicable.
|
H5AC_cache_config_t |
max_decrement(long setter) |
long |
max_increment()
Maximum number of bytes by which cache size can be increased in a
single step -- if applicable.
|
H5AC_cache_config_t |
max_increment(long setter) |
long |
max_size()
Upper bound (in bytes) on the range of values that the
adaptive cache resize code can select as the maximum cache size.
|
H5AC_cache_config_t |
max_size(long setter) |
int |
metadata_write_strategy()
Desired metadata write strategy.
|
H5AC_cache_config_t |
metadata_write_strategy(int setter) |
double |
min_clean_fraction()
This field specifies the minimum fraction of the cache
that must be kept either clean or empty.\n
The value must lie in the interval [0.0, 1.0].
|
H5AC_cache_config_t |
min_clean_fraction(double setter) |
long |
min_size()
Lower bound (in bytes) on the range of values that the
adaptive cache resize code can select as the minimum cache * size.
|
H5AC_cache_config_t |
min_size(long setter) |
boolean |
open_trace_file()
Boolean field indicating whether the
\ref H5AC_cache_config_t.trace_file_name "trace_file_name"
field should be used to open a trace file for the cache.\n
The trace file is a debugging feature that allows the capture
of top level metadata cache requests for purposes of debugging
and/or optimization.
|
H5AC_cache_config_t |
open_trace_file(boolean setter) |
H5AC_cache_config_t |
position(long position) |
boolean |
rpt_fcn_enabled()
Boolean flag indicating whether the adaptive cache resize report
function is enabled.
|
H5AC_cache_config_t |
rpt_fcn_enabled(boolean setter) |
boolean |
set_initial_size()
Boolean flag indicating whether the cache should be created
with a user specified initial size.
|
H5AC_cache_config_t |
set_initial_size(boolean setter) |
BytePointer |
trace_file_name() |
byte |
trace_file_name(int i)
Full path of the trace file to be opened if the
\ref H5AC_cache_config_t.open_trace_file "open_trace_file" field is set
to 1.\n
In the parallel case, an ascii representation of the MPI rank of the
process will be appended to the file name to yield a unique trace file
name for each process.\n
The length of the path must not exceed #H5AC__MAX_TRACE_FILE_NAME_LEN
characters.\n
The trace file feature is unsupported unless used at the direction of
The HDF Group.
|
H5AC_cache_config_t |
trace_file_name(int i,
byte setter) |
double |
upper_hr_threshold()
Hit rate threshold for the hit rate threshold and ageout with hit
rate threshold cache size decrement algorithms.\n
When \p decr_mode is #H5C_decr__threshold, and the hit rate over a given
epoch exceeds the supplied threshold, the current maximum cache
size is multiplied by decrement to obtain a tentative new (and smaller)
maximum cache size.\n
When \p decr_mode is #H5C_decr__age_out_with_threshold, there is
no attempt to find and evict aged out entries unless the hit rate in
the previous epoch exceeded the supplied threshold.\n
This field must lie in the interval [0.0, 1.0].\n
For #H5C_incr__threshold, .9995 or .99995 is a good place to start.\n
For #H5C_decr__age_out_with_threshold, .999 might be more useful.
|
H5AC_cache_config_t |
upper_hr_threshold(double setter) |
int |
version()
Integer field indicating the version of the H5AC_cache_config_t
in use.
|
H5AC_cache_config_t |
version(int setter) |
address, asBuffer, asByteBuffer, availablePhysicalBytes, calloc, capacity, capacity, close, deallocate, deallocate, deallocateReferences, deallocator, deallocator, equals, fill, formatBytes, free, getDirectBufferAddress, getPointer, getPointer, getPointer, hashCode, interruptDeallocatorThread, isNull, isNull, limit, limit, malloc, maxBytes, maxPhysicalBytes, memchr, memcmp, memcpy, memmove, memset, offsetAddress, offsetof, offsetof, parseBytes, physicalBytes, physicalBytesInaccurate, position, put, realloc, referenceCount, releaseReference, retainReference, setNull, sizeof, sizeof, toString, totalBytes, totalCount, totalPhysicalBytes, withDeallocator, zero
public H5AC_cache_config_t()
public H5AC_cache_config_t(long size)
Pointer.position(long)
.public H5AC_cache_config_t(Pointer p)
Pointer(Pointer)
.public H5AC_cache_config_t position(long position)
public H5AC_cache_config_t getPointer(long i)
getPointer
in class Pointer
public int version()
public H5AC_cache_config_t version(int setter)
@Cast(value="hbool_t") public boolean rpt_fcn_enabled()
public H5AC_cache_config_t rpt_fcn_enabled(boolean setter)
@Cast(value="hbool_t") public boolean open_trace_file()
public H5AC_cache_config_t open_trace_file(boolean setter)
@Cast(value="hbool_t") public boolean close_trace_file()
public H5AC_cache_config_t close_trace_file(boolean setter)
@Cast(value="char") public byte trace_file_name(int i)
public H5AC_cache_config_t trace_file_name(int i, byte setter)
@MemberGetter @Cast(value="char*") public BytePointer trace_file_name()
@Cast(value="hbool_t") public boolean evictions_enabled()
public H5AC_cache_config_t evictions_enabled(boolean setter)
@Cast(value="hbool_t") public boolean set_initial_size()
public H5AC_cache_config_t set_initial_size(boolean setter)
@Cast(value="size_t") public long initial_size()
public H5AC_cache_config_t initial_size(long setter)
public double min_clean_fraction()
public H5AC_cache_config_t min_clean_fraction(double setter)
@Cast(value="size_t") public long max_size()
public H5AC_cache_config_t max_size(long setter)
@Cast(value="size_t") public long min_size()
public H5AC_cache_config_t min_size(long setter)
public long epoch_length()
public H5AC_cache_config_t epoch_length(long setter)
@Cast(value="H5C_cache_incr_mode") public int incr_mode()
public H5AC_cache_config_t incr_mode(int setter)
public double lower_hr_threshold()
public H5AC_cache_config_t lower_hr_threshold(double setter)
public double increment()
public H5AC_cache_config_t increment(double setter)
@Cast(value="hbool_t") public boolean apply_max_increment()
public H5AC_cache_config_t apply_max_increment(boolean setter)
@Cast(value="size_t") public long max_increment()
public H5AC_cache_config_t max_increment(long setter)
@Cast(value="H5C_cache_flash_incr_mode") public int flash_incr_mode()
public H5AC_cache_config_t flash_incr_mode(int setter)
public double flash_multiple()
public H5AC_cache_config_t flash_multiple(double setter)
public double flash_threshold()
public H5AC_cache_config_t flash_threshold(double setter)
@Cast(value="H5C_cache_decr_mode") public int decr_mode()
public H5AC_cache_config_t decr_mode(int setter)
public double upper_hr_threshold()
public H5AC_cache_config_t upper_hr_threshold(double setter)
public double decrement()
public H5AC_cache_config_t decrement(double setter)
@Cast(value="hbool_t") public boolean apply_max_decrement()
public H5AC_cache_config_t apply_max_decrement(boolean setter)
@Cast(value="size_t") public long max_decrement()
public H5AC_cache_config_t max_decrement(long setter)
public int epochs_before_eviction()
public H5AC_cache_config_t epochs_before_eviction(int setter)
@Cast(value="hbool_t") public boolean apply_empty_reserve()
public H5AC_cache_config_t apply_empty_reserve(boolean setter)
public double empty_reserve()
public H5AC_cache_config_t empty_reserve(double setter)
@Cast(value="size_t") public long dirty_bytes_threshold()
public H5AC_cache_config_t dirty_bytes_threshold(long setter)
public int metadata_write_strategy()
public H5AC_cache_config_t metadata_write_strategy(int setter)
Copyright © 2024. All rights reserved.