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 Directory 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 compo-
nent. 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
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 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
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 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 opera-
tion 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 hierarchi-
cal 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 command.
Examples
dcecp> cdsalias operations catalog connect create delete help operations dcecp>
RELATED INFORMATION
Commands: dcecp(1m), dcecp_account(1m), dcecp_cellalias(1m), dcecp_directory(1m), dcecp_hostdata(1m).
cdsalias(1m)
