netserver(8)                        CLIX                        netserver(8)



  NAME

    netserver - Digital Network Protocol (DNP) universal server

  SYNOPSIS

    netserver

  DESCRIPTION

    The netserver handles Digital Network Protocol (DNP) connect requests for
    all of the DECnet objects declared in /usr/lib/servers.reg.  This is more
    efficient than having multiple servers running simultaneously.  When the
    netserver receives a connect, it invokes a server to process the connect
    and then waits for the next connect.  For each connection, netserver
    performs the following steps:

    1.  The netserver checks to see if a username and password, commonly
        referred to as Access Control Information (ACI), are specified in the
        connect request (see netcp(1)).

        If the ACI specified is invalid according to the /etc/passwd file, the
        link is rejected.

    2.  The netserver checks the /usr/lib/servers.reg file for an entry for
        the requested object.  When an object is requested, it will be
        referred to by number or by name, but not both.  The requested object
        may refer to any valid object by name, or request an object number in
        the range of 1-255.  The /usr/lib/servers.reg file contains a list of
        registered servers listed one per line.  The format of each line is as
        follows:

        obj-number obj-name path


        The obj-number is in the range of 0-255.  If obj-number is 0, the
        server referred to on that line can be referenced only by obj-name,
        since a client cannot request object number 0.  This allows several
        servers to have a 0 obj-number, which can be referenced only by their
        respective obj-names.  The path is the server to execute when a server
        is requested.

        The netserver checks for an object name or object number in
        /usr/lib/servers.reg.  The following is an example of a standard
        servers.reg file:

        0  MYTEST  /usr/tmp/mytest
        0  HISTEST /usr/tmp/histest
        17 FAL     /usr/bin/fal
        19 NML     /usr/bin/nml
        27 MAIL    /usr/bin/cumaild



  2/94 - Intergraph Corporation                                              1

  netserver(8)                        CLIX                        netserver(8)



        42 CTERM   /usr/bin/sethostd


        If no entry is found and the connection was by name, netserver
        searches the default directory of the user specified for a runnable
        file named object-name.

    3.  The netserver starts the process specified by the path found in
        /usr/lib/servers.reg or in the user's login directory with a single
        argument.  That argument is the file descriptor number of the logical
        link.  If the invocation fails, the link is rejected.

  FILES

           /usr/lib/servers.reg Registered server list.

  RELATED INFORMATION

    Commands:  netcp(1), cumaild(8), sethostd(8)

    Digital Network Protocol (DNP) Network Manager's Guide

    Digital Network Protocol (DNP) User's Guide































  2                                              Intergraph Corporation - 2/94