cdsalias(1m)cdsalias(1m)NAME
cdsalias - A dcecp object that lets you manipulate cell names in CDS
SYNOPSIS
cdsalias catalog
cdsalias connect
cdsalias create cellalias_name
cdsalias delete cellalias_name
cdsalias help [operation | -verbose]
cdsalias operations
ARGUMENTS
A single, fully qualified alias name of the cell in the following form:
/.../cellalias_name The name of the cdsalias operation for which to
display help information.
DESCRIPTION
The cdsalias object represents cell names as known by the Cell Direc‐
tory Service (CDS). This object lets you manipulate alias and pre‐
ferred 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 hier‐
archical 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
cdsalias catalog
Returns a list of all defined cell aliases in CDS. The syntax is as
follows: 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
Requires r (read) permission on the root directory of the cell.
Examples
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
Requires a (auth_info) permission on the the local cell's root direc‐
tory. Also, the CDS server principal on the machine containing the
master replica of the local cell's root directory needs i (insert) per‐
mission on the parent cell's root directory.
Examples
dcecp> cdsalias connect dcecp>
cdsalias create
Creates a new alias cell name in CDS. The syntax is as follows:
cdsalias create cellalias_name
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
Requires a (auth_info) permission on the root directory of the cell.
Examples
dcecp> cdsalias create /.../green.cell.osf.org dcecp>
cdsalias delete
Deletes an existing alias cell name from CDS. The syntax is as fol‐
lows: 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
Requires a (auth_info) permission on the root directory of the cell.
Examples
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 Displays information about the cdsalias object.
Used without an argument or option, the cdsalias help command returns
brief information about each cdsalias operation. The optional opera‐
tion 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
No special privileges are needed to use the cdsalias help command.
Examples
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
No special privileges are needed to use the cdsalias operations com‐
mand.
Examples
dcecp> cdsalias operations catalog connect create delete help opera‐
tions dcecp>
RELATED INFORMATION
Commands: dcecp(1m), dcecp_account(1m), dcecp_cellalias(1m),
dcecp_directory(1m), dcecp_hostdata(1m).
cdsalias(1m)