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

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

operationThe 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

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

Errors

A representative list of errors that might be returned is not shown here.  Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages. 

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 converting /.: 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 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

verboseDisplays 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(8dce)