Page tree

The license could not be verified: License Certificate has expired!

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Content Layer
id1195548671
Content Column
width50.00001%
id1195578110
classrm_pagetree_col mobile-hide
Content Block
id1195578111
 
Content Column
width50.00001%
id1195548673
classhdf-rm-main-column
Content Block
id1195548672
Hdf rm purpose

Excerpt

Sets free-list size limits.

HTML Wrap
classhdf-rm-content-block

Hdf rm procedure

H5_SET_FREE_LIST_LIMITS(reg_global_lim, reg_list_lim, arr_global_lim, arr_list_lim, blk_global_lim, blk_list_lim)

Hdf rm anchor
AnchorNamesignature

Signature:
HTML Wrap
classhdf-rm-section

Comment (Hide)

Edit each block below with the corresponding language signature for this function.

If there is no implementation for a given language, simply remove the entire block (right click --> Remove) for that language signature.

Hdf rm c signature

herr_t H5set_free_list_limitsint reg_global_limint reg_list_limint arr_global_limint arr_list_limint blk_global_limint blk_list_lim ) 

Hdf rm parameters
int reg_global_lim    IN: The cumulative limit, in bytes, on memory used for all regular free

lists 

lists.
(Default: 1MB)
int reg_list_limIN: The limit, in bytes, on memory used for each regular free

list 

list.
(Default: 64KB)
int arr_global_limIN: The cumulative limit, in bytes, on memory used for all array free

lists 

lists.
(Default: 4MB)
int arr_list_limIN: The limit, in bytes, on memory used for each array free

list 

list.
(Default: 256KB)
int blk_global_limIN: The cumulative limit, in bytes, on memory used for all block free lists and, separately, for all factory free

lists 

lists.
(Default: 16MB)
int blk_list_limIN: The limit, in bytes, on memory used for each block or factory free

list 

list.
(Default: 1MB)
Hdf rm description

H5set_free_list_limits sets size limits on all types of free lists. The HDF5 library uses free lists internally to manage memory. The types of free lists used are as follows:

  • Regular free lists manage memory for single internal data structures.
  • Array free lists manage memory for arrays of internal data structures.
  • Block free lists manage memory for arbitrarily-sized blocks of bytes.
  • Factory free lists manage memory for fixed-size blocks of bytes.

The parameters specify global and per-list limits; for example, reg_global_limit and reg_list_limit limit the accumulated size of all regular free lists and the size of each individual regular free list, respectively. Therefore, if an application sets a 1Mb limit on each of the global lists, up to 4Mb of total storage might be allocated, 1Mb for each of the regular, array, block, and factory type lists.

The settings specified for block free lists are duplicated for factory free lists. Therefore, increasing the global limit on block free lists by x bytes will increase the potential free list memory usage by 2x bytes.

Using a value of -1 for a limit means that no limit is set for the specified type of free list.

Hdf rm returnvals

Returns a non-negative value if successful; otherwise returns a negative value.

Hdf rm anchor
AnchorNameexample

Example:
HTML Wrap
classhdf-rm-section

Comment (Hide)

Edit each Bitbucket server macro below to point to example code hosted in Bitbucket.

If there is no implementation for a given language, simply remove the 'HTML Wrap' that the Bitbucket Server file macro resides in for that language.

If there IS an implemntation for a given language, but it's missing an example, replace the 'Bitbucket server file' macro with the text, "Example Coming Soon".

HTML Wrap
classhdf-togglebox hdf-c

Bitbucket Server file
repoSlughdf5
branchIdrefs/heads/1.10/master
projectKeyHDFFV
filepathexamples/h5_subset.c
showLineNumberstrue
lineStart32
progLangcpp
lineEnd42
applicationLink5ac7b370-7412-3c8c-ad20-807a68261336

HTML Wrap
classhdf-togglebox hdf-fortran hdf-togglebox-hidden

Bitbucket Server file
repoSlughdf5
branchIdrefs/heads/1.10/master
projectKeyHDFFV
filepathfortran/examples/compound.f90
showLineNumberstrue
lineStart25
progLangplain
lineEnd35
applicationLink5ac7b370-7412-3c8c-ad20-807a68261336

HTML Wrap
classhdf-togglebox hdf-cxx hdf-togglebox-hidden

Bitbucket Server file
repoSlughdf5
branchIdrefs/heads/1.10/master
projectKeyHDFFV
filepathc++/examples/create.cpp
showLineNumberstrue
lineStart33
progLangcpp
lineEnd43
applicationLink5ac7b370-7412-3c8c-ad20-807a68261336

HTML Wrap
classhdf-togglebox hdf-java hdf-togglebox-hidden

Bitbucket Server file
repoSlughdf5
branchIdrefs/heads/1.10/master
projectKeyHDFFV
filepathjava/examples/datasets/H5Ex_D_Chunk.java
showLineNumberstrue
lineStart32
progLangjava
lineEnd42
applicationLink5ac7b370-7412-3c8c-ad20-807a68261336

Hdf rm history
Release    C
1.6.0Function introduced in this release.
1.8.3Function changed in this release to set factory free list memory limits.