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 package it describes,  will  undoubtedly  contain  bugs  and  other
       problems.    Please   report  such  in  the  category  nameserv  of  the  Tcllib  Trackers
       [http://core.tcl.tk/tcllib/reportlist].  Please also report any ideas for enhancements you
       may have for either package 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>