diff options
author | Frank Baker <fbaker@hdfgroup.org> | 1999-12-17 15:34:35 (GMT) |
---|---|---|
committer | Frank Baker <fbaker@hdfgroup.org> | 1999-12-17 15:34:35 (GMT) |
commit | 654dfafca67958eb01fffcb5f840919e78bd641c (patch) | |
tree | 4e96e348365ca8f9f23c2f9fbf897ea698c68eaa /doc | |
parent | f17e2d273e083a5ac35975d90c9c74c1480e7d3c (diff) | |
download | hdf5-654dfafca67958eb01fffcb5f840919e78bd641c.zip hdf5-654dfafca67958eb01fffcb5f840919e78bd641c.tar.gz hdf5-654dfafca67958eb01fffcb5f840919e78bd641c.tar.bz2 |
[svn-r1886] RM_H5P.html
H5Pset/get_cache: Added missing rdcc_nelmts parameter.
Corrected inconsistent references to rdcc_wo parameter.
Clarified Purpose and Description sections.
H5Pget_sec2: Corrected return type from 'returntype' to 'herr_t'.
Diffstat (limited to 'doc')
-rw-r--r-- | doc/html/RM_H5P.html | 55 |
1 files changed, 32 insertions, 23 deletions
diff --git a/doc/html/RM_H5P.html b/doc/html/RM_H5P.html index c1170b8..41f4022 100644 --- a/doc/html/RM_H5P.html +++ b/doc/html/RM_H5P.html @@ -1793,7 +1793,7 @@ facilitate moving easily between them.</i> <dl> <dt><strong>Name:</strong> <a name="Property-GetSec2">H5Pget_sec2</a> <dt><strong>Signature:</strong> - <dd><em>returntype</em> <code>H5Pget_sec2</code>(<em>hid_t</em> <code>plist</code>) + <dd><em>herr_t</em> <code>H5Pget_sec2</code>(<em>hid_t</em> <code>plist</code>) <dt><strong>Purpose:</strong> <dd>Checks whether the file access property list is set to the sec2 driver. @@ -2213,28 +2213,31 @@ facilitate moving easily between them.</i> <dl> <dt><strong>Name:</strong> <a name="Property-SetCache">H5Pset_cache</a> <dt><strong>Signature:</strong> - <dd><em>herr_t</em> <code>H5Pset_cache</code>(<em>hid_t</em> <code>plist</code>, + <dd><em>herr_t</em> <code>H5Pset_cache</code>(<em>hid_t</em> <code>plist_id</code>, <em>int</em> <code>mdc_nelmts</code>, + <em>int</em> <code>rdcc_nelmts</code>, <em>size_t</em> <code>rdcc_nbytes</code>, <em>double</em> <code>rdcc_w0</code> ) <dt><strong>Purpose:</strong> - <dd>Sets the number of elements in the meta data cache and the - total number of bytes in the raw data chunk cache. + <dd>Sets the meta data cache and raw data chunk cache parameters. <dt><strong>Description:</strong> - <dd><code>H5Pset_cache</code> sets the number of elements (objects) - in the meta data cache and the total number of bytes in the - raw data chunk cache. + <dd><code>H5Pset_cache</code> sets + the number of elements (objects) in the meta data cache and + the number of elements, the total number of bytes, and + the preemption policy value in the raw data chunk cache. <p> - Sets or queries the meta data cache and raw data chunk cache - parameters. The <em>plist</em> is a file access property - list. The number of elements (objects) in the meta data cache - is <em>mdc_nelmts</em>. The total size of the raw data chunk - cache and the preemption policy is <em>rdcc_nbytes</em> and - <em>w0</em>. For <code>H5Pget_cache()</code> any (or all) of - the pointer arguments may be null pointers. + The <em>plist_id</em> is a file access property list. + The number of elements (objects) in the meta data cache + and the raw data chunk cache are <em>mdc_nelmts</em> and + <em>rdcc_nelmts</em>, respectively. + The total size of the raw data chunk cache and the preemption policy + are <em>rdcc_nbytes</em> and <em>rdcc_w0</em>. <p> - The RDCC_W0 value should be between 0 and 1 inclusive and + Any (or all) of the <code>H5Pget_cache()</code> pointer arguments + may be null pointers. + <p> + The <em>rdcc_w0</em> value should be between 0 and 1 inclusive and indicates how much chunks that have been fully read are favored for preemption. A value of zero means fully read chunks are treated no differently than other chunks (the @@ -2242,10 +2245,12 @@ facilitate moving easily between them.</i> read chunks are always preempted before other chunks. <dt><strong>Parameters:</strong> <dl> - <dt><em>hid_t</em> <code>plist</code> + <dt><em>hid_t</em> <code>plist_id</code> <dd>IN: Identifier of the file access property list. <dt><em>int</em> <code>mdc_nelmts</code> <dd>IN: Number of elements (objects) in the meta data cache. + <dt><em>int</em> <code>rdcc_nelmts</code> + <dd>IN: Number of elements (objects) in the raw data chunk cache. <dt><em>size_t</em> <code>rdcc_nbytes</code> <dd>IN: Total size of the raw data chunk cache, in bytes. <dt><em>double</em> <code>rdcc_w0</code> @@ -2269,25 +2274,29 @@ facilitate moving easily between them.</i> <dl> <dt><strong>Name:</strong> <a name="Property-GetCache">H5Pget_cache</a> <dt><strong>Signature:</strong> - <dd><em>herr_t</em> <code>H5Pget_cache</code>(<em>hid_t</em> <code>plist</code>, + <dd><em>herr_t</em> <code>H5Pget_cache</code>(<em>hid_t</em> <code>plist_id</code>, <em>int</em> <code>*mdc_nelmts</code>, + <em>int</em> <code>*rdcc_nelmts</code>, <em>size_t</em> <code>*rdcc_nbytes</code>, <em>double</em> <code>*rdcc_w0</code> ) <dt><strong>Purpose:</strong> - <dd>Retrieves maximum sizes of meta data cache and RDCC_WO. + <dd>Queries the meta data cache and raw data chunk cache parameters. <dt><strong>Description:</strong> <dd>Retrieves the maximum possible number of elements in the meta - data cache and the maximum possible number of bytes and the - RDCC_W0 value in the raw data chunk cache. Any (or all) - arguments may be null pointers in which case the corresponding - datum is not returned. + data cache and raw data chunk cache, the maximum possible number of + bytes in the raw data chunk cache, and the preemption policy value, + <em>rdcc_w0</em>. + Any (or all) arguments may be null pointers, in which case the + corresponding datum is not returned. <dt><strong>Parameters:</strong> <dl> - <dt><em>hid_t</em> <code>plist</code> + <dt><em>hid_t</em> <code>plist_id</code> <dd>IN: Identifier of the file access property list. <dt><em>int</em> <code>*mdc_nelmts</code> <dd>IN/OUT: Number of elements (objects) in the meta data cache. + <dt><em>int</em> <code>*rdcc_nelmts</code> + <dd>IN/OUT: Number of elements (objects) in the raw data chunk cache. <dt><em>size_t</em> <code>*rdcc_nbytes</code> <dd>IN/OUT: Total size of the raw data chunk cache, in bytes. <dt><em>double</em> <code>*rdcc_w0</code> |