define cached server(1m) define cached server(1m)NAME
define cached server - Creates knowledge of a server in the local clerk's cache
SYNOPSIS
cdscp define cached server name tower value
ARGUMENTS
A simple name for the cached server. The protocol sequence and network address of the server node. The format is protocol-sequence:net-
work-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. For more
information about this format, see the RPC introduction in the DCE Application Development Reference.
DESCRIPTION
The define cached server command creates knowledge of a server in the local clerk's cache. This command is typically used to manually pro-
vide configuration information to a clerk that cannot automatically configure itself. This is required, for instance, to give the clerk
addressing information about a server across a WAN. Once the clerk knows about one server, it can find other servers through referrals.
Privilege Required
You must have write permission to the clerk.
NOTE
This command is replaced at Revision 1.1 by the dcecp command and may not be provided in future releases of DCE.
EXAMPLES
The following command creates knowledge of the server nrl in the local clerk's cache: cdscp> define cached server nrl tower
ncacn_ip_tcp:16.20.15.25
RELATED INFORMATION
Commands: clear cached server(1m), dump clerk cache(1m), show cached server(1m)
Books: OSF DCE Application Development Reference
define cached server(1m)
Check Out this Related Man Page
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 information. 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 protocols 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 typi-
cally used to provide configuration information manually to a client that cannot configure itself automatically. Providing configuration
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 specifically created from the local client's cache. The required 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.) 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, /.:/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 opera-
tion 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 opera-
tion 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 {-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 protocol 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 sim-
ple 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 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 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)