st_get_known_versions(3)st_get_known_versions(3)NAME
st_get_known_versions, st_get_format_versions, st_mem_get_format_ver‐
sions, st_get_version_byname, st_mem_get_version_byname, st_fd_get_ver‐
sion_byname - access version information in an object file
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_ver‐
sions(
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
Symbol Table and Object File Access Library (libst.a)
PARAMETERS
Name of file to be opened Object file version stamp Symbol table ver‐
sion 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 use st_get_format_ver‐
sions(), otherwise.
The st_get_version_byname(), st_mem_get_version_byname(), and
st_fd_get_version_byname() routines search the section for a tool-spe‐
cific version entry for the tool identified by the toolname parameter.
Tool-specific versions are typically recorded only for system utili‐
ties. 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
All routines return zero to indicate success and nonzero to indicate
failure.
SEE ALSOlibst_intro(3), st_obj_open(3)st_get_known_versions(3)