| ## show directory(8cds) Displays attribute information about the specified directory Synopsis cdscp show directory directory-name [attribute-name] [with attribute-name = attribute-value] Arguments directory-name The full name of a specific directory. The last simple name can contain wildcard characters. attribute-name The name of a particular attribute; see Description for valid attribute names. attribute-value The value of a particular attribute. Description The show directory command displays the names and values of the attributes specified in attribute-name. You can use a combination of attributes in any sequence in a single command. Use a space to separate multiple attributes. You can use a with attribute-name = attribute-value clause to limit output only to directories whose attributes have values equal to the specified values. A space must precede and follow the = (equals sign). If you do not supply any attributes, the command displays all attributes and their values. In addition to the following directory attributes, application-specific attributes can exist for a directory: CDS_AllUpTo Indicates the date and time of the last successful skulk on the directory. All replicas of the directory are guaranteed to receive all updates whose timestamps are less than the value of this attribute. CDS_Convergence Specifies the degree of consistency among replicas. This attribute's value is defined as one of the following: low CDS does not immediately propagate an update. The next skulk distributes all updates that occurred since the previous skulk. Skulks occur at least once every 24 hours. medium CDS attempts to immediately propagate an update to all replicas. If the attempt fails, the next scheduled skulk makes the replicas consistent. Skulks occur at least once every 12 hours. high CDS attempts to immediately propagate an update to all replicas. If the attempt fails (for example, if one of the replicas is unavailable), a skulk is scheduled for within one hour. Skulks usually occur at least once every 12 hours. Use this setting temporarily and briefly, because it uses extensive system resources. By default, every directory inherits the convergence setting of its parent at creation time. The default setting on the root directory is medium. CDS_CTS Specifies the creation timestamp (CTS) of the CDS directory. CDS_DirectoryVersion Specifies the minimum of all the values of the CDS_ReplicaVersion attribute on the directory replicas. CDS_Epoch A UUID that identifies a particular incarnation of the directory. CDS_LastSkulk Records the timestamp of the last skulk performed on this directory. CDS_LastUpdate Records the timestamp of the most recent change to any attribute of a directory replica, or any change to an entry in the replica. CDS_ObjectUUID Specifies the unique identifier of the directory. CDS_ParentPointer Contains a pointer to this directory's parent in the namespace. CDS_Replicas Specifies the address, UUID, and name of every clearinghouse where a copy of this directory is located. This attribute also specifies whether the replica in a particular clearinghouse is a master or read-only replica. CDS_ReplicaState Specifies whether a directory replica can be accessed. CDS_ReplicaType Indicates whether a directory replica is a master or read-only replica. CDS_ReplicaVersion Specifies the version of a replica of the directory. CDS_RingPointer Specifies the UUID of a clearinghouse containing another replica of this directory. This attribute is written by the system and is read-only to users. It will appear on older directories, but not on DCE 1.1 directories. CDS_UpgradeTo Controls the upgrading of a directory from one version of CDS to another. By modifying this attribute, you can initiate the upgrading of a directory to a new version of CDS. CDS_UTS Specifies the timestamp of the most recent update to an attribute of the directory. RPC_ClassVersion Specifies the RPC runtime software version that can be used to import on the directory. Privileges Required You must have r (read) permission to the directory. If you specify a wildcard directory name, you also need r (read) permission to the directory's parent directory. Notes This command is replaced at Revision 1.1 by the dcecp command and may not be provided in future releases of DCE. Examples The following command displays the current values of all the attributes associated with the /.:/admin directory: cdscp> show directory /.:/ admin SHOW DIRECTORY /.../abc.com/admin AT 1991-10-15-15:43:59 RPC_ClassVersion = 0100 CDS_CTS = 1991-10-15-13:09:47.000000003/08-00-2b-1c-8f-1f CDS_UTS = 1991-10-17-08:59:50.000000006/08-00-2b-1c-8f-1f CDS_ObjectUUID = ba700c98-8b1a-11ca-8981-08002b0f79aa CDS_Replicas = : Clearinghouse's UUID = 2ab024a8-8b1a-11ca-8981-08002b0f79aa Tower = ncadg_ip_udp:16.20.16.32 Tower = ncacn_ip_tcp:16.20.16.32 Replica type = master Clearinghouse's Name = /.../abc.com/Paris_CH CDS_AllUpTo = 1991-10-17-08:51:18.000000032/08-00-2b-1c-8f-1f CDS_Convergence = medium CDS_ParentPointer = : Parent's UUID = b773525c-8b1a-11ca-8981-08002b0f79aa Timeout = : Expiration = 1991-10-16-19:43:50.516 Extension = +1-00:00:00.000 CDS_DirectoryVersion = 3.0 CDS_ReplicaState = on CDS_ReplicaType = master CDS_LastSkulk = 1991-10-17-08:51:18.000000032/08-00-2b-1c-8f-1f CDS_LastUpdate = 1991-10-21-13:04:02.000000044/08-00-2b-1c-8f-1f CDS_RingPointer = 2ab024a8-8b1a-11ca-8981-08002b0f79aa CDS_Epoch = bd8b2c50-8b1a-11ca-8981-08002b0f79aa CDS_ReplicaVersion = 3.0 Related Information Commands: add directory(8cds) create directory(8cds) delete directory(8cds) list directory(8cds) remove directory(8cds) set directory(8cds) ##