show directory(1m) show directory(1m)NAME
show directory - Displays attribute information about the specified
directory
SYNOPSIS
cdscp show directory directory-name [attribute-name] [with attribute-
name = attribute-value]
ARGUMENTS
The full name of a specific directory. The last simple name can con‐
tain wildcard characters. The name of a particular attribute; see
Description for valid attribute names. 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 sepa‐
rate 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: Indicates the date and time of
the last successful skulk on the directory. All replicas of the direc‐
tory are guaranteed to receive all updates whose timestamps are less
than the value of this attribute. Specifies the degree of consistency
among replicas. This attribute's value is defined as one of the follow‐
ing: CDS does not immediately propagate an update. The next skulk dis‐
tributes all updates that occurred since the previous skulk. Skulks
occur at least once every 24 hours. CDS attempts to immediately propa‐
gate an update to all replicas. If the attempt fails, the next sched‐
uled skulk makes the replicas consistent. Skulks occur at least once
every 12 hours. 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. Specifies the creation timestamp (CTS) of the CDS directory.
Specifies the minimum of all the values of the CDS_ReplicaVersion
attribute on the directory replicas. A UUID that identifies a particu‐
lar incarnation of the directory. Records the timestamp of the last
skulk performed on this directory. Records the timestamp of the most
recent change to any attribute of a directory replica, or any change to
an entry in the replica. Specifies the unique identifier of the direc‐
tory. Contains a pointer to this directory's parent in the namespace.
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. Specifies whether a directory replica can be accessed.
Indicates whether a directory replica is a master or read-only replica.
Specifies the version of a replica of the directory. 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. Con‐
trols the upgrading of a directory from one version of CDS to another.
By modifying this attribute, you can initiate the upgrading of a direc‐
tory to a new version of CDS. Specifies the timestamp of the most
recent update to an attribute of the directory. Specifies the RPC run‐
time software version that can be used to import on the directory.
Privilege Required
You must have read permission to the directory. If you specify a wild‐
card directory name, you also need read permission to the directory's
parent directory.
NOTE
This command is replaced at Revision 1.1 by the dcecp command and may
not be provided in future releases of DCE.
EXAMPLE
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(1m), create directory(1m), delete direc‐
tory(1m), list directory(1m), remove directory(1m), set directory(1m)
show directory(1m)