SGIGETDSOVERSION(3C)					  SGIGETDSOVERSION(3C)

NAME    [Toc]    [Back]

     sgigetdsoversion -	gets the interface version of a	shared object

SYNOPSIS    [Toc]    [Back]

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

     #include <dlfcn.h>

     char *sgigetdsoversion(const char *pathname);

DESCRIPTION    [Toc]    [Back]

     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    [Toc]    [Back]

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

SEE ALSO    [Toc]    [Back]

     dlopensgidladd(3), dso(5).


									PPPPaaaaggggeeee 1111