unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

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



 cds(1m)		  Open Software Foundation		     cds(1m)




 NAME
      cds - A dcecp object that represents a Cell Directory Service server

 SYNOPSIS
      cds disable server_name

      cds help [operation | -verbose]

      cds operations

      cds show server_name


 ARGUMENTS
      operation The name of the cds operation for which to display help
		information.

      server_name
		The name of one CDS server running somewhere in the local
		cell. Specify the server name in one of the following
		formats:

		/.../cell_name/hosts/host_name/cds-server

		/.:/hosts/host_name/cds-server


 DESCRIPTION
      The cds object allows some low-level control over a CDS server in the
      local cell.  Using it, you can disable a running server, which causes
      it to shut down gracefully.  This command will also display a limited
      set of the attribute and counter information currently known to the
      specified server.

 ATTRIBUTES
      Child_Update_Failures
		The number of times the server failed to update a child
		replica.

      Creation_Time
		The date-time stamp representing when the current server
		started.

      Crucial_Replicas
		The number of crucial replicas known to the server.

      Future_Skew_Time
		The skew time allowed the server.

      Known_Clearinghouses
		The list of clearinghouses known to the server.



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






 cds(1m)		  Open Software Foundation		     cds(1m)




      Read_Operations
		The number of read operations processed by the server since
		it started.

      Security_Failures
		The number of times the CDS server had problems with the
		cell Security Service.

      Skulks_Completed
		The number of skulks completed by the server since it
		started.

      Skulks_Initiated
		The number of skulks initiated by the server since it
		started.

      Times_Lookup_Paths_Broken
		The number of times the lookup path was	 broken during a
		server operation.

      Write_Operations
		The number of write operations processed by the server since
		it started.


 OPERATIONS
    cds disable
      Disables the specified CDS server.  The syntax is as follows:

      cds disable server_name


      The specified server must be running somewhere in the local cell, and
      you must have the privileges to access that machine.   This operation
      returns an empty string on success.

      Privileges Required

      You must have dwc (delete, write, create) permissions on the namespace
      entry of the server.

      Example

      dcecp> cds disable /.:/hosts/blech/cds-server
      dcecp>


    cds help
      Returns help information about the cds object and its operations.	 The
      syntax is as follows:




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






 cds(1m)		  Open Software Foundation		     cds(1m)




      cds help [operation | -verbose]


      Options


      -verbose	Displays information about the cds object.


      Used without an argument or option, the cds help command returns brief
      information about each cds operation.  The optional operation argument
      is the name of an operation about which you want detailed information.
      Alternatively, you can use the -verbose option to display detailed
      information about the cds object itself.

      Privileges Required

      No special privileges are needed to use the cds help command.

      Examples

      dcecp> cds help
      disable		  Disables the specified CDS server.
      show		  Returns attribute information about the named CDS server.
      help		  Prints a summary of command-line options.
      operations	  Returns a list of the valid operations for this command.
      dcecp>


    cds operations
      Returns a list of the operations supported by the cds object. The
      syntax is as follows:

      cds operations


      The list of available operations is in alphabetical order except for
      help and operations, which are listed last.

      Privileges Required

      No special privileges are needed to use the cds operations command.

      Examples

      dcecp> cds operations
      disable show help operations
      dcecp>

    cds show




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






 cds(1m)		  Open Software Foundation		     cds(1m)




      Returns attribute information about the specified CDS server. The
      syntax is as follows:

      cds show server_name


      The attributes returned mostly represent counter information, which
      can be used to help isolate a problems with a CDS server. The order in
      which the attributes are returned is fixed within CDS.

      Privileges Required

      You must have r (read) permissions on the namespace entry of the
      server.

      Examples

      dcecp> cds show /.:/hosts/blech/cds-server
      {Creation_Time 1995-10-11-10:06:31.434-04:00I-----}
      {Future_Skew_Time 0}
      {Read_Operations 141384}
      {Write_Operations 3589}
      {Skulks_Initiated 278}
      {Skulks_Completed 278}
      {Times_Lookup_Paths_Broken 0}
      {Crucial_Replicas 0}
      {Child_Update_Failures 0}
      {Security_Failures 0}
      {Known_Clearinghouses /.../gumby1/blech_ch}
      dcecp>


 RELATED INFORMATION
      Commands: cdsd(1m), dcecp(1m), dcecp_cdsclient(1m).




















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