summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorRobb Matzke <matzke@llnl.gov>1998-08-20 22:57:35 (GMT)
committerRobb Matzke <matzke@llnl.gov>1998-08-20 22:57:35 (GMT)
commit49133159c8bb1da1edf9e89971a842e50b545314 (patch)
treeb1fccecc5be463797bd9bbbb9a7a31b3afcda44a /doc
parent2c61dcc3ee50581ca29191f3d7ea891fcca3c4a2 (diff)
downloadhdf5-49133159c8bb1da1edf9e89971a842e50b545314.zip
hdf5-49133159c8bb1da1edf9e89971a842e50b545314.tar.gz
hdf5-49133159c8bb1da1edf9e89971a842e50b545314.tar.bz2
[svn-r609] Debugging.html
Fixed errors H5.c Fixed core dump with setvbuf() for debugging. H5Fistore.c Fixed bug with sparse datasets. H5Omtime.c Found a typo in "Posix Programmer's Guide". The `%z' in the strftime() should be `%Z' instead. H5T.c H5Tpublic.h Improved api tracing for H5Tinsert_array(). h5tools.c Doesn't dump core for empty datasets.
Diffstat (limited to 'doc')
-rw-r--r--doc/html/Debugging.html25
1 files changed, 14 insertions, 11 deletions
diff --git a/doc/html/Debugging.html b/doc/html/Debugging.html
index 8c0c4cc..bd531f8 100644
--- a/doc/html/Debugging.html
+++ b/doc/html/Debugging.html
@@ -10,7 +10,7 @@
<h2>Introduction</h2>
<p>The HDF5 library contains a number of debugging features to
- make programmers lives easier including the ability to print
+ make programmers' lives easier including the ability to print
detailed error messages, check invariant conditions, display
timings and other statistics, and trace API function calls and
return values.
@@ -27,7 +27,7 @@
<br><br>
<dt><b>Invariant Conditions</b>
- <dd>Unless <code>NDEBUG</code> is defined during compiling the
+ <dd>Unless <code>NDEBUG</code> is defined during compiling, the
library will include code to verify that invariant conditions
have the expected values. When a problem is detected the
library will display the file and line number within the
@@ -63,14 +63,17 @@
<p>
<center>
<table border align=center width="100%">
- <caption align=top><h4>Example: An Error Message</h4></caption>
<tr>
<td>
<p><code><pre>
+
HDF5-DIAG: Error detected in thread 0. Back trace follows.
- #000: H5T.c line 462 in H5Tclose(): predefined data type
- major(01): Function argument
- minor(05): Bad value
+ #000: H5F.c line 1245 in H5Fopen(): unable to open file
+ major(04): File interface
+ minor(10): Unable to open file
+ #001: H5F.c line 846 in H5F_open(): file does not exist
+ major(04): File interface
+ minor(10): Unable to open file
</code></pre>
</td>
</tr>
@@ -78,7 +81,7 @@ HDF5-DIAG: Error detected in thread 0. Back trace follows.
</center>
<p>The error handling package (H5E) is described
- <a href="Errors.html">here</a>.
+ <a href="Errors.html">elsewhere</a>.
<h2>Invariant Conditions</h2>
@@ -92,10 +95,10 @@ HDF5-DIAG: Error detected in thread 0. Back trace follows.
<p>
<center>
<table border align=center width="100%">
- <caption align=top><h4>Example: A Failed Assertion</h4></caption>
<tr>
<td>
<p><code><pre>
+
Assertion failed: H5.c:123: i&lt;NELMTS(H5_debug_g)
IOT Trap, core dumped.
</code></pre>
@@ -263,10 +266,10 @@ IOT Trap, core dumped.
<p>
<center>
<table border align=center width="100%">
- <caption align=top><b>Sample Output</b></caption>
<tr>
<td>
<code><pre>
+
H5Tcopy(type=184549388) = 184549419 (type);
H5Tcopy(type=184549392) = 184549424 (type);
H5Tlock(type=184549424) = SUCCEED;
@@ -297,7 +300,6 @@ HDF5-DIAG: Error detected in thread 0. Back trace follows.
<p>
<center>
<table border align=center width="100%">
- <caption align=top><b>Execution Examples</b></caption>
<tr>
<td>To display the trace on the standard error stream:
<code><pre>
@@ -378,6 +380,7 @@ $ env HDF5_DEBUG="55 trace" a.out 55>trace-output
<tr>
<td>
<code><pre>
+
$ ../bin/trace *.c
H5E.c: in function `H5Ewalk_cb':
H5E.c:336: warning: trace info was not inserted
@@ -402,7 +405,7 @@ H5E.c:336: warning: trace info was not inserted
<address><a href="mailto:matzke@llnl.gov">Robb Matzke</a></address>
<!-- Created: Wed Jun 17 12:29:12 EDT 1998 -->
<!-- hhmts start -->
-Last modified: Wed Aug 19 15:21:35 PDT 1998
+Last modified: Thu Aug 20 10:43:42 PDT 1998
<!-- hhmts end -->
</body>
</html>