nns(3tcl)																 nns(3tcl)

__________________________________________________________________________________________________________________________________________________

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  registra-
	      tion  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  connec-
	      tion 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 espe-
	      cially 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>

Name service facility							1.1								 nns(3tcl)