osf1 man page for st_class_str

st_lang_str(3)						     Library Functions Manual						    st_lang_str(3)

NAME
       st_lang_str, st_type_str, st_class_str - Translate symbol table codes to printable strings.

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

SYNOPSIS
       #include <st.h>

       st_status_t st_lang_str (
	       st_obj_t *obj,
	       st_file_t file,
	       char *buf,
	       int buflen);

       st_status_t st_type_str (
	       st_obj_t *obj,
	       unsigned int type,
	       char *buf,
	       int buflen);

       st_status_t st_class_str (
	       st_obj_t *obj,
	       unsigned int sym_class,
	       char *buf,
	       int buflen);

PARAMETERS
       Specifies  an  object handle, as returned by the st_obj_open function.  Specifies an address to which these functions will copy a printable
       string.	Specifies the size in bytes of the memory region addressed by the buff parameter.  Specifies the handle of a file within the spec-
       ified  object (for example, the handle returned by st_obj_file_start).  Specifies the type of a symbol, as returned by st_sym_type.  Speci-
       fies the storage class of a symbol, as returned by st_sym_class.

DESCRIPTION
       These functions are used to get a printable string corresponding to an encoded value in an object file's  symbol  table.   The  st_lang_str
       function  determines  the  source language for a file.  The st_type_str and st_class_str functions translate type and class values, respec-
       tively, to their printable form.

       The buff parameter identifies an area of memory to which the st_lang_str, st_type_str, and st_class_str functions copy a printable  string.
       If the printable string exceeds the size specified by the buflen parameter, these functions truncate the printable string.

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.

       Return parameters are set to 0 or -1 when an error occurs.  Address parameters are set to 0, and file and procedure handles are set to  -1.
       An exception to this is if a NULL pointer for the object or other return parameter is input.  In these cases, the return parameters will be
       unchanged.  A non-zero return status is the recommended method for detecting an error return from a libst function.

FILES
       Header file that contains definitions and function prototypes for libst.a functions

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

																    st_lang_str(3)