NAME

cdscache - A dcecp object that manages a local CDS cache

SYNOPSIS

cdscache create server_name_list -binding server_binding cdscache delete server_name_list cdscache discard server_name cdscache dump cdscache help [operation | -verbose] cdscache operations cdscache show server_name_list {-server | -clearinghouse}

ARGUMENTS

operationThe name of the cdscache operation for which you want to see help information. 

server_nameA single simple name for the cached server machine.  A simple name is not a cell-relative name (such as /.:/hosts/pelican/self).  Some examples of simple names are pelican and hosts/pelican. 

server_name_list
A list of one or more simple names for the cached server machine.

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_list -binding server_binding Options

-binding server_binding
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 protocols used to establish a relationship between a client and server.  There are two choices of protocol sequence, depending on the network address that is supplied in the binding: ncacn_ip_tcp or ncadg_ip_udp.  For the network-address, specify an Internet address using the common Internet address notation. 

The create operation creates knowledge of a server in the local client’s cache.  The server_name_list argument is a list of one or more simple names for the cached servers.  (An example of a simple name would be pelican, as opposed to a  cell-relative name like /.:/hosts/pelican/self.)  This command is typically used to manually provide configuration information to a client that cannot automatically configure itself.  Manually providing configuration information can be required, 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.  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_list The delete operation removes knowledge of a server that you had specifically created from the local clients’s cache. The required server_name_list argument is a list of one or more simple names given with the cdscache create commmand. You can delete only servers that you have specifically 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. 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 cached 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:

     1.Brings down the client CDS. 

     2.Deletes a specific set of files. 

     3.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.  Use this command when solving CDS problems. Privileges Required You must have superuser (root) privileges on the client system.  No CDS permissions are required. Examples The following command will display the contents of the client cache on the screen (the output is not shown in the example):

dcecp> cdscache dump
dcecp>

cdscache help

Returns help information about the cdscache object and its operations.  The syntax is as follows: cdscache help [operation | -verbose] Options

-verboseDisplays 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 command. Examples

dcecp> cdscache operations
create delete discard dump show help operations
dcecp>

cdscache show

Returns information about clearinghouses or servers stored in the cache.  The syntax is as follows: cdscache show server_name_list {-server | -clearinghouse} Options

-clearinghouse
This option displays all the names and values of the attributes in the specified cached clearinghouse.  The following are valid attributes:

Creation Time
Specifies the time at which this clearinghouse was added to the cache

Miscellaneous Operations
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

Read Operations
Specifies the number of lookup operations of any sort performed by the client on the cached clearinghouse

TowersSpecifies the protocol sequence and Internet address of the server that maintains the cached clearinghouse

Write Operations
Specifies the number of write operations performed by this client on the cached clearinghouse

-serverThis option displays address information of a server in the local client’s cache.  The following attributes are valid:

NameThe directory cell name

TowersThe 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_list argument is a list of one or more simple names of servers or CDS names of clearinghouses 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 clearinghouse /.:/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 drkstr. 

dcecp> cdscache show drkstr -server
{CH_Name /.../terrapin_cell.osf.org/drkstr_ch}
{Tower {ncacn_ip_tcp 130.105.5.16}}
{Tower {ncadg_ip_udp 130.105.5.16}}
dcecp>

RELATED INFORMATION

Commands:

dcecp(1m), dcecp_directory(1m), dcecp_link(1m), dcecp_object(1m), dcecp_clearinghouse(1m). 

Hewlett-Packard Company  —  OSF DCE 1.1/HP DCE 1.5