cdsalias(1m) Open Software Foundation cdsalias(1m)
NAME [Toc] [Back]
cdsalias - A dcecp object that lets you manipulate cell names in CDS
SYNOPSIS [Toc] [Back]
cdsalias catalog
cdsalias connect
cdsalias create cellalias_name
cdsalias delete cellalias_name
cdsalias help [operation | -verbose]
cdsalias operations
ARGUMENTS [Toc] [Back]
cellalias_name
A single, fully qualified alias name of the cell in the
following form:
/.../cellalias_name
operation The name of the cdsalias operation for which to display
help information.
DESCRIPTION [Toc] [Back]
The cdsalias object represents cell names as known by the Cell
Directory Service (CDS). This object lets you manipulate alias and
preferred names of DCE cells. Each cell has one preferred name. Cells
may also have alias names. This object affects only the CDS
component. The security server and each host must also be informed of
any new cell aliases.
This object can also be used to define a hierarchical relation between
one cell and another by connecting the first cell's root directory
namespace into the the second cell's namespace. When defining a
hierarchical relationship, you must use the account command to
establish a trust relationship between the cells.
To manipulate alias and preferred names, the CDS_DirectoryVersion
attribute must be set to 4.0 or greater. See the ATTRIBUTES section of
the directory command for more information.
OPERATIONS [Toc] [Back]
cdsalias catalog
Returns a list of all defined cell aliases in CDS. The syntax is as
follows:
Hewlett-Packard Company - 1 OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96
cdsalias(1m) Open Software Foundation cdsalias(1m)
cdsalias catalog
The catalog operation returns a list of all defined cell aliases in
CDS. Each alias name is labeled either alias or primary, depending on
which name is the current preferred name.
Privileges Required [Toc] [Back]
Requires r (read) permission on the root directory of the cell.
Examples [Toc] [Back]
dcecp> cdsalias catalog
{CDS_CellAliases
{Alias /.../green.cell.osf.org}
{Primary /.../blue.cell.osf.org}}
dcecp>
cdsalias connect
Establishes a hierarchical relationship between two cells. The syntax
is as follows:
cdsalias connect
The connect operation creates a hierarchical relationship between two
cells. It takes no argument. The current preferred name of the cell
is used and the last relative distinguished name (RDN) is removed to
identify the parent cell. This operation returns an empty string on
success.
Privileges Required [Toc] [Back]
Requires a (auth_info) permission on the the local cell's root
directory. Also, the CDS server principal on the machine containing
the master replica of the local cell's root directory needs i (insert)
permission on the parent cell's root directory.
Examples [Toc] [Back]
dcecp> cdsalias connect
dcecp>
cdsalias create
Creates a new alias cell name in CDS. The syntax is as follows:
cdsalias create cellalias_name
Hewlett-Packard Company - 2 OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96
cdsalias(1m) Open Software Foundation cdsalias(1m)
The create operation creates a new alias cell name in CDS. The
required argument is a single fully qualified alias name of the cell.
This operation returns an empty string on success.
Privileges Required [Toc] [Back]
Requires a (auth_info) permission on the root directory of the cell.
Examples [Toc] [Back]
dcecp> cdsalias create /.../green.cell.osf.org
dcecp>
cdsalias delete
Deletes an existing alias cell name from CDS. The syntax is as
follows:
cdsalias delete cellalias_name
The delete operation deletes an existing alias cell name from CDS. The
required argument is a single fully qualified alias name of the cell.
If the alias name does not exist, an error is returned. You cannot
use this command to delete the preferred cell name. This operation
returns an empty string on success.
Privileges Required [Toc] [Back]
Requires a (auth_info) permission on the root directory of the cell.
Examples [Toc] [Back]
dcecp> cdsalias delete /.../green.cell.osf.org
dcecp>
cdsalias help
Returns help information about the cdsalias object and its operations.
The syntax is as follows:
cdsalias help [operation | -verbose]
Options [Toc] [Back]
-verbose Displays information about the cdsalias object.
Hewlett-Packard Company - 3 OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96
cdsalias(1m) Open Software Foundation cdsalias(1m)
Used without an argument or option, the cdsalias help command returns
brief information about each cdsalias operation. The optional
operation argument is the name of an operation about which you want
detailed information. Alternatively, you can use the -verbose option
for more detailed information about the cdsalias object itself.
Privileges Required [Toc] [Back]
No special privileges are needed to use the cdsalias help command.
Examples [Toc] [Back]
dcecp> cdsalias help
catalog Returns the aliases known by CDS for the named cell.
connect Establishes a hierarchical relationship between two cells.
create Creates the named cdsalias for the local cell.
delete Deletes the existing cdsalias from the local cell.
help Prints a summary of command-line options.
operations Returns a list of the valid operations for this command.
dcecp>
cdsalias operations
Returns a list of the operations supported by the cdsalias object. The
syntax is as follows:
cdsalias operations
The list of available operations is in alphabetical order except for
help and operations, which are listed last.
Privileges Required [Toc] [Back]
No special privileges are needed to use the cdsalias operations
command.
Examples [Toc] [Back]
dcecp> cdsalias operations
catalog connect create delete help operations
dcecp>
RELATED INFORMATION [Toc] [Back]
Commands: dcecp(1m), dcecp_account(1m), dcecp_cellalias(1m),
dcecp_directory(1m), dcecp_hostdata(1m).
Hewlett-Packard Company - 4 -OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96 [ Back ] |
