06.08.2013 Views

pSOSystem System Calls - Read

pSOSystem System Calls - Read

pSOSystem System Calls - Read

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

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

rn_ident Obtains the region identifier of a named region.<br />

#include <br />

unsigned long rn_ident(<br />

char name[4], /* region name */<br />

unsigned long *rnid /* region identifier */<br />

)<br />

Description<br />

Arguments<br />

Return Value<br />

Error Codes<br />

This system call enables the calling task to obtain the region ID of a memory region<br />

for which the caller has only the region name. This region ID can then be used in all<br />

other operations relating to the memory region.<br />

Most system calls, except rn_create() and rn_ident(), reference a region by its<br />

region ID. rn_create() returns the region ID to a region's creator. For other tasks,<br />

one way to obtain the region ID is to use rn_ident().<br />

name Specifies the user-assigned name of the region.<br />

rnid Points to the variable where rn_ident() stores the region<br />

ID of the named region.<br />

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

Hex Mnemonic Description<br />

0x09 ERR_OBJNF Named region not found.<br />

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

1

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

Saved successfully!

Ooh no, something went wrong!