directory show

directory show directory_name_list [-schema]

[-member child_pointer_list | [-replica] -clearinghouse clearinghouse_name]

Options

-member child_pointer_list
The optional -member option takes one required value, which is the last RDN of child pointer in the directory specified by the operation argument. The returned list describes the child pointer information for the specified member stored in the specified directories. This option cannot be combined with the -replica or -clearinghouse option.

-replica
Specifies that the directory shown is a replica of an existing directory. If you use the -replica option, you must specify a clearinghouse using the -clearinghouse option.

-clearinghouse clearinghouse_name
Required with the -replica option, the -clearinghouse option names the clearinghouse where the named replica exists.

-schema
Returns whether an attribute is single or multivalued. This is specific to a directory, meaning that the same attribute can be single-valued on one directory and multivalued on another directory. This option cannot be used with other options.

Description
The directory show operation returns a list of attributes for the specified directories and optionally, their specified contents. The directory_name_list argument is a list of one or more names of directories to be operated on. When used without any options, this command returns the attributes associated with the named directories. If more than one directory is specified, then all the arguments are grouped together in one list. The order of the returned arguments is the lexical order of the OIDs of each attribute for each directory.

You can request attributes of specific replicas in specific clearinghouses using the -replica and -clearinghouse options. Alternatively, you can request attributes of child pointers by using the -member option.

Privileges Required
You must have r (read) permission to the directories named in the argument list.

Examples
The following example shows the attributes for the /.:/depts/radiology directory:

dcecp> directory show /.:/depts/radiology
{RPC_ClassVersion
{01 00}}
{CDS_CTS 1994-07-08-17:01:03.115+00:00I0.000/00-00-c0-8a-df-56}
{CDS_UTS 1994-07-08-19:36:31.719+00:00I0.000/00-00-c0-8a-df-56}
{CDS_ObjectUUID 2df03af4-9a76-11cd-8f2b-0000c08adf56}
{CDS_Replicas
{{Clearinghouse_Uuid b32648c6-928d-11cd-b4b5-0000c08adf56}
{Clearinghouse_Name /.../ward_cell.osf.org/pmin17_ch}
{Replica_Type Master}
{Tower ncacn_ip_tcp:130.105.1.227[]}
{Tower ncadg_ip_udp:130.105.1.227[]}}}
{CDS_AllUpTo 1994-07-08-17:01:05.945+00:00I0.000/00-00-c0-8a-df-56}
{CDS_Convergence medium}
{CDS_ParentPointer
{{Parent_UUID 8eeb369a-9a4b-11cd-8f2b-0000c08adf56}
{Timeout
{expiration 1994-07-09-17:13:31.959}
{extension +1-00:00:00.000I0.000}}
{myname /.../ward_cell.osf.org/depts/radiology}}}
{CDS_DirectoryVersion 3.0}
{CDS_ReplicaState on}
{CDS_ReplicaType Master}
{CDS_LastSkulk 1994-07-08-17:01:05.945+00:00I0.000/00-00-c0-8a-df-56}
{CDS_LastUpdate 1994-07-08-19:36:31.719+00:00I0.000/00-00-c0-8a-df-56}
{CDS_RingPointer b32648c6-928d-11cd-b4b5-0000c08adf56}
{CDS_Epoch 2f617aa6-9a76-11cd-8f2b-0000c08adf56}
{CDS_ReplicaVersion 3.0}
dcecp>

The following example uses the schema option to show whether the attributes for the /.:/depts/radiology directory are single-valued or multivalued:

dcecp> directory show /.:/depts/radiology -schema
{RPC_ClassVersion multi}
{CDS_CTS single}
{CDS_UTS single}
{CDS_ObjectUUID single}
{CDS_Replicas multi}
{CDS_AllUpTo single}
{CDS_Convergence single}
{CDS_ParentPointer multi}
{CDS_DirectoryVersion single}
{CDS_ReplicaState single}
{CDS_ReplicaType single}
{CDS_LastSkulk single}
{CDS_LastUpdate single}
{CDS_RingPointer single}
{CDS_Epoch single}
{CDS_ReplicaVersion single}
dcecp>