cdscache - A dcecp object that manages a cdscache
cdscache create server_name -binding server_binding
cdscache delete server_name
cdscache dump
cdscache help [operation | -verbose]
cdscache operations
cdscache show server_name {-server | -clearinghouse}
The cdscache object represents the 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 commands can display additional information.
Creates knowledge of a server in the local clerk's cache. The syntax is:
cdscache create server_name -binding server_binding
Options
The cdscache create operation creates knowledge of a server in the local clerk's cache. The server_name argument is a simple name for the cached server. A simple name is like pelican. It is not a cell-relative name like /.:/hosts/pelican. This command is typically used to manually provide configuration information to a clerk that cannot automatically configure itself. This is required, for instance, to give the clerk addressing information about a server. Once the clerk knows about one server, it can find other servers through referrals. The command returns an empty string on success.
Privilege Required
You must have w permission to the clerk system, /.../<cell>/hosts/<machine>/cds-clerk.
Examples
The following command creates knowledge of the server pelican in the local clerk's cache:
dcecp> cdscache create pelican -binding ncacn_ip_tcp:16.20.15.25 dcecp>
Removes knowledge of a server that you had specifically created from the local clerk's cache. The syntax is:
cdscache delete server_name
The cdscache delete operation removes knowledge of a server that you had specifically created from the local clerk's cache. The required server_name argument is a simple name given with the cdscache create command. You can only delete servers that you have specifically created with the cdscache create command.
Privilege Required
You must have w permission to the clerk system, /.../<cell>/hosts/<machine>/cds-clerk.
Examples
The following command removes knowledge of the server nrl from the clerk cache:
dcecp> cdscache delete nrl dcecp>
Displays the entire contents of the clerk cache. The syntax is:
cdscache dump
The cdscache dump operation displays the contents of the clerk cache on the screen.
Privilege Required
You must have superuser (root) privileges on the clerk system. No CDS permissions are required.
Examples
The following command displays the contents of the clerk cache on the screen:
dcecp> cdscache dump
Returns help information about the cdscache object and its operations. The syntax is:
cdscache help [operation | -verbose]
Option
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 (create, delete, dump, or show) about which you want detailed information.
Alternatively, you can use the -verbose option for more detailed information about the cdscache object itself.
Privilege 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 in local cds cache. dump Dump all information from local cds cache. show Returns information stored in cds cache. help Print summary of command-line options and abort. operations Returns the valid operations for command. dcecp>
Returns a list of the operations supported by the cdscache object. The syntax is:
cdscache operations
The cdscache operations command takes no arguments. The list of operations available to the cdscache object is ordered alphabetically except that help and operations are listed last.
Privilege Required
No special privileges are needed to use the object operations command.
Examples
dcecp> cdscache operations create delete dump show help operations dcecp>
Displays information about clearinghouses or servers stored in the cache. The syntax is:
cdscache show server_name {-server | -clearinghouse}
Options
The cdscache show operation displays information about clearinghouses or servers stored in the cache. The required server_name argument is a simple name of a server or CDS name of a clearinghouse for which you want to display information. You must use either the -clearinghouse or -server option to select the information you want to display.
Privilege Required
You must have r permission to the clerk system, /.../<cell>/hosts/<machine>/cds-clerk.
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>
Commands: directory(8dce), link(8dce), object(8dce), clearinghouse(8dce) clear_cached_server(8cds), define_cached_server(8cds), dump_clerk_cache(8cds), show_cached_clearinghouse(8cds), show_cached_server(8cds)