IPC configuration commands 1

display ipc channel 1

display ipc link· 2

display ipc multicast-group· 3

display ipc node· 4

display ipc packet 4

display ipc performance· 6

display ipc queue· 7

ipc performance enable· 8

reset ipc performance· 9

 

 

NOTE: ·       The display commands in this document display information about active nodes only. ·       “local node” refers to an active switching and routing processing unit (SRPU).

 

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 of the node-id argument ranges from 0 to 42.

self-node: Displays the 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 the display ipc channel command to display the channel information for the specified node.

Examples

# Display channel information of 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 Output description

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 router, 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 information for the specified node, where node-id represents the number of the specified node. The value of the node-id argument ranges from 0 to 42.

self-node: Displays the link status 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 the display ipc link command to display the link status of the specified node.

Examples

# Display 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 Output description

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 the multicast group information for the specified node, where node-id represents the number of the specified node. The value of the node-id argument ranges from 0 to 42.

self-node: Displays the 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 the display ipc multicast-group command to display the multicast group information for the specified node.

Examples

# Display the multicast group information for node 6.

<Sysname> display ipc multicast-group node 6

GroupID    Status    ChannelID

----------------------------------

8           INUSE      12

Table 3 Output description

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 the display ipc node command to display node information.

Examples

# Display node information for the router.

<Sysname> display ipc node

Self node ID: 0

Current active node ID: 0

Table 4 Output description

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 of the node-id argument ranges from 0 to 42.

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 the display ipc packet command 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 Output description

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. If the number of bytes the packet is larger than the MTU, the packet is fragmented; if 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 of the node-id argument ranges from 0 to 42.

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 of the channel-id argument ranges from 0 to 179.

|: 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 the display ipc performance command 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 of 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 Output description

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 past 10 seconds.
1Min	Average rate (in pps) in the past 1 minute.
5Min	Average rate (in pps) in the past 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 the sending queue information for the specified node, where node-id represents the number of the specified node. The value of the node-id argument ranges from 0 to 42.

self-node: Displays the 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 the display ipc queue command to display the sending queue information for the specified node.

Examples

# Display the 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 Output description

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 of the specified node, where node-id represents the number of the specified node. The value of the node-id argument ranges from 0 to 42.

self-node: Enables IPC performance statistics of the local node.

channel channel-id: Enables IPC performance statistics of the specified channel, where channel-id represents the channel number. The value of the channel-id argument ranges from 0 to 179.

Description

Use the ipc performance enable command to enable IPC performance statistics. Use the undo ipc performance command 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 of 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 of the specified node, where node-id represents the number of the specified node. The value of the node-id argument ranges from 0 to 42.

self-node: Clears the IPC performance statistics of the local node.

channel channel-id: Clears the IPC performance statistics of the specified channel, where channel-id represents the channel number. The value of the channel-id argument ranges from 0 to 179.

Description

Use the reset ipc performance command to clear IPC performance statistics.

After this command is executed, the corresponding statistics will be cleared.

Examples

# Clear IPC performance statistics of channel 18 on node 6.

<Sysname> reset ipc performance node 6 channel 18