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 Ser‐
vice (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 opera‐
tion 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 convert‐
ing /.: 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 bind‐
ing; 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)