getSharedMemory(3)

NAME
getSharedMemory, getGlobalMemory, getLocalMemory, findSharedMemory, findGlobalMemory -- get pointers to shared and local memory sections of RCI tasks.

USAGE
#include <rci.h>

void *getSharedMemory (label)
   const char *label;

void *getGlobalMemory (label)
   const char *label;

void *getLocalMemory (label)
   const char *label;

void *findSharedMemory (p)
   void *p;

void *findGlobalMemory (p)
   void *p;

ARGUMENTS

label --
    Name of the shared memory section.

p --
    Planning level pointer.

DESCRIPTION
getSharedMemory() is used by a control task to obtain a pointer to the shared section label set up by the planning task using rciSharedMemory().

getGlobalMemory() is used by a control task to obtain a pointer to the global section label set up by the planning task using rciGlobalMemory().

getLocalMemory() is used by a control task to obtain a pointer to a private memory area label that was set up by the planning task using rciLocalMemory().

findSharedMemory() is like getSharedMemory(), only it used the planning task's pointer to the memory as a search key.

findGlobalMemory() is like getGlobalMemory(), only it used the planning task's pointer to the memory as a search key.

Control tasks which obtain these pointers once can store them for later use in the sharedMem, globalMem, and privateMem fields of the task control block (described in RCI_TCB(3)).

DIAGNOSTICS
The functions return NULL if the section does not exist or if the task making the request was not given access to the section when it was created.

SEE ALSO
rciSharedMemory(3), RCI_TCB(3).