cdsclient(1m)cdsclient(1m)NAME
cdsclient - A dcecp object that represents a Cell Directory Service
client
SYNOPSIS
cdsclient disable client_name
cdsclient help [operation | -verbose]
cdsclient operations
cdsclient show client_name
DESCRIPTION
The cdsclient object allows some low-level control over a CDS client in
the local cell. Use it to disable a running client by shutting it down
gracefully and to display a limited set of the attribute and counter
information that is currently known to the client.
ARGUMENTS
The name of one CDS client running somewhere in the local cell. Spec‐
ify the client name using one of the formats:
/.../cell_name/hosts/host_name/cds-clerk
/.:/hosts/host_name/cds-clerk The name of the cdsclient operation for
which to display help information.
ATTRIBUTES
The number of authentication failures encountered by the client since
it started. The number of times the client bypassed the cache when
looking for information. The number of times the client used the cache
when looking for information. The date-time stamp representing when
the current client started. The number of non-read, non-write opera‐
tions processed by the client since it started. The number of protocol
errors encountered by the client since it started. The number of read
operations processed by the client since it started. The number of
write operations processed by the client since it started.
OPERATIONS
cdsclient disable
Disables the specified CDS client. The syntax is as follows: cdsclient
disable client_name
The specified client 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 d (delete), w (write), and c (create) permissions on the
namespace entry of the clerk.
Example
dcecp> cdsclient disable /.:/hosts/blech/cds-clerk dcecp>
cdsclient help
Returns help information about the cdsclient object and its operations.
The syntax is as follows: cdsclient help [operation | -verbose]
Options Displays information about the cdsclient object.
Used without an argument or option, cdsclient help returns brief infor‐
mation about each cdsclient 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 cdsclient object itself.
Privileges Required
No special privileges are needed to use the cdsclient help command.
Examples
dcecp> cdsclient help disable Disables the specified CDS
client. show Returns attribute information about the
named CDS client. help Prints a summary of command-line
options. operations Returns a list of the valid operations
for this command. dcecp>
cdsclient operations
Returns a list of the operations supported by the cdsclient object.
The syntax is as follows: cdsclient 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 cdsclient operations com‐
mand.
Examples
dcecp> cdsclient operations disable show help operations dcecp>
cdsclient show
Returns attribute information about the specified CDS client. The syn‐
tax is as follows: cdsclient show client_name
The attributes returned mostly represent counter information, which can
be used to help isolate a problems with a CDS client. The order the
attributes are returned is fixed within CDS.
Privileges Required
You must have r (read) permissions on the namespace entry.
Example
dcecp> cdsclient show /.:/hosts/blech/cds-clerk {Creation_Time
1995-10-11-15:09:45.187-04:00I-----} {Protocol_Errors 0} {Authentica‐
tion_Failures 0} {Read_Operations 78935} {Cache_Hits 55007}
{Cache_Bypasses 23726} {Write_Operations 50} {Miscellaneous_Operations
53} dcecp>
RELATED INFORMATION
Commands:
cdsadv(1m),
dcecp(1m),
dcecp_cds(1m).
cdsclient(1m)