File: pr_setlibrarypath.rst

package info (click to toggle)
firefox 148.0.2-1
  • links: PTS, VCS
  • area: main
  • in suites: sid
  • size: 4,719,544 kB
  • sloc: cpp: 7,618,291; javascript: 6,701,749; ansic: 3,781,787; python: 1,418,389; xml: 638,647; asm: 438,962; java: 186,285; sh: 62,894; makefile: 19,011; objc: 13,092; perl: 12,763; yacc: 4,583; cs: 3,846; pascal: 3,448; lex: 1,720; ruby: 1,003; php: 436; lisp: 258; awk: 247; sql: 66; sed: 54; csh: 10; exp: 6
file content (45 lines) | stat: -rw-r--r-- 977 bytes parent folder | download | duplicates (16)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
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.