IP_NserveLookup

Cogent API and Utilities: Version 4.1
Prev |  | Next

# `IP_NserveLookup`

`IP_NserveLookup` -- fills in a known task structure.

## Syntax

``int IP_NserveLookup`(char* name, IP_Task* task);`

## Arguments

`name`

  A task name.

`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 corresponding to `name`. 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_NserveLookupID`, `IP_NserveLookupName`

Prev | Home | Next
`IP_NserveInitMyself` | Up | `IP_NserveLookupId`

Copyright 1995-2002 by Cogent Real-Time Systems, Inc.