NAME    [Toc]    [Back]

       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

SYNOPSIS    [Toc]    [Back]

       #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 );

LIBRARY    [Toc]    [Back]

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

PARAMETERS    [Toc]    [Back]

       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  containing  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.  Specifies 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.  Specifies
 an address to which st_file_sym_start()  writes  the
       handle of the first symbol for the specified file.

DESCRIPTION    [Toc]    [Back]

       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  complete  set  of  symbolic  information  (for
       instance, if it was not  compiled  with  the  -g  option).
       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    [Toc]    [Back]

       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
       nonzero  return  status  is  the  recommended  method  for
       detecting an error return from a libst function.

FILES    [Toc]    [Back]

       Header file that contains  all  definitions  and  function
       prototypes for libst.a functions Header file that controls
       name-demangling operations for  C++  objects  Header  file
       that   defines  source  language  types  returned  by  the
       st_file_lang() function.

SEE ALSO    [Toc]    [Back]

       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)



                                                  st_file_lang(3)