unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 cdsalias(1m)		  Open Software Foundation		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
      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
      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
    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






 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

      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




 Hewlett-Packard Company	    - 2 -	      OSF DCE 1.1/HP DCE 1.8






 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

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


      -verbose	Displays information about the cdsalias object.






 Hewlett-Packard Company	    - 3 -	      OSF DCE 1.1/HP DCE 1.8






 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

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







 Hewlett-Packard Company	    - 4 -	      OSF DCE 1.1/HP DCE 1.8