PR_SetLibraryPath

Registers a default library pathname with a runtime.

Syntax

#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.

Document Tags and Contributors

 Last updated by: teoli,