cds(1m)cds(1m)NAMEcds - A dcecp object that represents a Cell Directory Service server
SYNOPSIScds disable server_name
cds help [operation | -verbose]
cds operations
cds show server_name
ARGUMENTS
The name of the cds operation for which to display help information.
The name of one CDS server running somewhere in the local cell. Spec‐
ify 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
The number of times the server failed to update a child replica. The
date-time stamp representing when the current server started. The num‐
ber of crucial replicas known to the server. The skew time allowed the
server. The list of clearinghouses known to the server. The number of
read operations processed by the server since it started. The number
of times the CDS server had problems with the cell Security Service.
The number of skulks completed by the server since it started. The
number of skulks initiated by the server since it started. The number
of times the lookup path was broken during a server operation. The
number of write operations processed by the server since it started.
OPERATIONScds disable
Disables the specified CDS server. The syntax is as follows: cds dis‐
able 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: cds help [operation | -verbose]
Options 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 syn‐
tax 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
Returns attribute information about the specified CDS server. The syn‐
tax 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_Opera‐
tions 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_Clearing‐
houses /.../gumby1/blech_ch} dcecp>
RELATED INFORMATION
Commands: cdsd(1m), dcecp(1m), dcecp_cdsclient(1m).
cds(1m)