NAME
remove mapping - Removes specified elements from either the
local or a remote endpoint map
SYNOPSIS
rpccp remove mapping [ host-address ]
-b string-binding -i if-id [ -v versions ]
[ -o object-uuid ]
1 – OPTIONS
-b Declares a string binding (required). You must also
specify an interface identifier (using the -i option).
Each command accepts up to 32 -b options.
The value has the form of an RPC string binding, without
an object UUID, for example:
-b ncadg_ip_udp:63.0.2.17[5347]
Note that depending on your system, string binding
delimiters such as brackets ([ ]) may need to be preceded
by an escape symbol (\) or placed within quotation marks
(' ' or " "). Requirements vary from system to system,
and you must conform to the usage rules of a system.
-i Declares an interface identifier (required). Only one
interface can be removed in a single operation. The
interface identifier has the following form:
interface-uuid,major-version.minor-version
2 – ARGUMENTS
host-address
The host-address argument is a string binding that
indicates where to find the target endpoint map.
When accessing the local endpoint map, you can
specify what protocol sequence to use (optional);
ncadg_ip_udp:
When accessing a remote endpoint map, you must
specify both a protocol sequence and a network
address for the remote system (required); for
ncadg_ip_udp:16.20.16.44
An endpoint is unnecessary in local or remote host
addresses, and the remove mapping command ignores
any endpoint specified as part of a host address.
3 – DESCRIPTION
The remove mapping command removes one or more elements from
an endpoint map. The target endpoint map can be either the
local endpoint map or the endpoint map of a specified remote
host. Each map element corresponds to an object UUID,
interface identifier, annotation (optional), and binding
information. The binding information contains an RPC
protocol sequence, a network address, and an endpoint within
brackets (rpc-prot-seq:network-addr[endpoint]).
If entered without a remote host address as an argument, the
command operates on the local endpoint map. This command
requires one interface identifier (the -i option); at least
one string binding (the -b option); and, optionally, one or
more object UUIDs (the -o option). Each instance of the
command accepts from 1 to 32 -b options and from 0 to 32 -o
options. The options work together to delimit the elements
to be removed from the target endpoint map. The command
removes any map element that contains the specified
interface identifier, a specified string binding, and a
specified object UUID (if any).
4 – EXAMPLES
The following command operates from the system prompt to
remove a map element from the local endpoint map. The
command removes only the map element that contains the
specified interface identifier, server address (specified as
a string binding), and object UUID.
$ 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
rpccp>