pSOSystem System Calls - Read

pSOS+ System Calls rn_create
rn_create Creates a memory region.
#include
unsigned long rn_create(
char name[4], /* region name */
void *saddr, /* starting address */
unsigned long length, /* region's size in bytes */
unsigned long unit_size, /* region's unit of allocation */
unsigned long flags, /* region attributes */
unsigned long *rnid, /* region ID */
unsigned long *asiz /* allocatable size */
)
Description
Arguments
This service call enables a task to create a memory region, from which variable-sized
memory segments can be allocated for use by the application. The pSOS+ kernel
takes a portion from the beginning of this region to use as its Region Control Block
(RNCB.) All relevant region arguments such as unit size and whether tasks will wait
by FIFO or task priority order are established using this call.
name Specifies the user-assigned name of the new region.
saddr Specifies the starting address of the region's memory area. saddr
must be on a long word boundary.
length Specifies the region's size, in bytes.
unit_size Specifies the region's unit of allocation in bytes. unit_size must
be a power of 2 and greater than or equal to 16. All allocation will be
in multiples of unit_size.
pSOSystem System Calls 1-107
1