sgigetdsoversion(3C)

NAME
     sgigetdsoversion - gets the interface version of a shared object

SYNOPSIS
     cc [flag ...] file ...  -lc [library ...]

     #include <dlfcn.h>

     char *sgigetdsoversion(const char *pathname);

DESCRIPTION
     sgigetdsoversion returns a pointer to the the interface version string of
     the shared object with the -soname  the same as the argument pathname.
     If there is no shared object with that soname sgigetdsoversion returns 0
     (NULL).

     The returned string pointer is valid until the shared object named by
     pathname is dlclose(3)d.  The string space pointed to by the return value
     must not be free(3)ed.

     Link with -lc to use this function.

     Version strings are described in detail in dso(5) in the answer to the
     question "How are multiple versions of DSOs supported?".  Versions
     strings are put into a shared object with the ld option -set_version.
     One valid version string would be the empty string, "" (representing a
     shared object for which no -set_version option was passed to ld).
     Another example of a version string is "sgi1.0:sgi1.2".

DIAGNOSTICS
     Returns NULL (0) or a pointer to a string.

SEE ALSO
     dlopen(3) dlerror(3), dlclose(3), dlsym(3), sgidlopen_version(3),
     sgidladd(3), dso(5).