UUIDNAME.TXT(4)                 Domain/OS SysV                 UUIDNAME.TXT(4)





NAME
     uuidname.txt - file associating names with UUIDs

SYNOPSIS
     Public file:
     /sys/ncs/uuidname.txt (SR9 Apollo workstations)
     /etc/ncs/uuidname.txt (SR10 Apollo workstations and other UNIX systems)
     ncs$exe:uuidname.txt (VMS systems)
     \ncs\uuidname.txt (MS-DOS systems)

     Private file:
     ~/uuidname.txt (Apollo workstations and other UNIX systems)

DESCRIPTION
     A uuidname.txt file associates textual names with UUIDs (Universal Unique
     Identifiers).  The lb_admin administrative tool can use these names to
     identify objects, types, and interfaces; it accepts names as input and
     displays names as output whenever possible.

     System-wide associations of names with UUIDs are defined in a public
     uuidname.txt file on the host where lb_admin is invoked.  On Apollo
     workstations and other UNIX systems, user-specific associations can also
     be defined in a private uuidname.txt file in the home directory of the
     user who invokes lb_admin.  The lb_admin tool reads these files (first
     the public file, then the private file, if it exists) when it starts up,
     and it uses the names defined in the files for the duration of the
     session.

     Each UUID in a uuidname.txt file appears at the beginning of a line.
     Names associated with that UUID occupy the remainder of the line,
     separated by spaces or tabs.  Names that contain spaces or tabs must be
     delimited by double quotation marks.  Blank lines and lines beginning
     with # are ignored.  A #include construct supports inclusion of other
     files in this format.

     More than one name can be associated with a UUID if several names appear
     on one line of a uuidname.txt file, if a UUID appears on several lines of
     one file, or if a UUID appears in several files.  The first name
     encountered by lb_admin when it starts up is treated as the "primary
     name" for the UUID, and all subsequent names are treated as "aliases."
     Any primary names or aliases can be entered as input to lb_admin, but the
     tool always uses primary names for output.

     If an undefined name is entered as input, lb_admin treats the input as a
     wildcard.

     Note that this mechanism for associating names with UUIDs may be
     superseded by a more general naming service in a future software release.

EXAMPLE
     The following is part of a sample uuidname.txt file:

     333b91c50000.0d.00.00.87.84.00.00.00    glb/object
     333b91de0000.0d.00.00.87.84.00.00.00    glb/type
     333b2e690000.0d.00.00.87.84.00.00.00    glb/interface
     34b45208a000.0d.00.00.87.84.00.00.00    rgy/object


SEE ALSO

     lb_admin(1M)
     Managing NCS Software