GNU.WIKI: The GNU/Linux Knowledge Base

  [HOME] [PHP Manual] [HowTo] [ABS] [MAN1] [MAN2] [MAN3] [MAN4] [MAN5] [MAN6] [MAN7] [MAN8] [MAN9]

  [0-9] [Aa] [Bb] [Cc] [Dd] [Ee] [Ff] [Gg] [Hh] [Ii] [Jj] [Kk] [Ll] [Mm] [Nn] [Oo] [Pp] [Qq] [Rr] [Ss] [Tt] [Uu] [Vv] [Ww] [Xx] [Yy] [Zz]


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>



  All copyrights belong to their respective owners. Other content (c) 2014-2018, GNU.WIKI. Please report site errors to webmaster@gnu.wiki.
Page load time: 0.122 seconds. Last modified: November 04 2018 12:49:43.