| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Change RIP Filter (CHGRIPFLT) command changes the attributes of an existing RIP filter that the OMPROUTED server is using to support the RIP (Routing Information Protocol) implementation.
RIP Filters can be configured to OMPROUTED such that certain RIP routing information will not be sent out to other routers and/or accepted from other routers. By using filters, an installation can limit the amount of RIP routing information sent into the network and/or the amount of RIP routing information maintained by OMPROUTED. In addition, filters can be used to hide destination addresses from portions of the network.
Both IPv4 (RIPv2) and IPv6 (RIPng) filters can be changed.
In order to uniquely identify and change an IPv4 RIP filter from the configuration file, the Destination route (DEST), the Filter type (TYPE) and the Subnet mask (SUBNETMASK) parameters are required. The Prefix length (PFXLEN) parameter would be ignored for IPv4 routes. However, in order to uniquely identify and change an IPv6 RIP filter, the Destination route (DEST), the Filter type (TYPE) and the Prefix length (PFXLEN) parameters are required. The Subnet mask (SUBNETMASK) parameter would be ignored for IPv6 routes.
Restrictions:
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| DEST | Destination route | Character value | Required, Key, Positional 1 |
| TYPE | Filter type | *NOSND, *NORCV | Required, Key, Positional 2 |
| SUBNETMASK | Subnet mask | Character value, *HOST | Optional |
| PFXLEN | Prefix length | 1-128, 128 | Optional |
| NEWTYPE | New filter type | *SAME, *NOSND, *NORCV | Optional |
| NEWSUBNMSK | New subnet mask | Character value, *SAME, *HOST | Optional |
| NEWPFXLEN | New prefix length | 1-128, *SAME | Optional |
| Top |
The Destination route parameter specifies the route in network, subnetwork, or host format in dotted decimal form for IPv4 or the route in colon-hexadecimal format for IPv6. Alternatively, wildcards (*IPV4 or *IPV6), which matches any destination, can be set to filter out all routes sent or received over an interface. The use of the wildcards is also referred to as a blackhole filter. This should be used in conjunction with either additional send or receive filters to allow only certain routes to be received; or advertised over an interface or set of interfaces. The address can be an IPv4 or IPv6 address.
| Top |
Specifies if the filter is being used to block routes coming in or going out of the server.
This is a required parameter.
| Top |
Specifies the subnet mask with respect to the network range specified for the Destination route (DEST) parameter. If this value is not set, the default subnet mask is 255.255.255.255 (*HOST), meaning apply the filter to the DEST parameter as was set. Setting the subnet mask has no meaning and is not valid, if the DEST parameter is set as an asterisk (*) for a blackhole filter.
This parameter is required, when the Destination route (DEST) parameter is an IPv4 address.
For example, 255.255.255.0 could define a subnet mask for an interface with a Class B internet address. In this example, the first two octets must be 1 bits because these octets define the network ID portion of the Class B internet address. The third octet of this subnet mask defines the actual subnet mask ID portion of the interface's internet address. It is also all 1 bits. This leaves the fourth octet to define the host ID portion of the interface's internet address.
| Top |
Specifies how much of the leftmost portion of an IPv6 address is the subnet prefix. If not set, the default prefix length is 128, meaning apply the filter to the Destination route (DEST) parameter as was set. Setting the prefix length has no meaning and is not valid if the DEST parameter is set as an asterisk (*) for a blackhole filter.
This parameter is required, when the Destination route (DEST) parameter is an IPv6 address.
| Top |
The new value used to change the filter type. It can be any of the following values:
| Top |
The new value used to change the subnet mask associated to the Destination route (DEST) parameter. Subnet mask is ignored for IPv6 destination routes.
For example, 255.255.255.0 could define a subnet mask for an interface with a Class B internet address. In this example, the first two octets must be 1 bits because these octets define the network ID portion of the Class B internet address. The third octet of this subnet mask defines the actual subnet mask ID portion of the interface's internet address. It is also all 1 bits. This leaves the fourth octet to define the host ID portion of the interface's internet address.
| Top |
The new value used to change the prefix length associated to the IPv6 address specified in the Destination route (DEST) parameter. This parameter is ignored for an IPv4 destination route.
| Top |
Example 1:Changing a RIP Filter
CHGRIPFLT DEST('9.67.107.7') TYPE(*NORCV)
SUBNETMASK(255.255.255.0) NEWTYPE(*NOSND)
This command changes the filter route of the network 9.67.107.0 to output.
Example 2:Changing a RIPng (IPv6) Filter
CHGRIPFLT DEST('1000:5678:9abc:def::E609') TYPE(*NOSND) PFXLEN(64)
NEWTYPE(*NORCV)
This command changes filter route of the IPv6 network 1000:5678:9ABC:DEF::0000 to input.
| Top |
*ESCAPE Messages
| Top |