cds(1m) Open Software Foundation cds(1m)
NAME [Toc] [Back]
cds - A dcecp object that represents a Cell Directory Service server
SYNOPSIS [Toc] [Back]
cds disable server_name
cds help [operation | -verbose]
cds operations
cds show server_name
ARGUMENTS [Toc] [Back]
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 [Toc] [Back]
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 [Toc] [Back]
Child_Update_Failures
The number of times the server failed to update a child
replica.
Creation_Time [Toc] [Back]
The date-time stamp representing when the current server
started.
Crucial_Replicas [Toc] [Back]
The number of crucial replicas known to the server.
Future_Skew_Time [Toc] [Back]
The skew time allowed the server.
Known_Clearinghouses [Toc] [Back]
The list of clearinghouses known to the server.
Hewlett-Packard Company - 1 OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96
cds(1m) Open Software Foundation cds(1m)
Read_Operations [Toc] [Back]
The number of read operations processed by the server since
it started.
Security_Failures [Toc] [Back]
The number of times the CDS server had problems with the
cell Security Service.
Skulks_Completed [Toc] [Back]
The number of skulks completed by the server since it
started.
Skulks_Initiated [Toc] [Back]
The number of skulks initiated by the server since it
started.
Times_Lookup_Paths_Broken [Toc] [Back]
The number of times the lookup path was broken during a
server operation.
Write_Operations [Toc] [Back]
The number of write operations processed by the server since
it started.
OPERATIONS [Toc] [Back]
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 [Toc] [Back]
You must have dwc (delete, write, create) permissions on the namespace
entry of the server.
Example [Toc] [Back]
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 PHSS_26394-96
cds(1m) Open Software Foundation cds(1m)
cds help [operation | -verbose]
Options [Toc] [Back]
-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 [Toc] [Back]
No special privileges are needed to use the cds help command.
Examples [Toc] [Back]
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 [Toc] [Back]
No special privileges are needed to use the cds operations command.
Examples [Toc] [Back]
dcecp> cds operations
disable show help operations
dcecp>
cds show
Hewlett-Packard Company - 3 OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96
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 [Toc] [Back]
You must have r (read) permissions on the namespace entry of the
server.
Examples [Toc] [Back]
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 [Toc] [Back]
Commands: cdsd(1m), dcecp(1m), dcecp_cdsclient(1m).
Hewlett-Packard Company - 4 -OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96 [ Back ] |
