osf1 man page for st_get_format_versions

st_get_known_versions(3)				     Library Functions Manual					  st_get_known_versions(3)

NAME
       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_ver-
       sion_byname - Access version information in an object file

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

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

PARAMETERS
       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
       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 st_get_format_versions otherwise.

       The st_get_version_byname, st_mem_get_version_byname, and st_fd_get_version_byname routines search the .comment 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 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
       All routines return zero to indicate success and non-zero to indicate failure.

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

															  st_get_known_versions(3)