clh(4)                              CLIX                              clh(4)



  NAME

    clh - Intergraph network clearinghouse database

  DESCRIPTION

    The Intergraph clearinghouse is a network-wide distributed database.  Its
    main use is to bind names to network addresses so that users do not need
    to use addresses.  It can also be used to access any information that
    needs to be available to the network.

    The clearinghouse nodes directory has three subdirectories: local, owned,
    and heard.  These subdirectories store information about the nodes and
    individuals on the network.  The files in these subdirectories are called
    objects.  Each clearinghouse object is a text file stored in at least one
    of the subdirectories.  An object name can have up to 14 characters and
    contain only lowercase alphanumeric characters and underscores.  In each
    object's file is a list of one or more properties and property values with
    the following form:

    property:value

    Although an entry can contain any property name, the following ``well-
    known'' properties are used by programs that access the clearinghouse:

    address
           A network address stored as a hexadecimal character string.  (The
           maximum size is 26 characters.)

    nodename
           An object representing a node that the clearinghouse can use to
           look up a network address (maximum size is 14 characters).

    alias  Same as nodename.

    scope  A list of Local Area Networks (LANs) to which this object should be
           propagated.  (The object is always propagated to the local LAN.)

    namex  The namex command uses this property to indicate that it created or
           modified the object.

    tcp_address
           A TCP/IP Internet address stored as a decimal, hexadecimal, or
           octal character string.  (The maximum size is 19 characters.)

    netmap_info
           A formatted line containing information about the system and its
           components.  This line is added or updated automatically at system
           startup.

    owner  The hexadecimal network address of the node from which the object



  2/94 - Intergraph Corporation                                              1

  clh(4)                              CLIX                              clh(4)



           was broadcast.  This property is added automatically when the
           object is received from the network and therefore should only
           appear in objects in the heard subdirectory.

    The following entries are provided for network maintenance purposes:

    primary_user
           The name of the primary user of the local node.

    phone  The phone number of the primary_user.

    location
           The location of the local node.

  EXAMPLES

    address:        000b2345.08-00-36-76-09-00
    tcp_address:    122.9.100.6
    scope:  000b2343,b2344
    scope:  b2343
    NETMAP_info   : UNIX System V rel 3.1,
    Primary_user    : John Smith
    Location: Bismarck, North Dakota
    Phone   :701-555-1212
    Favorite color  : green


  FILES

    /usr/lib/nodes/local

    /usr/lib/nodes/heard

    /usr/lib/nodes/owned

  RELATED INFORMATION

    Commands:  clh(1), namex(8)

    CLIX Programming Guide.














  2                                              Intergraph Corporation - 2/94