unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 show directory(1m)		     OSF		  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
      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
      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.




 Hewlett-Packard Company	    - 1 -	      OSF DCE 1.1/HP DCE 1.8






 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
		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.



 Hewlett-Packard Company	    - 2 -	      OSF DCE 1.1/HP DCE 1.8






 show directory(1m)	  Open Software Foundation	  show directory(1m)




      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.

 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:

      dscp>&gt&gt> 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



 Hewlett-Packard Company	    - 3 -	      OSF DCE 1.1/HP DCE 1.8






 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
      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