- Table of Contents
-
- 06-Layer 3—IP Services Command Reference
- 00-Preface
- 01-ARP commands
- 02-IP addressing commands
- 03-DHCP commands
- 04-DNS commands
- 05-NAT commands
- 06-IP forwarding basics commands
- 07-Fast forwarding commands
- 08-Multi-CPU packet distribution commands
- 09-Adjacency table commands
- 10-IRDP commands
- 11-IP performance optimization commands
- 12-UDP helper commands
- 13-IPv6 basics commands
- 14-DHCPv6 commands
- 15-IPv6 fast forwarding commands
- 16-AFT commands
- 17-Tunneling commands
- 18-GRE commands
- 19-ADVPN commands
- 20-WAAS commands
- 21-HTTP proxy commands
- Related Documents
-
Title | Size | Download |
---|---|---|
06-IP forwarding basics commands | 69.03 KB |
ip forwarding apply dscp enable
ip forwarding apply vpn-peer-id enable
ip forwarding apply mpls-exp enable
ip load-sharing local-first enable
Basic IP forwarding commands
display fib
Use display fib to display FIB entries.
Syntax
display fib [ topology topology-name | vpn-instance vpn-instance-name ] [ ip-address [ mask | mask-length ] ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
topology topology-name: Specifies a topology by its name, a case-sensitive string of 1 to 31 characters. To specify a public topology, use base as the topology name. To display FIB entries for the public network, do not specify this option.
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. To display the FIB entries for the public network, do not specify any VPN instance.
ip-address: Displays the FIB entry that matches the specified destination IP address.
mask: Specifies the mask for the IP address.
mask-length: Specifies the mask length for the IP address. The value range is 0 to 32.
Usage guidelines
If you specify an IP address without a mask or mask length, this command displays the longest matching FIB entry.
If you specify an IP address and a mask or mask length, this command displays the exactly matching FIB entry.
Examples
# Display FIB entries for topology mt.
<Sysname> display fib topology mt
Destination count: 8 FIB entry count: 8
Flag:
U:Useable G:Gateway H:Host B:Blackhole D:Dynamic S:Static
R:Relay F:FRR
Destination/Mask Nexthop Flag OutInterface/Token Label
0.0.0.0/32 127.0.0.1 UH InLoop0 Null
127.0.0.0/8 127.0.0.1 U InLoop0 Null
127.0.0.0/32 127.0.0.1 UH InLoop0 Null
127.0.0.1/32 127.0.0.1 UH InLoop0 Null
127.255.255.255/32 127.0.0.1 UH InLoop0 Null
224.0.0.0/4 0.0.0.0 UB NULL0 Null
224.0.0.0/24 0.0.0.0 UB NULL0 Null
255.255.255.255/32 127.0.0.1 UH InLoop0 Null
# Display all FIB entries of the public network.
<Sysname> display fib
Destination count: 5 FIB entry count: 5
Flag:
U:Useable G:Gateway H:Host B:Blackhole D:Dynamic S:Static
R:Relay F:FRR
Destination/Mask Nexthop Flag OutInterface/Token Label
0.0.0.0/32 127.0.0.1 UH InLoop0 Null
1.1.1.0/24 192.168.126.1 USGF M-GE0/0/0 Null
127.0.0.0/8 127.0.0.1 U InLoop0 Null
127.0.0.0/32 127.0.0.1 UH InLoop0 Null
127.0.0.1/32 127.0.0.1 UH InLoop0 Null
# Display the FIB entries for VPN vpn1.
<Sysname> display fib vpn-instance vpn1
Destination count: 6 FIB entry count: 6
Flag:
U:Useable G:Gateway H:Host B:Blackhole D:Dynamic S:Static
R:Relay F:FRR
Destination/Mask Nexthop Flag OutInterface/Token Label
0.0.0.0/32 127.0.0.1 UH InLoop0 Null
20.20.20.0/24 20.20.20.25 U M-GE0/0/0 Null
20.20.20.0/32 20.20.20.25 UBH M-GE0/0/0 Null
20.20.20.25/32 127.0.0.1 UH InLoop0 Null
20.20.20.25/32 20.20.20.25 H M-GE0/0/0 Null
20.20.20.255/32 20.20.20.25 UBH M-GE0/0/0 Null
# Display the FIB entries matching the destination IP address 10.2.1.1.
<Sysname> display fib 10.2.1.1
Destination count: 1 FIB entry count: 1
Flag:
U:Useable G:Gateway H:Host B:Blackhole D:Dynamic S:Static
R:Relay F:FRR
Destination/Mask Nexthop Flag OutInterface/Token Label
10.2.1.1/32 127.0.0.1 UH InLoop0 Null
Table 1 Command output
Field |
Description |
Destination count |
Total number of destination addresses. |
FIB entry count |
Total number of FIB entries. |
Destination/Mask |
Destination address and the mask length. |
Nexthop |
Next hop address. |
Flag |
Flags of routes: · U—Usable route. · G—Gateway route. · H—Host route. · B—Blackhole route. · D—Dynamic route. · S—Static route. · R—Relay route. · F—Fast reroute. |
OutInterface/Token |
Output interface/LSP index number. |
Label |
Inner label. |
ip forwarding apply dscp enable
Use ip forwarding apply dscp enable to enable the DSCP setting for packets.
Use undo ip forwarding apply dscp enable to disable the DSCP setting.
Syntax
ip forwarding apply dscp enable
undo ip forwarding apply dscp enable
Default
The DSCP setting for packets is disabled.
Views
System view
Predefined user roles
network-admin
Usage guidelines
This feature enables the device to use the DSCP value in the FIB table for packets to be forwarded. This DSCP value is set along with the routing information from the routing table.
This command must be used together with the apply dscp command. For more information about the command, see Layer 3—IP Routing Command Reference.
Examples
# Enable the DSCP setting for packets
<Sysname> system-view
[Sysname] ip forwarding apply dscp enable
ip forwarding apply vpn-peer-id enable
Use ip forwarding apply vpn-peer-id enable to enable the VPN peer-based processing.
Use undo ip forwarding apply vpn-peer-id enable to disable the VPN peer-based processing.
Syntax
ip forwarding apply vpn-peer-id enable
undo ip forwarding apply vpn-peer-id enable
Default
The VPN peer-based processing is disabled.
Views
System view
Predefined user roles
network-admin
Usage guidelines
This feature enables the device to use the VPN peer ID of the routing information in the FIB table to process packets.
This command must be used together with the apply vpn-peer-id command. For more information about the command, see Layer 3—IP Routing Command Reference.
Examples
# Enable the VPN peer-based processing.
<Sysname> system-view
[Sysname] ip forwarding apply vpn-peer-id enable
ip forwarding apply mpls-exp enable
Use ip forwarding apply mpls-exp enable to enable the FIB-based EXP setting for MPLS packets.
Use undo ip forwarding apply mpls-exp enable to disable the FIB-based EXP setting for MPLS packets.
Syntax
ip forwarding apply mpls-exp enable
undo ip forwarding apply mpls-exp enable
Default
The FIB-based EXP setting for MPLS packets is disabled.
Views
System view
Predefined user roles
network-admin
Usage guidelines
This feature modifies the EXP field value of MPLS packets based on the EXP value in the FIB entry that matches the packets. It must be used in conjunction with the apply mpls-exp command. For more information about the apply mpls-exp command, see routing policy commands in Layer 3—IP Routing Command Reference.
Examples
# Enable the FIB-based EXP setting for MPLS packets.
<Sysname> system
[Sysname] ip forwarding apply mpls-exp enable
Related commands
apply mpls-exp
ip forwarding apply vpn-peer-id enable
Load sharing commands
bandwidth-based-sharing
Use bandwidth-based-sharing to enable IPv4 load sharing based on bandwidth.
Use undo bandwidth-based-sharing to disable IPv4 load sharing based on bandwidth.
Syntax
bandwidth-based-sharing
undo bandwidth-based-sharing
Default
The IPv4 load sharing based on bandwidth is disabled.
Views
System view
Predefined user roles
network-admin
Usage guidelines
This feature load shares flow traffic among multiple output interfaces based on their load percentages. The device calculates the load percentage for each output interface in terms of their expected bandwidths.
Devices that run load sharing protocols, such as Locator/ID Separation Protocol (LISP), implement load sharing based on the ratios defined by these protocols.
Examples
# Enable IPv4 load sharing based on bandwidth.
<Sysname> system-view
[Sysname] bandwidth-based-sharing
ip load-sharing local-first enable
Use ip load-sharing local-first enable to enable local-first load sharing.
Use undo ip load-sharing local-first enable to disable local-first load sharing.
Syntax
ip load-sharing local-first enable
undo ip load-sharing local-first enable
Default
The default setting varies by device model.
Views
System view
Predefined user roles
network-admin
Usage guidelines
Local-first load sharing takes effect only on an IRF fabric.
Examples
# Enable local-first load sharing.
<Sysname> system-view
[Sysname] ip load-sharing local-first enable
ip load-sharing mode
Use ip load-sharing mode to configure the load sharing mode.
Use undo ip load-sharing mode to restore the default.
Syntax
In standalone mode:
ip load-sharing mode { per-flow [ dest-ip | dest-port | ip-pro | src-ip | src-port ] * ] | per-packet } global
undo ip load-sharing mode global
In IRF mode:
ip load-sharing mode { per-flow [ dest-ip | dest-port | ip-pro | src-ip | src-port ] * ] | per-packet } { global | slot slot-number }
undo ip load-sharing mode { global | slot slot-number }
Default
The default varies by device model.
Views
System view
Predefined user roles
network-admin
Parameters
per-flow: Implements per-flow load sharing.
dest-ip: Identifies flows by destination IP address.
dest-port: Identifies flows by destination port.
ip-pro: Identifies flows by protocol number.
src-ip: Identifies flows by source IP address.
src-port: Identifies flows by source port.
global: Configures the load sharing mode globally.
per-packet: Implements per-packet load sharing.
slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a member device, this command configures the load sharing mode for all member devices. (In IRF mode.)
Usage guidelines
The per-packet load sharing mode does not take effect in fast forwarding.
Examples
# (In standalone mode.) Configure per-flow load sharing.
[Sysname] ip load-sharing mode per-flow global
# (In IRF mode.) Configure per-flow load sharing for slot 1.
<Sysname> system-view
[Sysname] ip load-sharing mode per-flow slot 1