NAME    [Toc]    [Back]

       st_get_known_versions,             st_get_format_versions,
       st_mem_get_format_versions,         st_get_version_byname,
       st_mem_get_version_byname,    st_fd_get_version_byname   -
       access version information in an object file

SYNOPSIS    [Toc]    [Back]

       #include <st.h>

       st_status_t st_get_known_versions(
               unsigned short *objver,
               unsigned short *symver ); st_status_t  st_get_format_versions(

               char *objname,
               unsigned short *objver,
               unsigned     short    *symver    );    st_status_t
       st_mem_get_format_versions(
               void *addr,
               unsigned short *objver,
               unsigned short *symver ); st_status_t  st_get_version_byname(

               char *objname,
               char *toolname,
               unsigned long *toolver,
               char  **verstring  );  st_status_t st_mem_get_version_byname(

               void *addr,
               unsigned long size,
               char *toolname,
               unsigned long *toolver,
               char  **verstring  );  st_status_t  st_fd_get_version_byname(

               int fd,
               off_t pos,
               char *toolname,
               unsigned long *toolver,
               char *verstring );

LIBRARY    [Toc]    [Back]

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

PARAMETERS    [Toc]    [Back]

       Name of file to be opened Object file version stamp Symbol
       table version stamp Address of file in  memory  Identifier
       of tool version entry Numeric tool version from toolname's
       entry Printable tool version from toolname's entry

DESCRIPTION    [Toc]    [Back]

       These functions access version information  in  an  object
       file. The st_get_known_versions() routine returns the version
 stamp values  (from  the  file  /usr/include/stamp.h)
       that  libst.a was built with. The st_get_format_versions()
       and st_mem_get_format_versions() retrieve the object  file
       and  symbol table version stamps from a given object file.
       Use st_mem_get_format_versions() if the  contents  of  the
       object  have  been  memory-mapped or read into memory, and
       use st_get_format_versions(), otherwise.

       The st_get_version_byname(),  st_mem_get_version_byname(),
       and st_fd_get_version_byname() routines search the section
       for a tool-specific version entry for the tool  identified
       by  the  toolname  parameter.   Tool-specific versions are
       typically  recorded  only  for  system   utilities.    Use
       st_fd_get_version_byname()  for  a  file  that has already
       been opened, st_mem_get_version_byname() for a  file  that
       has   been   read   into   memory,   and  use  st_get_version_byname(),
 otherwise. The caller  is  responsible  for
       freeing  the  verstring parameter after a successful call;
       space for this character string is  dynamically  allocated
       by these libst functions.

RETURN VALUES    [Toc]    [Back]

       All  routines  return zero to indicate success and nonzero
       to indicate failure.

SEE ALSO    [Toc]    [Back]

       libst_intro(3), st_obj_open(3)



                                         st_get_known_versions(3)