pSOSystem System Calls - Read

pt_create pSOS+ System Calls
pt_create Creates a memory partition of fixed-size buffers.
#include
unsigned long pt_create(
char name[4], /* partition name */
void *paddr, /* partition physical addr. */
void *laddr, /* partition logical address */
unsigned long length, /* partition length in bytes */
unsigned long bsize, /* buffer size in bytes */
unsigned long flags, /* buffer attributes */
unsigned long *ptid, /* partition identifier */
unsigned long *nbuf /* number of buffers created */
)
Description
Arguments
This service call enables a task to create a new memory partition, from which fixedsized
memory buffers can be allocated for use by the application. The pSOS+ kernel
takes a portion from the top of this region to use as its Partition Control Block.
name Specifies the user-assigned name for the new partition.
paddr Specifies the physical memory address of the partition.
laddr Specifies the logical address of the partition generated after MMUtranslation;
laddr is ignored on non-MMU systems.
length Specifies the total partition length in bytes.
bsize Specifies the size of the buffers. bsize must be a power of 2, and
equal to or greater than 4.
flags Specifies the attributes of the buffer. flags is formed by OR-ing the
following symbolic constants (one from each pair), which are defined
in . For instance, to specify that a partition is globally
addressable, you place the symbolic constant PT_GLOBAL in flags.
To specify that the partition is globally addressable and that it
prohibits deletion with outstanding buffers, you place both
PT_GLOBAL and PT_NODEL in flags, using the following syntax:
PT_GLOBAL | PT_NODEL
1-48 pSOSystem System Calls