show directory(1m) OSF show directory(1m)
NAME [Toc] [Back]
show directory - Displays attribute information about the specified
directory
SYNOPSIS [Toc] [Back]
cdscp show directory directory-name [attribute-name] [with attribute-
name = attribute-value]
ARGUMENTS [Toc] [Back]
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 [Toc] [Back]
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 [Toc] [Back]
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 [Toc] [Back]
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.
Hewlett-Packard Company - 1 OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96
show directory(1m) Open Software Foundation show directory(1m)
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 [Toc] [Back]
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 [Toc] [Back]
Records the timestamp of the last skulk performed on this
directory.
CDS_LastUpdate [Toc] [Back]
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 [Toc] [Back]
Specifies the unique identifier of the directory.
CDS_ParentPointer [Toc] [Back]
Contains a pointer to this directory's parent in the
namespace.
CDS_Replicas [Toc] [Back]
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 [Toc] [Back]
Specifies whether a directory replica can be accessed.
Hewlett-Packard Company - 2 OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96
show directory(1m) Open Software Foundation show directory(1m)
CDS_ReplicaType [Toc] [Back]
Indicates whether a directory replica is a master or readonly
replica.
CDS_ReplicaVersion [Toc] [Back]
Specifies the version of a replica of the directory.
CDS_RingPointer [Toc] [Back]
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 [Toc] [Back]
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 [Toc] [Back]
Specifies the RPC runtime software version that can be used
to import on the directory.
Privilege Required [Toc] [Back]
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.
NOTE [Toc] [Back]
This command is replaced at Revision 1.1 by the dcecp command and may
not be provided in future releases of DCE.
EXAMPLE [Toc] [Back]
The following command displays the current values of all the
attributes associated with the /.:/admin directory:
dscp> show directory /.:/admin
SHOW [Toc] [Back]
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
Hewlett-Packard Company - 3 OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96
show directory(1m) Open Software Foundation show directory(1m)
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 [Toc] [Back]
Commands: add directory(1m), create directory(1m), delete
directory(1m), list directory(1m), remove directory(1m), set
directory(1m)
Hewlett-Packard Company - 4 -OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96 [ Back ] |
