Cogent API and Utilities: Version 4.1
Prev |  | Next

# nsnames

nsnames -- queries the Cascade NameServer.

## Synopsis

nsnames [`-DhNQsSUVX`] [`-d `domain``] [`-e `node``] [`-p `pid``] [`-q `queue``] [`-t `task``]

## Arguments

`-d `domain``

  Report only on domains matching this shell expression.

`-D`

  Sort by domain.

`-e `node``

  Report only on this node.

`-h`

  Print this helpful message and exit.

`-N`

  Sort by node.

`-p `pid``

  Report only on this process ID.

`-q `queue``

  Report only on queues matching this shell expression.

`-Q`

  Sort by queue name.

`-s`

  Supress headers.

`-S`

  Sort by name (default).

`-t `task``

  Report only on tasks matching this shell expression.

`-U`

  Unsorted output.

`-V`

  Print the version number.

`-X`

  Exit immediately (normally used with `-V`).

## Returns

The specified information, listed to the console.

## Description

This module retrieves name information from nserve, according to optional criteria. A `pid` or `node` of `0` matches any process ID or node ID. The `domain`, `qname`, and `task` match on substrings, so "`/cogent/ll`" and "`/cogent/hl`" would both be matched by: `-t cogent`.

## Dependencies

nserve

## See Also

Running the Cascade DataHub, nserve

Prev | Home | Next
lsend, gsend | Up | nserve

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