Login
- Table of Contents
- Related Documents
-
| Title | Size | Download |
|---|---|---|
| 04-IPC Commands | 84.45 KB |
IPC configuration commands
Support for the IPC commands depends on the device model. For more information, see About the H3C Access Controllers Command References.
The display commands in this document only display information about active nodes.
"Local node" refers to an AC module, a wireless switch, or an AC.
display ipc channel
Use display ipc channel to display channel information for a node.
Syntax
display ipc channel { node node-id | self-node } [ | { begin | exclude | include } regular-expression ]
Views
Any view
Default command level
1: Monitor level
Parameters
node node-id: Displays channel information for a node. The node ID can be 0 or 1. Node 1 represents the local device, and node 0 represents the peer device.
self-node: Displays channel information for the local node.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Examples
# Display channel information for node 0.
<Sysname> display ipc channel node 0
ChannelID Description
-----------------------------------------------
19 RPC channel
72 Portal Backup Channel
79 DHCP
94 IPC test channel
149 Prehistorical channel, NO.1
Table 1 Command output
|
Field |
Description |
|
ChannelID |
Channel number, which has been predefined and assigned by the system. One channel number corresponds to one module. The display ipc channel command displays the numbers of the current active modules. |
|
Description |
Description information, which is generated by the internal software of the device to describe the functions of a channel. For example, "FIB4" indicates that the channel is used for Layer 3 fast forwarding. "Prehistorical channel, NO.2" indicates that no description is defined for the channel, and the channel is the second channel established. |
display ipc link
Use display ipc link to display the link status of the specified node.
Syntax
display ipc link { node node-id | self-node } [ | { begin | exclude | include } regular-expression ]
Views
Any view
Default command level
1: Monitor level
Parameters
node node-id: Displays the link status of the specified node. The node ID can be 0 or 1. Node 1 represents the local device, and node 0 represents the peer device.
self-node: Displays the link status of the local node.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Examples
# Display link status of the local node.
<Sysname> display ipc link self-node
Dst-NodeID LinkStatus
-------------------------------------------
0 UP
The output shows that the connection between the local node and peer node 0 is up.
Table 2 Command output
|
Field |
Description |
|
Dst-NodeID |
Number of the peer node. |
|
LinkStatus |
Link status: · UP—The connection has been established. · DOWN—The connection has been terminated. |
display ipc multicast-group
Use display ipc multicast-group to display multicast group information for a node.
Syntax
display ipc multicast-group { node node-id | self-node } [ | { begin | exclude | include } regular-expression ]
Views
Any view
Default command level
1: Monitor level
Parameters
node node-id: Displays multicast group information for the specified node. The node ID can be 0 or 1. Node 1 represents the local device, and node 0 represents the peer device.
self-node: Displays multicast group information for the local node.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Examples
# Display multicast group information for node 1.
<Sysname> display ipc multicast-group node 1
GroupID Status ChannelID
----------------------------------
8 INUSE 12
Table 3 Command output
|
Field |
Description |
|
GroupID |
Multicast group ID. |
|
Status |
Link status: · INUSE—The multicast group is in use. · DELETE—The multicast group is to be deleted. |
|
ChannelID |
Channel number. |
display ipc node
Use display ipc node to display node information.
Syntax
display ipc node [ | { begin | exclude | include } regular-expression ]
Views
Any view
Default command level
1: Monitor level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Examples
# Display node information.
<Sysname> display ipc node
Self node ID: 0
Current active node ID: 0
Table 4 Command output
|
Field |
Description |
|
Self node ID |
Number of the local node. |
|
Current active node ID |
List of the current active nodes. |
display ipc packet
Use display ipc packet to display the packet statistics for the specified node.
Syntax
display ipc packet { node node-id | self-node } [ | { begin | exclude | include } regular-expression ]
Views
Any view
Default command level
1: Monitor level
Parameters
node node-id: Displays the packet statistics for the specified node. The node ID can be 0 or 1. Node 1 represents the local device, and node 0 represents the peer device.
self-node: Displays packet statistics for the local node.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Examples
# Display the packet statistics for the local node.
<Sysname> display ipc packet self-node
ChannelID Sent-fragments Sent-packets Received-fragments Received-packets
--------------------------------------------------------------------------
11 828 810 819 810
13 0 0 0 0
14 5 3 5 5
15 0 0 0 0
16 0 0 0 0
17 50 50 37 35
19 0 0 0 0
Table 5 Command output
|
Field |
Description |
|
ChannelID |
Channel number. |
|
Sent-fragments |
Number of fragments sent. |
|
Sent-packets |
Number of packets sent. Whether a packet is fragmented depends on the interface MTU and the packet size in bytes. If the packet size is larger than the MTU, the packet is fragmented. If the packet size is smaller than or equal to the MTU, the packet is sent. |
|
Received-fragments |
Number of fragments successfully received. |
|
Received-packets |
Number of packets successfully received. If fragments are received on an interface, the system reassembles the fragments and sends a complete packet to the upper layer software. |
display ipc performance
Use display ipc performance to display IPC performance statistics.
Syntax
display ipc performance { node node-id | self-node } [ channel channel-id ] [ | { begin | exclude | include } regular-expression ]
Views
Any view
Default command level
1: Monitor level
Parameters
node node-id: Displays the IPC performance statistics for the specified node. The node ID can be 0 or 1. Node 1 represents the local device, and node 0 represents the peer device.
self-node: Displays the IPC performance statistics for the local node.
channel channel-id: Displays the IPC performance statistics for the specified channel. The channel-id argument takes a channel number in the range of 0 to 255.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Usage guidelines
If IPC performance statistics is enabled, the command displays the current IPC performance statistics. If IPC performance statistics is disabled, the command displays the IPC performance statistics collected before IPC performance statistics was disabled.
Examples
# Display the IPC performance statistics for node 1.
<Sysname> display ipc performance node 1
Peak: Peak rate (pps)
10Sec: Average rate in the last 10 seconds (pps)
1Min: Average rate in the last 1 minute (pps)
5Min: Average rate in the last 5 minutes (pps)
Total-Data: Total number of data (packets)
Statistics for packets sent successfully:
Peak 10Sec 1Min 5Min Total-Data
------------------------------------------------------------
1 1 1 0 80
Statistics for packets received successfully:
Peak 10Sec 1Min 5Min Total-Data
------------------------------------------------------------
1 1 1 0 82
Statistics for packets acknowledged:
Peak 10Sec 1Min 5Min Total-Data
------------------------------------------------------------
1 1 1 0 78
Table 6 Command output
|
Field |
Description |
|
Peak |
Peak rate in pps (average rate is computed every 10 seconds, and the greatest average rate is taken as the peak rate). |
|
10Sec |
Average rate (in pps) in the last 10 seconds. |
|
1Min |
Average rate (in pps) in the last 1 minute. |
|
5Min |
Average rate (in pps) in the last 5 minutes. |
|
Total-Data |
Total amount of data collected from the time when IPC performance statistics was enabled to the time when this command is executed. |
Related commands
ipc performance enable
display ipc queue
Use display ipc queue to display output queue information for an IPC node.
Syntax
display ipc queue { node node-id | self-node } [ | { begin | exclude | include } regular-expression ]
Views
Any view
Default command level
1: Monitor level
Parameters
node node-id: Specifies a node by its number. The node ID can be 0 or 1. Node 1 represents the local device, and node 0 represents the peer device.
self-node: Specifies the local node.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Examples
# Display output queue information for the local node.
<Sysname> display ipc queue self-node
QueueType QueueID Dst-NodeID Length FullTimes Packet
------------------------------------------------------------
UNICAST 0 0 4096 0 0
UNICAST 1 0 4096 0 0
UNICAST 2 0 4096 0 0
UNICAST 3 0 4096 0 0
UNICAST 0 1 4096 0 0
UNICAST 1 1 4096 0 0
UNICAST 2 1 4096 0 0
UNICAST 3 1 4096 0 0
MULTICAST 0 -- 4096 0 0
MULTICAST 1 -- 4096 0 0
MULTICAST 2 -- 512 0 0
MULTICAST 3 -- 512 0 0
MULTICAST 4 -- 512 0 0
MULTICAST 5 -- 512 0 0
MIXCAST 0 -- 2048 0 0
MIXCAST 1 -- 2048 0 0
Table 7 Command output
|
Field |
Description |
|
QueueType |
Queue type: · UNICAST—Unicast queue. · MULTICAST—Multicast (including broadcast) queue. · MIXCAST—Mixcast queue, which can accommodate unicast, multicast, and broadcast traffic. |
|
QueueID |
Queue number. |
|
Dst-NodeID |
Peer node number. If no peer node exists, two hyphens (--) are displayed. |
|
Length |
Queue length (number of packets that can be buffered). |
|
FullTimes |
Times that the queue is full. |
|
Packet |
Total number of packets in the queue. |
ipc performance enable
Use ipc performance enable to enable IPC performance statistics.
Use undo ipc performance to disable IPC performance statistics.
Syntax
ipc performance enable { node node-id | self-node } [ channel channel-id ]
undo ipc performance enable [ node node-id | self-node ] [ channel channel-id ]
Default
IPC performance statistics is disabled.
Views
User view
Default command level
1: Monitor level
Parameters
node node-id: Enables IPC performance statistics for the specified node. The node ID can be 0 or 1. Node 1 represents the local device, and node 0 represents the peer device.
self-node: Enables IPC performance statistics for the local node.
channel channel-id: Enables IPC performance statistics for the specified channel. The channel-id argument takes a channel number in the range of 0 to 255.
Usage guidelines
When IPC performance statistics is disabled, the statistics data does not change. The display ipc performance command displays the statistics collected before IPC performance statistics was disabled.
Examples
# Enable IPC performance statistics for channel 18 on node 1.
<Sysname> ipc performance enable node 1 channel 18
reset ipc performance
Use reset ipc performance to clear IPC performance statistics.
Syntax
reset ipc performance [ node node-id | self-node ] [ channel channel-id ]
Views
User view
Default command level
1: Monitor level
Parameters
node node-id: Clears the IPC performance statistics for the specified node. The node ID can be 0 or 1. Node 1 represents the local device, and node 0 represents the peer device.
self-node: Clears the IPC performance statistics for the local node.
channel channel-id: Clears the IPC performance statistics for the specified channel. The channel-id argument takes a channel number in the range of 0 to 255.
Usage guidelines
After this command is executed, the corresponding statistics will be cleared.
Examples
# Clear the IPC performance statistics for channel 18 on node 1.
<Sysname> reset ipc performance node 1 channel 18
