name(1m)                 Open Software Foundation                  name(1m)




 NAME    [Toc]    [Back]
      name - A dcecp object that compares and expands DCE names

 SYNOPSIS    [Toc]    [Back]
      name compare name name

      name expand name

      name get string_binding

      name help [operation | -verbose]

      name operations

      name parse name


 ARGUMENTS    [Toc]    [Back]
      name      The name of an object in the DCE namespace.  Examples of
                names include principal names, names of security groups,
                names of Cell Directory Service (CDS) objects like
                directories, softlinks, child pointers and so on, names of
                remote procedure call (RPC) entries and RPC groups, and
                Distributed File Service (DFS) filenames.

      operation The name of the name operation for which to display help
                information.

      string_binding
                An RPC string binding (without the object UUID) that
                identifies the network location of the target name.  It
                contains an RPC protocol and a network address in the form:

                rpc_prot_seq:network_addr


 DESCRIPTION    [Toc]    [Back]
      The name object resolves, compares, and parses DCE names and string
      bindings.

 OPERATIONS    [Toc]    [Back]
    name compare
      Compares two names.  The syntax is as follows:

      name compare name name


      The compare operation compares two names given as arguments and
      returns 1 if both syntactically refer to the same name.  Otherwise, it
      returns 0.




 Hewlett-Packard Company            - 1 OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96






 name(1m)                 Open Software Foundation                  name(1m)




      Privileges Required    [Toc]    [Back]

      No special privileges are needed to use the name compare command.

      Examples    [Toc]    [Back]

      dcecp> name compare /.:/sales/east east
      Error: Incomplete name
      dcecp>

      dcecp> name compare /.:/sales/east /.../org_cell/sales/east
      1
      dcecp>


    name expand
      Expands a simple DCE name to a global name.  The syntax is as follows:

      name expand name


      The expand operation takes a single name as an argument and returns
      the canonical form of the name.  This operation has the effect of
      converting /.: to /.../cellname.

      Privileges Required    [Toc]    [Back]

      No special privileges are needed to use the name expand command.

      Examples    [Toc]    [Back]

      dcecp> name expand /.:/sales
      /.../org_cell/sales
      dcecp>


    name get
      Returns a hostname given a full or partial string binding.  The syntax
      is as follows:

      name get string_binding


      The get operation returns the host name identified by a specified
      string binding. The string_binding argument is a single string
      binding; you cannot supply multiple bindings in one operation.

      Privileges Required    [Toc]    [Back]

      No special privileges are needed to use the name get command.




 Hewlett-Packard Company            - 2 OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96






 name(1m)                 Open Software Foundation                  name(1m)




      Examples    [Toc]    [Back]

      dcecp> name get ncan_ip_tcp:15.21.248.170
      hosts/goober
      dcecp>


    name help
      Returns help information about the name object and its operations.
      The syntax is as follows:

      name help [operation | -verbose]


      Options    [Toc]    [Back]


      -verbose  Displays information about the name object.


      Used without an argument or option, the name help operation returns
      brief information about each name operation. The optional operation
      argument is the name of the operation about which you want detailed
      information. Alternatively, you can use the -verbose option for more
      detailed information about the name object itself.

      Privileges Required    [Toc]    [Back]

      No special privileges are needed to use the name help command.

      Examples    [Toc]    [Back]

      dcecp> name help
      compare             Compares two names syntactically.
      expand              Returns the canonical form of a name.
      get                 Gets host name from a partial or full string binding.
      parse               Parses name into cell name and residual name.
      help                Prints a summary of command-line options.
      operations          Returns a list of the valid operations for this command.
      dcecp>


    name operations
      Returns a list of the operations supported by the name object. The
      syntax is as follows:

      name operations


      The list of available operations is in alphabetical order except for
      help and operations, which are listed last.



 Hewlett-Packard Company            - 3 OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96






 name(1m)                 Open Software Foundation                  name(1m)




      Privileges Required    [Toc]    [Back]

      No special privileges are needed to use the name operations command.

      Examples    [Toc]    [Back]

      dcecp> name operations
      compare expand get parse help operations
      dcecp>


    name parse
      Divides a name into a cell name and a residual name.  The syntax is as
      follows:

      name parse name


      The parse operation parses a name into a cell name and a residual
      name.  The argument is a single DCE name.  The operation returns a
      list of two elements: cell name and residual name.  A name not
      beginning with a / (slash) is considered to be a name in the local
      cell.

      Privileges Required    [Toc]    [Back]

      No special privileges are needed to use the name parse command.

      Examples    [Toc]    [Back]

      dcecp> name parse hosts/goober
      /.../pokey hosts/goober
      dcecp>


 RELATED INFORMATION    [Toc]    [Back]
      Commands: dcecp(1m).


 Hewlett-Packard Company            - 4 -OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96