*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Tru64 Unix man pages -> st_class_str (3)              



NAME    [Toc]    [Back]

       st_lang_str,  st_type_str, st_class_str - translate symbol
       table codes to printable strings

SYNOPSIS    [Toc]    [Back]

       #include <st.h>

       st_status_t st_lang_str(
               st_obj_t *obj,
               st_file_t file,
               char *buf,
               int buflen ); st_status_t st_type_str(
               st_obj_t *obj,
               unsigned int type,
               char *buf,
               int buflen ); st_status_t st_class_str(
               st_obj_t *obj,
               unsigned int sym_class,
               char *buf,
               int buflen );

PARAMETERS    [Toc]    [Back]

       Specifies  an  object   handle,   as   returned   by   the
       st_obj_open()  function.   Specifies  an  address to which
       these functions will copy a printable  string.   Specifies
       the  size  in  bytes of the memory region addressed by the
       buf parameter.  Specifies the handle of a file within  the
       specified  object,  for  example,  the  handle returned by
       st_obj_file_start().  Specifies the type of a  symbol,  as
       returned by st_sym_type().  Specifies the storage class of
       a symbol, as returned by st_sym_class().

DESCRIPTION    [Toc]    [Back]

       These functions are used to get a printable string  corresponding
  to  an  encoded value in an object file's symbol
       table. The st_lang_str() function  determines  the  source
       language  for a file. The st_type_str() and st_class_str()
       functions translate type and class  values,  respectively,
       to their printable form.

       The  buf  parameter  identifies an area of memory to which
       the st_lang_str(), st_type_str(), and st_class_str() functions
  copy  a  printable  string. If the printable string
       exceeds the size specified by the buflen parameter,  these
       functions truncate the printable string.

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

       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 definitions and function prototypes
 for libst.a functions

SEE ALSO    [Toc]    [Back]

       Functions:         libst_intro(3),         st_obj_open(3),
       st_obj_file_start(3), st_sym_type(3), st_sym_class(3)

[ Back ]
 Similar pages
Name OS Title
st_strerror Tru64 translate a libst return code to a printable error message
ldgetname IRIX retrieve symbol name for object file symbol table entry
ldgetname Tru64 retrieve symbol name for object file symbol table entry
strccpy IRIX copy strings, compressing or expanding escape codes
strings NetBSD print the strings of printable characters in files
strings OpenBSD print the strings of printable characters in files
strings Linux print the strings of printable characters in files.
strings FreeBSD print the strings of printable characters in files.
strings HP-UX find the printable strings in an object or other binary file
strings IRIX find printable strings in an object file or binary
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service