IP_NserveLookupId
IP_NserveLookupId — finds a task by node, process and channel ID.
Syntax
#include <cogent.h>
int IP_NserveLookupId( | int | nid, |
| | int | pid, |
| | int | chid, |
| | IP_Task* | task); |
Arguments
- nid
- A node ID.
- pid
- A process ID.
- chid
- A channel ID.
- task
- An empty task structure to hold the result.
Returns
0 on success, or -1 on failure
and errno is set.
Description
This function queries
nserve for the first task whose
nid, pid and
chid exactly match the provided values. The task
structure is filled in with all information from
nserve. Strings are allocated as necessary, and
will be deallocated when the task pointer is submitted to IP_TaskDestroy.
