osf1 man page for st_strerror

st_strerror(3)						     Library Functions Manual						    st_strerror(3)

NAME
       st_strerror - Translate a libst return code to a printable error message.

LIBRARY
       Symbol Table and Object File Access Library (libst.a)

SYNOPSIS
       #include <st.h>

       st_status_t st_strerror (
	       st_status_t errcode,
	       char *buf,
	       int buflen);

PARAMETERS
       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 a printable error message string.  Specifies the size in bytes of the memory region addressed by the buf parameter.

DESCRIPTION
       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.

RETURN VALUES
       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.

EXAMPLE
       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
", errmsg);
	     exit(1); }

       ...

FILES
       Header file that contains definitions (including error codes) and function prototypes for libst.a functions

RELATED INFORMATION
       Functions: libst_intro(3), st_obj_open(3) delim off

																    st_strerror(3)