---
name: "nns"
section: "3tcl"
platform: "linux"
package: "tcllib"
version: "1.14-dfsg-3+deb7u1"
release: "Debian 7 (Wheezy)"
platforms: ["linux"]
url: "https://new.carta.tech/nns/3tcl"
---

# nns(3tcl)

Name service facility, Commandline Client Application

```

```

## NAME

nns - Name service facility, Commandline Client Application

## SYNOPSIS

**nns** **bind** ?**-host** *host*? ?**-port** *port*? *name* *data*

**nns** **search** ?**-host** *host*? ?**-port** *port*? ?**-continuous**? ?*pattern*?

**nns** **ident** ?**-host** *host*? ?**-port** *port*?

**nns** **who**

```

```

## DESCRIPTION

Please read *Name service facility, introduction* first.

The application described by this document, **nns**, is a simple command line client for the nano name service facility provided by the Tcllib packages **nameserv**, and **nameserv::server**. Beyond that the application's sources also serve as an example of how to use the client package **nameserv**. All abilities of a client are covered, from configuration to registration of names to searching.

This name service facility has nothing to do with the Internet's *Domain Name System*, otherwise known as *DNS*. If the reader is looking for a package dealing with that please see either of the packages **dns** and **resolv**, both found in Tcllib too.

### USE CASES

**nns** was written with the following two main use cases in mind.

- \[1\]

  Registration of a name/data pair in the name service.

- \[2\]

  Searching the name service for entries matching a glob pattern.

Beyond the above we also want to be able to identify the client, and get information about the name service.

### COMMAND LINE

- **nns** **bind** ?**-host** *host*? ?**-port** *port*? *name* *data*

  This form registers the *name*/*data* pair in the specified name service. In this form the command will *not* exit to keep the registration alive. The user has to kill it explicitly, either by sending a signal, or through the job-control facilities of the shell in use. It will especially survive the loss of the connection to the name service and reestablish the *name*/*data* pair when the connection is restored.

  The options to specify the name service will be explained later, in section **OPTIONS**.

- **nns** **search** ?**-host** *host*? ?**-port** *port*? ?**-continuous**? ?*pattern*?

  This form searches the specified name service for entries matching the glob-*pattern* and prints them to stdout, with each entry on its own line. If no pattern is specified it defaults to **\***, matching everything.

  The options to specify the name service will be explained later, in section **OPTIONS**.

  If the option **-continuous** is specified the client will not exit after performing the search, but start to continuously monitor the service for changes to the set of matching entries, appropriately updating the display as changes arrive. In that form it will especially also survive the loss of the connection to the name service and reestablish the search when the connection is restored.

- **nns** **ident** ?**-host** *host*? ?**-port** *port*?

  This form asks the specified name service for the version and features of the name service protocol it supports and prints the results to stdout.

  The options to specify the name service will be explained later, in section **OPTIONS**.

- **nns** **who**

  This form prints name, version, and protocol version of the application to stdout.

### OPTIONS

This section describes all the options available to the user of the application

- **-host** name\|ipaddress

  If this option is not specified it defaults to **localhost**. It specifies the name or ip-address of the host the name service to talk to is running on.

- **-port** number

  If this option is not specified it defaults to **38573**. It specifies the TCP port the name service to talk to is listening on for requests.

## BUGS, IDEAS, FEEDBACK

This document, and the application it describes, will undoubtedly contain bugs and other problems. Please report such in the category *nameserv* of the *Tcllib SF Trackers* \[http://sourceforge.net/tracker/?group\_id=12883\]. Please also report any ideas for enhancements you may have for either application and/or documentation.

## SEE ALSO

nameserv(3tcl), nameserv::common(3tcl)

## KEYWORDS

application, client, name service

## CATEGORY

Networking

## COPYRIGHT

```
Copyright (c) 2007-2008 Andreas Kupries <andreas_kupries@users.sourceforge.net>
```