"Fossies" - the Fresh Open Source Software Archive

Member "SAOImageDS9/tcllib/apps/nnsd.man" (13 Nov 2019, 2529 Bytes) of package /linux/misc/ds9.8.1.tar.gz:


As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file.

    1 [comment {-*- tcl -*- doctools manpage}]
    2 [manpage_begin nnsd n 1.0.1]
    3 [see_also nameserv::common(n)]
    4 [see_also nameserv::server(n)]
    5 [keywords application]
    6 [keywords {name service}]
    7 [keywords server]
    8 [copyright {2007-2008 Andreas Kupries <andreas_kupries@users.sourceforge.net>}]
    9 [moddesc   {Name service facility}]
   10 [titledesc {Name service facility, Commandline Server Application}]
   11 [category  Networking]
   12 [description]
   13 [para]
   14 
   15 Please read [term {Name service facility, introduction}] first.
   16 
   17 [para]
   18 
   19 The application described by this document, [syscmd nns], is a simple
   20 command line server for the nano name service facility provided by the
   21 Tcllib packages [package nameserv], and [package nameserv::server].
   22 
   23 Beyond that the application's sources also serve as an example of how
   24 to use the server package [package nameserv::server].
   25 
   26 [para]
   27 
   28 This name service facility has nothing to do with the Internet's
   29 [term {Domain Name System}], otherwise known as [term DNS]. If the
   30 reader is looking for a package dealing with that please see either of
   31 the packages [package dns] and [package resolv], both found in Tcllib
   32 too.
   33 
   34 [subsection {USE CASES}]
   35 
   36 [syscmd nnsd] was written with the following main use case in
   37 mind.
   38 
   39 [para]
   40 [list_begin enumerated]
   41 [enum]
   42 Run a nano name service on some host.
   43 
   44 [list_end]
   45 
   46 [para]
   47 
   48 [subsection {COMMAND LINE}]
   49 
   50 [list_begin definitions]
   51 
   52 [call [cmd nnsd] \
   53 	[opt "[option -localonly] [arg flag]"] \
   54 	[opt "[option -port] [arg port]"]]
   55 
   56 The command configures a server per the specified options and starts
   57 it. The command will not exit on its own, as it keeps the name service
   58 database wholly in memory. The user has to kill it explicitly, either
   59 by sending a a signal, or through the job-control facilities of the
   60 shell in use.
   61 
   62 [para]
   63 The options to configure the name service are explained in section
   64 [sectref OPTIONS].
   65 
   66 [list_end]
   67 
   68 [subsection OPTIONS]
   69 
   70 This section describes all the options available to the user of the
   71 application
   72 
   73 [para]
   74 [list_begin options]
   75 [opt_def -localonly bool]
   76 
   77 If this option is not specified it defaults to [const true], i.e.
   78 acceptance of only local connections. The server will accept remote
   79 connections, i.e. connections from other hosts, if and only if this
   80 option is configured to [const false].
   81 
   82 [opt_def -port number]
   83 
   84 If this option is not specified it defaults to [const 38573]. It
   85 specifies the TCP port the server has to listen on for requests.
   86 
   87 [list_end]
   88 
   89 [vset CATEGORY nameserv]
   90 [include ../modules/doctools2base/include/feedback.inc]
   91 [manpage_end]