Index for Section 3

Alphabetical listing for S

Bottom of page

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_version_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_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
  Symbol Table and Object File Access Library (libst.a)

PARAMETERS
  objname or filename
      Name of file to be opened

  objver
      Object file version stamp

  symver
      Symbol table version stamp

  addr
      Address of file in memory

  toolname
      Identifier of tool version entry

  toolver
      Numeric tool version from toolname's entry

  verstring
      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_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 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 ALSO
  libst_intro(3), st_obj_open(3)

Index for Section 3

Alphabetical listing for S

Top of page