Download pSOSystem System Calls

Transcript
psc.book Page 215 Monday, January 11, 1999 1:50 PM
pSOSystem System Calls
t_ident
pSOS+ System Calls
Obtains the task identifier of a named task.
#include <psos.h>
unsigned long t_ident(
char name[4],
unsigned long node,
unsigned long *tid
)
/* task name */
/* node number */
/* task ID */
2
Description
This system call enables the calling task to obtain the task ID of a task it knows only
by name. This task ID can then be used in all other operations relating to the task.
Most system calls, except t_create() and t_ident(), reference a task by its task
ID. t_create() returns the task ID to a task's creator. For other tasks, one way to
obtain the task ID is to use t_ident().
Arguments
name
Specifies the user-assigned name of the task.
node
In multiprocessor systems, is a search order specifier. See
Multiprocessor Considerations. In a single node system, this
argument must be 0.
tid
Points to the variable where t_ident() stores the task ID of
the named task.
Return Value
This system call returns 0 on success, or an error code on failure.
Error Codes
Refer to Appendix A.
t_ident
2-215