summaryrefslogtreecommitdiffstats
path: root/docs/nspr/reference/pr_attachsharedmemory.rst
blob: ed7c38d4a37b3732d7e7f59cfaa9ccd1fe72064f (plain)
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
PR_AttachSharedMemory
=====================

Attaches a memory segment previously opened with :ref:`PR_OpenSharedMemory`
and maps it into the process memory space.


Syntax
------

.. code::

   #include <prshm.h>

.. code::

   NSPR_API( void * )
     PR_AttachSharedMemory(
        PRSharedMemory *shm,
        PRIntn flags
   );

   /* Define values for PR_AttachSharedMemory(...,flags) */
   #define PR_SHM_READONLY 0x01


Parameters
~~~~~~~~~~

The function has these parameters:

shm
   The handle returned from :ref:`PR_OpenSharedMemory`.
flags
   Options for mapping the shared memory. ``PR_SHM_READONLY`` causes the
   memory to be attached read-only.


Returns
~~~~~~~

Address where shared memory is mapped, or ``NULL`` if an error occurs.
Retrieve the reason for the failure by calling :ref:`PR_GetError` and
:ref:`PR_GetOSError`.