NAME
show directory - 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.
NOTE
This command is replaced at Revision 1.1 by the dcecp command and
may not be provided in future releases of DCE.
RELATED INFORMATION
Commands: add directory
create directory
delete directory
list directory
remove directory
set directory
1 – 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.
Privilege Required
You must have read permission to the directory. If you specify
a wildcard directory name, you also need read permission to the
directory's parent directory.
2 – 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