name(1m)																  name(1m)

NAME

       name - A dcecp object that compares and expands DCE names

SYNOPSIS

       name compare name name

       name expand name

       name get string_binding

       name help [operation | -verbose]

       name operations

       name parse name

ARGUMENTS

       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.  The name of the name operation for which to display help information.  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

       The name object resolves, compares, and parses DCE names and string bindings.

OPERATIONS

   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.

       Privileges Required

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

       Examples

       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  con-
       verting /.: to /.../cellname.

       Privileges Required

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

       Examples

       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

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

       Examples

       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 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

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

       Examples

       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.

       Privileges Required

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

       Examples

       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

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

       Examples

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

RELATED INFORMATION

       Commands: dcecp(1m).

																	  name(1m)