Cogent C API and Utilities : Version 6.4
	Inter-Process Communication Functions

`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.

See Also

The Cascade NameServer, Cascade NameServer Functions, nserve, IP_NserveLookup, IP_NserveLookupName


IP_NserveLookup		IP_NserveLookupName

Copyright © 1995-2010 by Cogent Real-Time Systems, Inc. All rights reserved.