st_type_str(3) [osf1 man page]
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)
Check Out this Related Man Page
st_file_lang(3) Library Functions Manual st_file_lang(3) NAME
st_file_lang, st_file_name, st_is_file_locally_stripped, st_file_proc_start, st_file_proc_count, st_file_proc_next, st_file_sym_start - Access information about the files in an object LIBRARY
Symbol Table and Object File Access Library (libst.a) SYNOPSIS
#include <st.h> st_status_t st_file_lang ( st_obj_t *obj, st_file_t file, unsigned int *lang ); st_status_t st_file_name ( st_obj_t *obj, st_file_t file, char **fname ); st_status_t st_is_file_locally_stripped ( st_obj_t *obj, st_file_t file, st_bool_t *stripped ); st_status_t st_file_proc_start ( st_obj_t *obj, st_file_t file, st_proc_t *pstart ); st_status_t st_file_proc_count ( st_obj_t *obj, st_file_t file, unsigned int *pcount ); st_status_t st_file_proc_next ( st_obj_t *obj, st_file_t file, st_proc_t pcur, st_proc_t *pnext ); st_status_t st_file_sym_start ( st_obj_t *obj, st_file_t file, st_sym_t *isym ); PARAMETERS
Specifies an object handle, as returned by the st_obj_open function. Specifies a file handle, as returned by functions such as st_obj_file_start. Specifies an address to which st_file_lang returns the source language type of the specified file. Source language types are defined in /usr/include/symconst.h. Specifies an address to which st_file_name writes a pointer to a null-terminated string con- taining the filename of the specified file. The returned filename is for read-access only. A copy should be made before modifications are made to the string by the calling program. Specifies an address to which st_is_file_locally_stripped returns a Boolean value of TRUE if the specified file has been partially stripped. Specifies an address to which st_file_proc_start returns the handle of the first procedure in the specified file. Specifies an address to which st_file_proc_count writes the number of procedures within the specified file. Speci- fies the handle of a procedure within the specified file. st_file_proc_next uses this handle to determine pnext. Specifies an address to which st_file_proc_next returns the handle of the procedure following pcur in the specified file. If pcur equals or exceeds the number of procedures in the specified file, st_file_proc_next returns ST_E_PROC_RANGE and returns a -1 to the location to which pnext points. Speci- fies an address to which st_file_sym_start writes the handle of the first symbol for the specified file. DESCRIPTION
All of the functions described in this reference page return information about the files in an object: Identifies the source language (for example, C++) of the specified file. Returns a pointer to a null-terminated string containing the filename of the specified file. (Note: The returned filename is for read-access only. The calling program must make any modifications to a copy of the filename string.) Checks whether the file has been partially stripped. A partially stripped file does not contain a com- plete set of symbolic information (for instance, if it was not compiled with the -g flag). Returns the handle of the first procedure in the specified file. Returns the number of procedures within the specified file. Returns the handle of the procedure following pcur in the specified file. If pcur equals or exceeds the number of procedures for the specified file, st_file_proc_next returns ST_E_PROC_RANGE and sets pnext to -1. Returns the handle of the first symbol for the given file handle. 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 all definitions and function prototypes for libst.a functions header file that controls name-demangling opera- tions for C++ objects header file that defines source language types returned by the st_file_lang function. RELATED INFORMATION
Commands: atom(1) Functions: libst_intro(3), st_addr_to_file(3), st_obj_file_start(3), st_obj_open(3), st_objlist_append(3), st_proc_addr(3), st_sym_value(3) delim off st_file_lang(3)