Source code
Revision control
Copy as Markdown
Other Tools
PR_SetLibraryPath
=================
Registers a default library pathname with a runtime.
Syntax
------
.. code::
#include <prlink.h>
PRStatus PR_SetLibraryPath(const char *path);
Parameters
~~~~~~~~~~
The function has this parameter:
``path``
A pointer to a character array that contains the directory path that
the application should use as a default. The syntax of the pathname
is not defined, nor whether that pathname should be absolute or
relative.
Returns
~~~~~~~
The function returns one of the following values:
- If successful, ``PR_SUCCESS``.
- If unsuccessful, ``PR_FAILURE``. This may indicate that the function
cannot allocate sufficient storage to make a copy of the path string
Description
-----------
This function registers a default library pathname with the runtime.
This allows an environment to express policy decisions globally and
lazily, rather than hardcoding and distributing the decisions throughout
the code.