10.4;rpccp (Remote Procedure Call Control Program), NCK version 2.0, 91/10/3
rpccp - Remote Procedure Call Control Program
usage: /etc/ncs/rpccp [ -version ]
DESCRIPTION
The NCS 2.0 version of the RPC control program (rpccp) provides a set of
commands for displaying the contents of the endpoint map database and for
removing entries from this database. In the full DCE offering, the rpccp
utility includes commands for interacting with the CDS name service
database. However, because the name service is not part of DCE RPC, the
NCS 2.0 version of rpccp does not support these commands. (Note that the
rpccp help command displays the list of commands in the DCE version of
rpccp. However, NCS 2.0 only implements the commands that are listed in
the SYNOPSIS section above.)
You can issue rpccp commands from within the rpccp utility or from the
shell system prompt. To use commands from inside the utility, you must
first invoke rpccp. To do this, issue the rpccp command without any
argument. When the prompt appears, you can enter any rpccp command. For
example,
% rpccp
rpccp> show mapping
If you enter invalid input, the control program displays the valid
commands. To leave the control program and return to the system prompt,
use the exit command.
To use rpccp commands from the shell system prompt, enter rpccp, followed
by an rpccp command as the first argument. For example,
% rpccp show mapping
Except for the exit and quit commands, rpccp commands have one or more
options. Each option is identified by a hyphen (-) followed by a letter.
Some options require arguments.
Some UNIX systems require that at the system prompt, you place an escape
symbol (\) before string binding delimiters such as brackets ([]) or that
you place delimiters within single or double quotation marks. ('' or "").
The rpccp utility supports environment variables, which facilitate
interactive use of the utility. (Note that UNIX environment variables
are case sensitive.)
You can create user-defined environment variables to represent values to
rpccp. Using an environment variable can be helpful for specifying a
long string such as:
+ A string representation of binding information
+ A string representation of an object or interface UUID
+ An interface identifier, which contains the interface UUID and version
numbers
For example, in the following C Shell example, the environment variable
JANE_CAL represents an interface identifier.
% setenv JANE_CAL 47F40D10-E2E0-11C9-BB29-08002B0F4528,1.1
% rpccp
rpccp> show mapping -i JANE_CAL
In addition, rpccp supports the DCE RPC environment variable NLSPATH.
This variable must point to the location of dcerpc.cat and dcedcs.cat.
Otherwise, any run-time status codes returned by the control program will
be in hexadecimal, rather than textual, form.
COMMANDS
exit Leaves the RPC control program.
help [ rpccp-command ]
Displays a list of commands or the options of a specified command.
If you enter the help command alone, the list of rpccp commands is
displayed. (Note that NCS 2.0 only supports a subset of these
commands.) If you also enter an rpccp command, the options and
arguments for that command are displayed.
remove mapping -b string-binding -i if-id [-o object-uuid ] [host-addr]
Removes map elements from the endpoint map at host-addr. If entered
without a host address as an argument, the command operates on the
local endpoint map. The remove mapping command requires at least
one string binding (the -b option); one interface identifier (the -i
option); and, optionally, one or more object UUIDs (the -o option).
The options work together to delimit the element(s) to be removed
from the target endpoint map. The command removes any map element
that contains the specified interface identifier, string binding,
and object UUID (if any).
The -b option declares a string binding. You can specify up to 32
-b options with a single remove mapping command. Specify the string
binding without any object UUID in the form prot-seq:host[endpoint];
for example,
ncadg_ip_udp:63.0.2.17[5347]
The -i option declares an interface identifier associated with the
string binding. Only one interface can be specified in a single
operation. The interface identifier has the following form:
interface-uuid,major-version.minor-version
In an interface identifier, the UUID is a hexadecimal string and the
version numbers a decimal string; for example:
-i EC1EEB60-5943-11C9-A309-08002B102989,1.1
The -o option defines an object UUID that further determines the
endpoint's elements that are removed. Each remove mapping command
accepts up to 32 -o options. The UUID is a hexidecimal string; for
example:
-o 3C6B8F60-5945 -11C9-A236-08002B102989
The host-addr is a string binding that indicates where to find the
target endpoint map. When accessing the local endpoint map, you can
optionally specify what protocol sequence to use. When accessing a
remote endpoint map, you must specify both a protocol sequence and a
network address for the remote system; for example,
ncadg_ip_upd:16.20.16.44
An endpoint is superfluous in these local or remote host addresses,
and the remove mapping command ignores any endpoint specified as
part of a host address.
show mapping [ -i if-id [ -v versions ] ] [-o object-uuid ] [host-addr]
Shows map elements in the endpoint map at host-addr. If entered
without a remote host address as an argument, the show mapping
command operates on the local endpoint map. If entered without any
options, the commands displays all the elements in the target
endpoint map. The options allow you to list a selected subset of
map elements.
The -i option declares an interface identifier associated with the
string binding. Only one interface can be specified in a single
operation. The interface identifier has the following form:
interface-uuid,major-version.minor-version
In an interface identifier, the UUID is a hexadecimal string and the
version numbers a decimal string; for example:
-i EC1EEB60-5943-11C9-A309-08002B102989,1.1
The -v option, which can be used with the -i option, indicates how
the major and minor versions of a specified interface identifier are
used. If used without the -i option, the -v option is ignored. You
can specify the following values for the -v option:
all The specified versions are ignored and all versions of the
interface identifier are displayed
exact Both the major and minor versions must match the specified
one
compatible
The major version must match the specified one and the
minor version must be greater or equal to the specified
one
major_only
The major version must match the specified one; the minor
version is ignored
upto The major and minor versions must be less than or equal to
those specified
The -o option defines an object UUID that further determines the
endpoint's elements that are removed. Each remove mapping command
accepts up to 32 -o options. The UUID is a hexidecimal string; for
example:
-o 3C6B8F60-5945 -11C9-A236-08002B102989
The host-addr is a string binding that indicates where to find the
target endpoint map. When accessing the local endpoint map, you can
optionally specify what protocol sequence to use. When accessing a
remote endpoint map, you must specify both a protocol sequence and a
network address for the remote system; for example,
ncadg_ip_upd:16.20.16.44
An endpoint is superfluous in these local or remote host addresses,
and the remove mapping command ignores any endpoint specified as
part of a host address.
EXAMPLES
The following rpccp remove mapping command operates from the system
prompt. The command removes, from the local endpoint map, the map
element that contains the specified interface identifier, server address
(specified as a string binding), and object UUID. (The backslash in the
example is a continuation character.)
% rpccp remove mapping \
> -b ncadg_ip_udp:16.20.16.64[3424] \
> -i EC1EEB60-5943-11C9-A309-08002B102989,1.1 \
> -o 30DBEEA0-FB6C-11C9-8EEA-08002B0F4528
The following commands start the control program and remove an element
from a remote endpoint map. The remove mapping command operates on the
endpoint map of the remote host specified by the host address
(ncadg_ip_udp:16.20.16.44) and removes the map element that contains the
specified interface identifier, server address (specified as a string
binding), and object UUID.
% rpccp
rpccp> remove mapping \
> -b ncadg_ip_udp:16.20.16.64[3424] \
> -i EC1EEB60-5943-11C9-A309-08002B102989,1.1 \
> -o 30DBEEA0-FB6C-11C9-8EEA-08002B0F4528 \
ncadg_ip_udp:16.20.16.44
The following commands start the control program and show the map
elements in the local endpoint map that contain the specified interface
identifier.
% rpccp
rpccp> show mapping -i EC1EEB60-5943-11C9-A309-08002B102989,1.1
The following rpccp show mapping command operates from the system prompt.
The command operates on the endpoint map of the remote host specified by
the host address (ncadg_ip_udp:16.20.16.44) and displays the one map
element that contains both the specified interface identifier and the
specified object UUID.
% rpccp show mapping \
> -i EC1EEB60-5943-11C9-A309-08002B102989,1.1 \
> -o 30DBEEA0-FB6C-11C9-8EEA-08002B0F4528 \
> ncadg_ip_udp:16.20.16.44