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.

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

Error Codes<br />

Notes<br />

See Also<br />

Hex Mnemonic Description<br />

0x04 ERR_NODENO Node specifier out of range.<br />

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

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

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

passes the queue name as a four-byte character array.<br />

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

names exist, a q_ident() call can return the qid of any queue with the<br />

duplicate name.<br />

Multiprocessor Considerations<br />

1. q_ident() converts a queue's name to its qid using a search order determined<br />

by the node input parameter, as described in <strong>pSO<strong>System</strong></strong> <strong>System</strong> Concepts.<br />

Because queues created and exported by different nodes may not have unique<br />

names, the result of this binding may depend on the order in which the object<br />

tables are searched.<br />

2. If the master node's Global Object Table must be searched, the local kernel<br />

makes a q_ident() RSC to the master node.<br />

Callable From<br />

■ Task<br />

q_create, q_vident<br />

1-80 <strong>pSO<strong>System</strong></strong> <strong>System</strong> <strong>Calls</strong>

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

Saved successfully!

Ooh no, something went wrong!