nns(n)nns(n)______________________________________________________________________________NAMEnns - Name service facility, Commandline Client Application
SYNOPSISnns 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 name‐
serv. All abilities of a client are covered, from configuration to reg‐
istration 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 reg‐
istration 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 connec‐
tion 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 match‐
ing 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, appro‐
priately 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 speci‐
fies 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 con‐
tain bugs and other problems. Please report such in the category name‐
serv of the Tcllib SF Trackers [http://source‐
forge.net/tracker/?group_id=12883]. Please also report any ideas for
enhancements you may have for either application and/or documentation.
SEE ALSOnameserv(n), nameserv::common(n)KEYWORDS
application, client, name service
CATEGORY
Networking
COPYRIGHT
Copyright (c) 2007-2008 Andreas Kupries <andreas_kupries@users.sourceforge.net>
Name service facility 1.1 nns(n)