1nns(n)                       Name service facility                      nns(n)
2
3
4
5______________________________________________________________________________
6

NAME

8       nns - Name service facility, Commandline Client Application
9

SYNOPSIS

11       nns bind ?-host host? ?-port port? name data
12
13       nns search ?-host host? ?-port port? ?-continuous? ?pattern?
14
15       nns ident ?-host host? ?-port port?
16
17       nns who
18
19______________________________________________________________________________
20

DESCRIPTION

22       Please read Name service facility, introduction first.
23
24       The  application  described  by this document, nns, is a simple command
25       line client for the nano name service facility provided by  the  Tcllib
26       packages nameserv, and nameserv::server.  Beyond that the application's
27       sources also serve as an example of how to use the client package name‐
28       serv. All abilities of a client are covered, from configuration to reg‐
29       istration of names to searching.
30
31       This name service facility has nothing to do with the Internet's Domain
32       Name  System,  otherwise  known  as DNS. If the reader is looking for a
33       package dealing with that please see either of the packages dns and re‐
34       solv, both found in Tcllib too.
35
36   USE CASES
37       nns was written with the following two main use cases in mind.
38
39       [1]    Registration of a name/data pair in the name service.
40
41       [2]    Searching the name service for entries matching a glob pattern.
42
43       Beyond  the  above  we also want to be able to identify the client, and
44       get information about the name service.
45
46   COMMAND LINE
47       nns bind ?-host host? ?-port port? name data
48              This form registers the name/data pair  in  the  specified  name
49              service. In this form the command will not exit to keep the reg‐
50              istration alive. The user has to kill it explicitly,  either  by
51              sending  a  signal, or through the job-control facilities of the
52              shell in use. It will especially survive the loss of the connec‐
53              tion to the name service and reestablish the name/data pair when
54              the connection is restored.
55
56              The options to specify the name service will be explained later,
57              in section OPTIONS.
58
59       nns search ?-host host? ?-port port? ?-continuous? ?pattern?
60              This form searches the specified name service for entries match‐
61              ing the glob-pattern and prints them to stdout, with each  entry
62              on  its  own  line. If no pattern is specified it defaults to *,
63              matching everything.
64
65              The options to specify the name service will be explained later,
66              in section OPTIONS.
67
68              If  the option -continuous is specified the client will not exit
69              after performing the search, but start to  continuously  monitor
70              the  service  for changes to the set of matching entries, appro‐
71              priately updating the display as changes arrive. In that form it
72              will  especially  also survive the loss of the connection to the
73              name service and reestablish the search when the  connection  is
74              restored.
75
76       nns ident ?-host host? ?-port port?
77              This  form  asks  the specified name service for the version and
78              features of the name service protocol it supports and prints the
79              results to stdout.
80
81              The options to specify the name service will be explained later,
82              in section OPTIONS.
83
84       nns who
85              This form prints name, version, and protocol version of the  ap‐
86              plication to stdout.
87
88   OPTIONS
89       This section describes all the options available to the user of the ap‐
90       plication
91
92       -host name|ipaddress
93              If this option is not specified it  defaults  to  localhost.  It
94              specifies the name or ip-address of the host the name service to
95              talk to is running on.
96
97       -port number
98              If this option is not specified it defaults to 38573. It  speci‐
99              fies  the  TCP  port the name service to talk to is listening on
100              for requests.
101

BUGS, IDEAS, FEEDBACK

103       This document, and the package it describes, will  undoubtedly  contain
104       bugs  and  other problems.  Please report such in the category nameserv
105       of the Tcllib Trackers [http://core.tcl.tk/tcllib/reportlist].   Please
106       also  report any ideas for enhancements you may have for either package
107       and/or documentation.
108
109       When proposing code changes, please provide unified diffs, i.e the out‐
110       put of diff -u.
111
112       Note  further  that  attachments  are  strongly  preferred over inlined
113       patches. Attachments can be made by going  to  the  Edit  form  of  the
114       ticket  immediately  after  its  creation, and then using the left-most
115       button in the secondary navigation bar.
116

SEE ALSO

118       nameserv(n), nameserv::common(n)
119

KEYWORDS

121       application, client, name service
122

CATEGORY

124       Networking
125

127       Copyright (c) 2007-2008 Andreas Kupries <andreas_kupries@users.sourceforge.net>
128
129
130
131
132tcllib                                1.1                               nns(n)
Impressum