rciErrorStack(3)

NAME
rciErrorMsg, rciGetErrorMsg, rciGetErrorCode, rciSetErrorCode, rciNumErrors, rciPopError, rciClearErrors, rciDumpErrorMsgs, rciPrintErrors -- Error stack management routines for RCI tasks.

USAGE
#include <rci.h>

rciErrorMsg(td, code, format [arg,] ...)
   RCI_DESC *td;
   int code;
   char *format;

char *rciGetErrorMsg(td, level)
   RCI_DESC *td;
   int level;

rciGetErrorCode(td, level)
   RCI_DESC *td;
   int level;

rciSetErrorCode(td, level, code)
   RCI_DESC *td;
   int level;
   int code;

rciNumErrors(td)
   RCI_DESC *td;

rciPopError(td)
   RCI_DESC *td;

rciClearErrors(td)
   RCI_DESC *td;

rciDumpErrorMsgs(td, buf, size)
   RCI_DESC *td;
   char *buf;
   int size;

rciPrintErrors(td)
   RCI_DESC *td;

ARGUMENTS

td --
    Pointer to RCI task descriptor.

code --
    Error code.

format --
    printf style format string.

level --
    Indicates a level on the error stack, with 0 denoting the most recently added information.

buf --
    Buffer for receiving error messages.

size --
    Size of the buffer, in bytes.

DESCRIPTION
These routines are identical in function to the routines described in errorStack(3), except that instead of referencing the current error stack, they reference the error stack of a particular RCI task. This task is indicated by a descriptor which is passed to each routine as an additional (first) argument.

All routines can be called from any part of the RCI program.

The output from rciPrintErrors() goes to the same place as the output for rciPrintf().

If any of the routines are called with td given as NULL, then the current error stack is referenced (as if the corresponding errorStack(3) routine was called instead).

CAVEATS
No interlocking protection is provided against having different tasks use these routines to access the same error stack at the same time.

SEE ALSO
errorStack(3), rciAbortErrors(3).