NAME

show child - Displays attribute information about the specified child pointer

SYNOPSIS

cdscp show child child-name [attribute-name] [with attribute-name = attribute-value]

ARGUMENTS

child-name
The full name of a specific child pointer. The last simple name can contain wildcard characters.

attribute-name
The name of an attribute; see DESCRIPTION for valid attribute names.

attribute-value
The value of a particular attribute.

DESCRIPTION

The show child command displays the names and values of the attributes specified in attribute-name. You can use a combination of attributes 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 child pointers 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. The following is a description of child pointer attributes:

CDS_CTS
Specifies the creation timestamp (CTS) of the specified child pointer.

CDS_ObjectUUID
Specifies the unique identifier of the directory to which the child pointer refers.

CDS_Replicas
Specifies the address, UUID, and name of a set of clearinghouses where a copy of the child directory referenced by the child pointer is located. This attribute also specifies whether the directory in a particular clearinghouse is a master or read-only replica.

CDS_UTS
Specifies the timestamp of the most recent update to an attribute of the child pointer.

Privilege Required

You must have read permission to the child pointer. If you specify a wildcard child name, you also need read permission to the 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 all of the attributes and values of the child directory to which the child pointer /.:/admin refers:

cdscp> show child /.:/admin

                        SHOW
                       CHILD   /.../abc.com/admin
                          AT   1991-10-15-15:56:01
                     CDS_CTS = 1991-10-15-19:55:52.000000003/08-00-2b-1c-8f-1f
                     CDS_UTS = 1991-10-15-19:55:52.000000006/08-00-2b-1c-8f-1f
              CDS_ObjectUUID = 6b5362e8-8b1c-11ca-8981-08002b0f79aa
                CDS_Replicas = :
        Clearinghouse's UUID = 2ab024a8-8b1a-11ca-8981-08002b0f79aa
                       Tower = ncadg_ip_udp:16.18.16.32
                       Tower = ncacn_ip_tcp:16.18.16.32
                Replica type = master
        Clearinghouse's Name = /.../abc.com/Boston_CH

RELATED INFORMATION

Commands: create child(8cds), delete child(8cds), list child(8cds)


© 1990-1996, Transarc Corporation