st_strerror - translate a libst return code to a printable
error message
#include <st.h>
st_status_t st_strerror(
st_status_t errcode,
char *buf,
int buflen );
Symbol Table and Object File Access Library (libst.a)
Status code returned by a function defined in the symbol
table and object file access library (libst.a). Specifies
an address to which st_strerror() will copy a printable
error message string. Specifies the size in bytes of the
memory region addressed by the buf parameter.
The st_strerror() function translates a libst error code
to a printable error message and copies that error message
to the memory region addressed by the buf parameter. If
the error message exceeds the size, in bytes, of the memory
region specified by the buflen parameter, st_strerror()
will truncate the error message.
The error codes recognized and translated by the st_strerror()
function are defined in /usr/include/st.h.
All functions indicate success by returning a value of 0
(zero). A positive return value is an errno value from a
system call. A negative return value is a library error or
informational code. The library codes are documented in
st.h.
This code fragment illustrates how to use st_strerror() to
report an error returned by a libst routine.
#include <st.h>
...
st_obj_t *obj; st_status_t status; char
*objname char errmsg[128];
...
if (status = st_obj_open(&obj, objname, ST_RDWR)) {
st_strerror(status, errmsg, sizeof(errmsg));
fprintf(stderr, "st_obj_open failure: %s\n",
errmsg);
exit(1); }
...
Header file that contains definitions (including error
codes) and function prototypes for libst.a functions
Functions: libst_intro(3), st_obj_open(3)
st_strerror(3)
[ Back ] |