Login
- Table of Contents
- Related Documents
-
| Title | Size | Download |
|---|---|---|
| 04-IPC Commands | 122.46 KB |
Support for IPC configuration commands depends on your device model. For more information, see About the WX Series Access Controllers Command References.
The display commands in this document display information about active nodes only.
display ipc channel
Syntax
display ipc channel { node node-id | self-node } [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
node node-id: Displays channel information for the specified node, where node-id represents the number of the specified node. The value can be 0 or 1.
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.
Description
Use display ipc channel to display channel information for a node.
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, is used 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
Syntax
display ipc link { node node-id | self-node } [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
node node-id: Displays the link status of the specified node, where node-id represents the number of the specified node. The value can be 0 or 1.
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.
Description
Use display ipc link to display the link status of the specified node.
Examples
# Display the link status of the local node.
<Sysname> display ipc link self-node
Dst-NodeID LinkStatus
-------------------------------------------
1 UP
2 DOWN
The above prompt information indicates that:
· An UP connection exists between the local node and node 1.
· A DOWN connection exists between the local node and node 2.
Table 2 Command output
|
Field |
Description |
|
Dst-NodeID |
Number of the peer node. |
|
LinkStatus |
Link status: · UP—A connection is established. · DOWN—A connection is terminated. |
display ipc multicast-group
Syntax
display ipc multicast-group { node node-id | self-node } [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
node node-id: Displays multicast group information for the specified node, where node-id represents the number of the specified node. The value can be 0 or 1.
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.
Description
Use display ipc multicast-group to display multicast group information for the specified node.
Examples
# Display multicast group information for node 6.
<Sysname> display ipc multicast-group node 6
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
Syntax
display ipc node [ | { begin | exclude | include } regular-expression ]
View
Any view
Default 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.
Description
Use display ipc node to display node information.
Examples
# Display node information for the device.
<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
Syntax
display ipc packet { node node-id | self-node } [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
node node-id: Displays the packet statistics of the specified node, where node-id represents the number of the specified node. The value can be 0 or 1.
self-node: Displays the packet statistics 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.
Description
Use display ipc packet to display the packet statistics of the specified node.
Examples
# Display the packet statistics of 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
Syntax
display ipc performance { node node-id | self-node } [ channel channel-id ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
node node-id: Displays the IPC performance statistics of the specified node, where node-id represents the number of the specified node. The value can be 0 or 1.
self-node: Displays the IPC performance statistics of the local node.
channel channel-id: Displays the IPC performance statistics of the specified channel, where channel-id represents the channel number. The value ranges from 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.
Description
Use display ipc performance to display IPC performance statistics.
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 at the time when IPC performance statistics is disabled.
Related commands: ipc performance enable.
Examples
# Display IPC performance statistics for node 6.
<Sysname> display ipc performance node 6
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 recieved 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 counted every 10 seconds, the greatest value of which 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. |
display ipc queue
Syntax
display ipc queue { node node-id | self-node } [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
node node-id: Displays sending queue information for the specified node, where node-id represents the number of the specified node. The value can be 0 or 1.
self-node: Displays sending queue 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.
Description
Use display ipc queue to display sending queue information for the specified node.
Examples
# Display sending 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 unicasts, multicasts, and broadcasts. |
|
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
Syntax
ipc performance enable { node node-id | self-node } [ channel channel-id ]
undo ipc performance enable [ node node-id | self-node ] [ channel channel-id ]
View
User view
Default level
1: Monitor level
Parameters
node node-id: Enables IPC performance statistics for the specified node, where node-id represents the number of the specified node. The value can be 0 or 1.
self-node: Enables IPC performance statistics for the local node.
channel channel-id: Enables IPC performance statistics for the specified channel, where channel-id represents the channel number. The value ranges from 0 to 255.
Description
Use ipc performance enable to enable IPC performance statistics.
Use undo ipc performance to disable IPC performance statistics.
By default, IPC performance statistics is disabled.
When IPC performance statistics is disabled, the statistics data does not change. In this case, if you execute the display ipc performance command, the statistics data at the time when IPC performance statistics was disabled.
Examples
# Enable IPC performance statistics for channel 18 on node 6.
<Sysname> ipc performance enable node 6 channel 18
reset ipc performance
Syntax
reset ipc performance [ node node-id | self-node ] [ channel channel-id ]
View
User view
Default level
1: Monitor level
Parameters
node node-id: Clears the IPC performance statistics for the specified node, where node-id represents the number of the specified node. The value can be 0 or 1.
self-node: Clears the IPC performance statistics for the local node.
channel channel-id: Clears the IPC performance statistics for the specified channel, where channel-id represents the channel number. The value ranges from 0 to 255.
Description
Use reset ipc performance to clear IPC performance statistics.
After you execute this command, the command clears the corresponding statistics.
Examples
# Clear the IPC performance statistics for channel 18 on node 6.
<Sysname> reset ipc performance node 6 channel 18
