cdscache(1m)cdscache(1m)NAME
cdscache - A dcecp object that manages a local CDS cache
SYNOPSIS
cdscache create server_name -binding server_binding
cdscache delete server_name
cdscache discard [server_name]
cdscache dump
cdscache help [operation | -verbose]
cdscache operations
cdscache show server_name {-server | -clearinghouse}
ARGUMENTS
The name of the cdscache operation for which to display help informa‐
tion. The simple name of the cached server machine. A simple name is
not a cell-relative name (such as /.:/hosts/pelican). Some examples of
simple names are pelican and hosts/pelican.
DESCRIPTION
The cdscache object represents the Cell Directory Service (CDS) cache
on the local node. The CDS cache contains information about servers
and clearinghouses known to the local machine, and also contains user
data about CDS entries that have been read. The create and delete
operations apply only to the server information. The show and dump
operations can display additional information.
OPERATIONS
cdscache create
Creates knowledge of a server in the local client's cache. The syntax
is as follows: cdscache create server_name -binding server_binding
Options
The required -binding option lets you specify the binding information
for a CDS server. This option takes a server_binding argument, which
is the protocol sequence and network address of the server node. The
string format is as follows: protocol-sequence:network-address The Tcl
format is as follows: {protocol-sequence network-address}
A protocol-sequence is a character string identifying the network pro‐
tocols used to establish a relationship between a client and server.
Protocol sequences have a specific format that depends on the network
address that is supplied in the binding; for example ncacn_ip_tcp (for
connection-based protocol) or ncadg_ip_udp (for datagram protocol) The
network-address is a string representing the network address of the
server node.
The create operation creates knowledge of a server in the local
client's cache. The server_name argument is the simple name of a
cached server. (An example of a simple name would be pelican, as
opposed to a cell-relative name like /.:/hosts/pelican.) This command
is typically used to provide configuration information manually to a
client that cannot configure itself automatically. Providing configu‐
ration information manually may be necessary, for instance, to provide
the client with addressing information about a server across a WAN.
Once the client knows about one server, it can find other servers
through referrals. This operation returns an empty string on success.
Privileges Required
You must have w (write) permission to the client system,
/.:/hosts/hostname/cds-clerk.
Examples
The following command creates knowledge of the server pelican in the
local client's cache: dcecp> cdscache create pelican -binding
ncacn_ip_tcp:16.20.15.25 dcecp>
cdscache delete
Removes knowledge of a server that you had specifically created from
the local client's cache. The syntax is as follows: cdscache delete
server_name
The delete operation removes knowledge of a server that was specifi‐
cally created from the local client's cache. The required server_name
argument is the simple name of a cached server. (An example of a sim‐
ple name would be pelican, as opposed to a cell-relative name like
/.:/hosts/pelican.) You can delete only servers that you have specifi‐
cally created with the cdscache create command. This operation returns
an empty string on success.
Privileges Required
You must have w (write) permission to the client system,
/.:/hosts/hostname/cds-clerk.
Examples
The following command removes knowledge of the server gumby from the
client cache: dcecp> cdscache delete gumby dcecp>
cdscache discard
Discards the contents of the client cache. The syntax is as follows:
cdscache discard [server_name]
The discard operation discards information in the client cache on the
host specified by server_name. If you do not specify server_name, the
operation discards the information from the client cache on the local
host. Only a single server name can be specified. This operation
returns an empty string on success.
To perform the operation, cdscache discard does the following: Brings
down the client CDS. Deletes a specific set of files. Restarts the
client CDS.
During the process, all cached information is discarded.
Privileges Required
You must have superuser (root) privileges on the client system. No CDS
permissions are required.
Examples
The following command discards the contents of the client cache on the
local host: dcecp> cdscache discard dcecp>
cdscache dump
Displays the entire contents of the client cache. The syntax is as
follows: cdscache dump
The dump operation displays the contents of the client cache on the
screen.
Privileges Required
You must have superuser (root) privileges on the client system. No CDS
permissions are required.
Examples
The following command displays the contents of the client cache to the
screen: dcecp> cdscache dump Default timeout = 300 seconds CACHED
DIRECTORIES*****************************************************
/.../gumby1/cds_set_7_P_dir
Master at /.../gumby1/yuric_ch
Clearinghouse UID: d30d1770-6b05-11d0-b053-08000927749b
Clearinghouse Address:
ncadg_ip_udp:15.22.50.32[]
ncacn_ip_tcp:15.22.50.32[]
/.../gumby1/dirde1
Master at /.../gumby1/yuric_ch
Clearinghouse UID: d30d1770-6b05-11d0-b053-08000927749b
Clearinghouse Address:
ncadg_ip_udp:15.22.50.32[]
ncacn_ip_tcp:15.22.50.32[]
.
.
. dcecp>
cdscache help
Returns help information about the cdscache object and its operations.
The syntax is as follows: cdscache help [operation | -verbose]
Options
Displays information about the cdscache object.
Used without an argument or option, the cdscache help command returns
brief information about each cdscache operation. The optional operation
argument is the name of an operation about which you want detailed
information. Alternatively, you can use the -verbose option for more
detailed information about the cdscache object itself.
Privileges Required
No special privileges are needed to use the cdscache help command.
Examples dcecp> cdscache help create Adds information
about named server in local cds cache. delete Removes
information about named server from local cds cache. discard
Discards all cdsadv cache information on the specified host. dump
Dumps all information from local cds cache. show
Returns information stored in cds cache. help Prints a
summary of command-line options. operations Returns a list of
the valid operations for this command. dcecp>
cdscache operations
Returns a list of the operations supported by the cdscache object. The
syntax is as follows: cdscache 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 cdscache operations com‐
mand.
Examples
dcecp> cdscache operations create delete discard dump show help opera‐
tions dcecp>
cdscache show
Returns information about clearinghouses or servers stored in the
cache. The syntax is as follows: cdscache show server_name {-server |
-clearinghouse}
Options
This option displays all the names and values of the attributes in the
specified cached clearinghouse. The following are valid attributes:
Specifies the time at which this clearinghouse was added to the cache
Specifies the number of operations other than read and write (that is,
skulks, new epochs, and so on) performed by this client on the cached
clearinghouse Specifies the number of lookup operations of any sort
performed by the client on the cached clearinghouse Specifies the pro‐
tocol sequence and network address of the server that maintains the
cached clearinghouse Specifies the number of write operations performed
by this client on the cached clearinghouse This option displays address
information of a server in the local client's cache. The following
attributes are valid: The directory cell name The protocol sequence and
network address of the server node
The show operation displays information about clearinghouses or servers
stored in the cache. The required server_name argument is the simple
name of a server or a CDS names of a clearinghouse for which you want
to display information. You must use one of the -clearinghouse or
-server options to select the information you want to display.
Privileges Required
You must have r (read) permission to the CDS client.
Examples
The following command displays all attributes of the cached clearing‐
house /.:/claire_ch: dcecp> cdscache show /.:/claire_ch -clearinghouse
{CH_Name /.../blue.cell.osf.org/claire_ch} {Created
1994-10-07-11:41:23.131} {Others 458} {Reads 150221} {Tower
{ncacn_ip_tcp 130.105.4.158}} {Tower {ncadg_ip_udp 130.105.4.158}}
{Writes 162} dcecp>
The following command displays all attributes of the cached server
pokey: dcecp> cdscache show pokey -server {CH_Name /.../ter‐
rapin_cell.osf.org/pokey_ch} {Tower {ncacn_ip_tcp 130.105.5.16}} {Tower
{ncadg_ip_udp 130.105.5.16}} dcecp>
RELATED INFORMATION
Commands: dcecp(1m), dcecp_clearinghouse(1m), dcecp_directory(1m),
dcecp_link(1m), dcecp_object(1m).
cdscache(1m)