72 lines
1.5 KiB
Plaintext
Executable File
72 lines
1.5 KiB
Plaintext
Executable File
\section NAME
|
|
liberror - error reporting library
|
|
\break
|
|
|
|
\section DESCRIPTION
|
|
liberror is the resident library under C-Ware for reporting error
|
|
\break
|
|
messages in a structured, computer-readable format. As described in
|
|
\break
|
|
\bold-on
|
|
cware
|
|
\bold-off
|
|
(cware), liberror produces error messages in the format:
|
|
\break
|
|
\break
|
|
\bold-on
|
|
\set-indent 4
|
|
{TYPE}\\t{FUNCTION}\\t{ERROR-MESSSAGE}\\t{FILE}\\t{LINE}
|
|
\set-indent 0
|
|
\bold-off
|
|
\break
|
|
\break
|
|
Liberror is intended to be used to allow togglable safety mechanisms
|
|
\break
|
|
in C-Ware code, like checking for NULL pointers. By design, the various
|
|
\break
|
|
components of the library are designed to be composed together into
|
|
\break
|
|
larger error checking operations to validate entire structures, for
|
|
\break
|
|
example. Also provided is a basic API for adding additional runtime
|
|
\break
|
|
error checks such as whether or not a structure has been passed through
|
|
\break
|
|
an operation that releases it from memory. All of this can be enabled
|
|
\break
|
|
through the definition of the
|
|
\space
|
|
\bold-on
|
|
CWARE_SAFETY_CHECKS
|
|
\bold-off
|
|
\space
|
|
macro. The manuals for the
|
|
\break
|
|
operations can be found below:
|
|
\break
|
|
\break
|
|
MANUAL
|
|
\set-indent 20
|
|
SYNOPSIS
|
|
\set-indent 0
|
|
\break
|
|
-----------------------------------------------------------------------
|
|
\break
|
|
LIBERROR_ASSERT(cware)
|
|
\set-indent 4
|
|
assert a condition with debugging information
|
|
\break
|
|
\set-indent 0
|
|
LIBERROR_TEST(cware)
|
|
\set-indent 6
|
|
wrapper over LIBERROR_ASSERT for testcases
|
|
\break
|
|
\set-indent 0
|
|
|
|
|
|
\section SEE ALSO
|
|
\bold-on
|
|
cware
|
|
\bold-off
|
|
(cware)
|