petsc-3.3-p7 2013-05-11

PetscDLLibrarySym

Load a symbol from the dynamic link libraries.

PetscErrorCode  PetscDLLibrarySym(MPI_Comm comm,PetscDLLibrary *outlist,const char path[],const char insymbol[],void **value)

Collective on MPI_Comm

	comm	- communicator that will open the library
	outlist	- list of already open libraries that may contain symbol (can be PETSC_NULL and only the executable is searched for the function)
	path	- optional complete library name (if provided checks here before checking outlist)
	insymbol	- name of symbol

value -if symbol not found then this value is set to PETSC_NULL

Notes: Symbol can be of the form [/path/libname[.so.1.0]:]functionname[()] where items in [] denote optional

Will attempt to (retrieve and) open the library if it is not yet been opened.