06.08.2013 Views

pSOSystem System Calls - Read

pSOSystem System Calls - Read

pSOSystem System Calls - Read

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

pSOS+ <strong>System</strong> <strong>Calls</strong> pt_create<br />

Return Value<br />

Error Codes<br />

Notes<br />

PT_GLOBAL /<br />

PT_LOCAL<br />

PT_DEL /<br />

PT_NODEL<br />

Partition is globally addressable by other nodes /<br />

partition can be addressed only the by local node.<br />

The single-processor version of the pSOS+ kernel<br />

ignores PT_GLOBAL.<br />

This call returns 0 on success or an error code on failure.<br />

Deletion of the partition with pt_delete() is<br />

enabled, even if one or more buffers are allocated.<br />

Deletion of the partition is prohibited unless all<br />

buffers have been freed.<br />

ptid Points to the variable where pt_create() stores the partition ID of<br />

the named partition.<br />

nbuf Points to the variable where pt_create() stores the number of<br />

actual buffers in the partition.<br />

Hex Mnemonic Description<br />

0x08 ERR_OBJTFULL Node's object table full.<br />

0x28 ERR_PTADDR Starting address not on long word<br />

boundary.<br />

0x29 ERR_BUFSIZE Buffer size not power of 2, or less<br />

than 4 bytes.<br />

0x2A ERR_TINYPT Length too small to hold the partition<br />

control information.<br />

1. Internally, the pSOS+ kernel treats a partition name as a 32-bit integer.<br />

However, when the application calls the kernel through the pSOS+ C language<br />

API, it passes the partition name as a four-byte character array.<br />

2. The pSOS+ kernel does not check for duplicate partition names. If duplicate<br />

names exist, a pt_ident() call can return the ptid of any partition with the<br />

duplicate name.<br />

<strong>pSO<strong>System</strong></strong> <strong>System</strong> <strong>Calls</strong> 1-49<br />

1

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!