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> t_ident<br />

t_ident Obtains the task identifier of a named task.<br />

#include <br />

unsigned long t_ident(<br />

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

unsigned long node, /* node number */<br />

unsigned long *tid /* task ID */<br />

)<br />

Description<br />

Arguments<br />

Return Value<br />

Error Codes<br />

This system call enables the calling task to obtain the task ID of a task it knows only<br />

by name. This task ID can then be used in all other operations relating to the task.<br />

Most system calls, except t_create() and t_ident(), reference a task by its task<br />

ID. t_create() returns the task ID to a task's creator. For other tasks, one way to<br />

obtain the task ID is to use t_ident().<br />

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

node In multiprocessor systems, is a search order specifier. See<br />

“Multiprocessor Considerations.” In a single node system,<br />

this argument must be 0.<br />

tid Points to the variable where t_ident() stores the task ID of<br />

the named task.<br />

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

Hex Mnemonic Description<br />

0x04 ERR_NODENO Illegal node number.<br />

0x09 ERR_OBJNF Named task was not found.<br />

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

1

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

Saved successfully!

Ooh no, something went wrong!