H3C S5830V2 series Installation manual

H3C S5830V2 & S5820V2 Switch Series
Network Management and Monitoring
Command Reference
Hangzhou H3C Technologies Co., Ltd.
http://www.h3c.com
Software version: Release2108
Document version: 6W101-20120531

Copyright © 2012, Hangzhou H3C Technologies Co., Ltd. and its licensors
All rights reserved
No part of this manual may be reproduced or transmitted in any form or by any means without prior
written consent of Hangzhou H3C Technologies Co., Ltd.
Trademarks
H3C, , Aolynk, , H3Care, , TOP G, , IRF, NetPilot, Neocean, NeoVTL,
SecPro, SecPoint, SecEngine, SecPath, Comware, Secware, Storware, NQA, VVG, V2G, VnG, PSPT,
XGbus, N-Bus, TiGem, InnoVision and HUASAN are trademarks of Hangzhou H3C Technologies Co.,
Ltd.
All other trademarks that may be mentioned in this manual are the property of their respective owners
Notice
The information in this document is subject to change without notice. Every effort has been made in the
preparation of this document to ensure accuracy of the contents, but all statements, information, and
recommendations in this document do not constitute the warranty of any kind, express or implied.

Preface
The H3C S5830V2 & S5820V2 documentation set includes 10 command references, which describe the
commands and command syntax options available for the H3C S5830V2 & S5820V2 Switch Series.
The Network Management and Monitoring Command Reference describes network management and
monitoring configuration commands. It covers the commands for viewing system information,
synchronizing time for all devices with clocks in your network, and checking and debugging the current
network connectivity with the ping, tracert, and debug commands.
This preface includes:
•Audience
•Release-over-release command differences
•Conventions
•About the H3C S5830V2 & S5820V2 documentation set
•Obtaining documentation
•Technical support
•Documentation feedback
Audience
This documentation is intended for:
•Network planners
•Field technical support and servicing engineers
•Network administrators working with the S5830V2 & S5820V2 series
Release-over-release command differences
This documentation set is for Release 2108 and Release 2108P02. The following table describes the
command changes in Release 2108P02 over Release 2108:
Command reference Added and modified commands in Release 2108P02
Ping, tracert, and system debugging None.
NTP None.
Information center
•New commands: terminal debugging.
•Modified commands: Replaces the keywords emergencies, alerts,
errors, warnings, and notifications with emergency, alert, error,
warning, and notification, respectively for the commands
info-center source and terminal logging level.
SNMP None.
Port mirroring None.

Conventions
This section describes the conventions used in this documentation set.
Command conventions
Convention Descri
p
tion
Boldface Bold text represents commands and keywords that you enter literally as shown.
Italic Italic text represents arguments that you replace with actual values.
[ ] Square brackets enclose syntax choices (keywords or arguments) that are optional.
{ x | y | ... }
Braces enclose a set of required syntax choices separated by vertical bars, from which
you select one.
[ x | y | ... ]
Square brackets enclose a set of optional syntax choices separated by vertical bars, from
which you select one or none.
{ x | y | ... } *
Asterisk marked braces enclose a set of required syntax choices separated by vertical
bars, from which you select at least one.
[ x | y | ... ] *
Asterisk marked square brackets enclose optional syntax choices separated by vertical
bars, from which you select one choice, multiple choices, or none.
&<1-n> The argument or keyword and argument combination before the ampersand (&) sign can
be entered 1 to n times.
# A line that starts with a pound (#) sign is comments.
GUI conventions
Convention Descri
p
tion
< > Button names are inside angle brackets. For example, click <OK>.
[ ] Window names, menu items, data table and field names are inside square brackets. For
example, pop up the [New User] window.
/ Multi-level menus are separated by forward slashes. For example, [File/Create/Folder].
Symbols
Convention Descri
p
tion
WARNING An alert that calls attention to important information that if not understood or followed can
result in personal injury.
CAUTION An alert that calls attention to important information that if not understood or followed can
result in data loss, data corruption, or damage to hardware or software.
IMPORTANT An alert that calls attention to essential information.
NOTE An alert that contains additional or supplementary information.
TIP An alert that provides helpful information.

About the H3C S5830V2 & S5820V2
documentation set
The H3C S5830V2&S5820V2 documentation set includes:
Cate
g
or
y
Documents Pur
p
oses
Hardware specifications
and installation
Compliance and safety
manual
Provides regulatory information and the safety
instructions that must be followed during installation.
Installation quick start Provides basic installation instructions.
Installation guide Provides a complete guide to hardware installation
and hardware specifications.
Fan assemblies
installation manual
Describes the appearance, specifications, and
installation and removal of hot-swappable fan
assemblies.
Power modules user
manual
Describes the appearance, specifications, and
installation and removal of hot-swappable power
modules.
Software configuration
Configuration guides Describe software features and configuration
procedures.
Command references Provide a quick reference to all available
commands.
Obtaining documentation
You can access the most up-to-date H3C product documentation on the World Wide Web
at http://www.h3c.com.
Click the links on the top navigation bar to obtain different categories of product documentation:
[Technical Support & Documents > Technical Documents] – Provides hardware installation, software
upgrading, and software feature configuration and maintenance documentation.
[Products & Solutions] – Provides information about products and technologies.
[Technical Support & Documents > Software Download] – Provides the documentation released with the
software version.
Technical support
servi[email protected]
http://www.h3c.com
Documentation feedback
You can e-mail your comments about product documentation to [email protected].
We appreciate your comments.

i
Contents
Ping, tracert, and system debugging commands······································································································· 1
debugging·································································································································································1
display debugging ···················································································································································1
display memory ························································································································································2
display process·························································································································································3
display process cpu ·················································································································································6
display process log ··················································································································································7
display process memory ··········································································································································8
display process memory heap ····························································································································· 10
display process memory heap address ·············································································································· 11
display process memory heap size ····················································································································· 12
monitor process ····················································································································································· 13
monitor thread ······················································································································································· 18
ping········································································································································································· 21
ping ipv6································································································································································ 24
process ··································································································································································· 27
tracert······································································································································································ 28
tracert ipv6····························································································································································· 30
NTP commands ··························································································································································32
display ntp-service ipv6 sessions ························································································································· 32
display ntp-service sessions ·································································································································· 36
display ntp-service status ······································································································································ 40
display ntp-service trace ······································································································································· 42
ntp-service acl ························································································································································ 43
ntp-service authentication enable ························································································································ 44
ntp-service authentication-keyid ··························································································································· 45
ntp-service broadcast-client ·································································································································· 46
ntp-service broadcast-server ································································································································· 47
ntp-service inbound disable·································································································································· 48
ntp-service ipv6 acl ··············································································································································· 48
ntp-service inbound disable·································································································································· 49
ntp-service ipv6 multicast-client ···························································································································· 50
ntp-service ipv6 multicast-server··························································································································· 51
ntp-service ipv6 source ········································································································································· 52
ntp-service ipv6 unicast-peer ································································································································ 52
ntp-service ipv6 unicast-server······························································································································ 54
ntp-service max-dynamic-sessions ························································································································ 55
ntp-service multicast-client····································································································································· 56
ntp-service multicast-server···································································································································· 56
ntp-service refclock-master···································································································································· 57
ntp-service reliable authentication-keyid ············································································································· 58
ntp-service source ·················································································································································· 59
ntp-service unicast-peer········································································································································· 60
ntp-service unicast-server ······································································································································ 61
SNTP commands ························································································································································63
display sntp ipv6 sessions ···································································································································· 63
display sntp sessions············································································································································· 63
sntp authentication enable ··································································································································· 64

ii
sntp authentication-keyid ······································································································································ 65
sntp ipv6 unicast-server········································································································································· 66
sntp reliable authentication-keyid ························································································································ 67
sntp unicast-server ················································································································································· 68
Information center commands ···································································································································70
display info-center ················································································································································· 70
display logbuffer···················································································································································· 71
display logbuffer summary ··································································································································· 73
display logfile summary········································································································································ 74
info-center enable·················································································································································· 75
info-center logbuffer ·············································································································································· 75
info-center logbuffer size ······································································································································ 76
info-center logfile enable ······································································································································ 76
info-center logfile frequency ································································································································· 77
info-center logfile size-quota································································································································· 77
info-center logfile switch-directory ······················································································································· 78
info-center logging suppress duplicates ·············································································································· 79
info-center loghost ················································································································································· 80
info-center loghost source ····································································································································· 80
info-center source ·················································································································································· 81
info-center synchronous ········································································································································ 83
info-center timestamp ············································································································································ 84
info-center timestamp loghost······························································································································· 85
logfile save····························································································································································· 85
reset logbuffer························································································································································ 86
terminal logging level ··········································································································································· 86
terminal monitor····················································································································································· 87
terminal debugging··············································································································································· 88
SNMP commands ······················································································································································89
display snmp-agent community···························································································································· 89
display snmp-agent group ···································································································································· 90
display snmp-agent local-engineid ······················································································································ 91
display snmp-agent mib-view ······························································································································· 92
display snmp-agent remote ·································································································································· 93
display snmp-agent statistics ································································································································ 94
display snmp-agent sys-info·································································································································· 96
display snmp-agent trap-list ·································································································································· 96
display snmp-agent usm-user································································································································ 97
snmp-agent····························································································································································· 98
snmp-agent calculate-password ··························································································································· 99
snmp-agent community ·······································································································································100
snmp-agent group················································································································································101
snmp-agent local-engineid··································································································································103
snmp-agent log ····················································································································································104
snmp-agent mib-view···········································································································································104
snmp-agent packet max-size ······························································································································105
snmp-agent remote ··············································································································································106
snmp-agent sys-info contact································································································································107
snmp-agent sys-info location·······························································································································107
snmp-agent sys-info version ································································································································108
snmp-agent target-host ········································································································································109
snmp-agent trap enable ······································································································································110
snmp-agent trap life·············································································································································111

iii
snmp-agent trap source·······································································································································112
snmp-agent usm-user { v1 | v2c }······················································································································113
snmp-agent usm-user v3······································································································································114
Port mirroring commands ······································································································································· 118
display mirroring-group ······································································································································118
mirroring-group····················································································································································119
mirroring-group mirroring-port (interface view)································································································120
mirroring-group mirroring-port (system view) ···································································································121
mirroring-group monitor-egress··························································································································122
mirroring-group monitor-port (interface view)···································································································123
mirroring-group monitor-port (system view) ······································································································124
mirroring-group reflector-port ·····························································································································125
mirroring-group remote-probe vlan····················································································································126
Index ········································································································································································ 128

1
Ping, tracert, and system debugging
commands
debugging
Use the debugging command to enable debugging for a specific module.
Use the undo debugging command to disable debugging for a specific module.
Syntax
debugging { all [ timeout time ] | module-name [ option ] }
undo debugging { all | module-name [ option ] }
Default
Debugging functions are disabled for all modules.
Views
User view
Predefined user roles
network-admin
Parameters
all: Enables all debugging functions.
timeout time: Specifies the timeout time for the debugging all command. When all debugging is enabled,
the system automatically executes the undo debugging all command after the timeout time.The time
argument is in the range of 1 to 1440 minutes.
module-name: Module name, such as arp or device. To display the current module name, use the
debugging ? command.
option: The debugging option for a specific module. The option number and content differ for different
modules. To display the supported options, use the debugging module-name ?command.
Usage guidelines
Outputting debugging information may degrade system efficiency. H3C recommends that you enable
the debugging for a specific module, rather than multiple modules.
Examples
# Enable debugging for the device management module.
<Sysname> debugging arp status
Related commands
display debugging
display debugging
Use the display debugging command to display the enabled debugging functions.

2
Syntax
display debugging [module-name ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
module-name: Displays the debugging settings of the specified module. To display the current module
name, use the display debugging ? command.
Examples
# Display all enabled debugging functions.
<Sysname> display debugging
ARP status debugging switch is on
Related commands
debugging
display memory
Use the display memory command to display the system memory statistics.
Syntax
display memory [ slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
slot slot-number: Specifies an IRF member device ID. If this option is not specified, the command displays
the memory statistics of all IRF member devices.
Examples
# Display the memory statistics of the device.
<Sysname> display memory
The statistics about memory is measured in KB:
Slot 1:
total used free shared buffers cached
Mem: 2019300 318600 1700700 0 0 84500
-/+ buffers/cache: 234100 1785200
Swap: 0 0 0

3
Table 1 Output description
Field Descri
p
tion
The statistics about memory
is measured in KB: Memory statistics, in KB
Slot ID of the IRF member device
Mem Memory usage information
Total Size of the physical memory
Used Size of the physical memory used
Free Size of the free physical memory
shared Total memory shared by multiple processes
buffers Size of buffers
cached Size of the cache
-/+ buffers/cache -/+ buffers/cache: used = Mem: used – Mem: buffers – Mem: cached
-/+ buffers/cache: free = Mem: used + Mem: buffers + Mem: cached
Swap Swap usage information
display process
Use the display process command to display state information about a process.
Syntax
display process [ all | job job-id | name process-name ] [ slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
all: Displays the state information about all processes.
job job-id: Specifies a job ID that uniquely identifies a process. It remains the same even if the process
restarts. The job-id argument is in the range of 1 to 2147483647.
name process-name: Specifies the process name. It is a case-insensitive string of 1 to 15 characters
without the question mark (?) and space.
slot slot-number: Specifies an IRF member device ID. If this option is not specified, the command displays
state information about processes on the master device.
Examples
# Display state information about the process scmd.
<Sysname> display process name scmd
Job ID: 1
PID: 1

4
Parent JID: 0
Parent PID: 0
Executable path: /sbin/scmd
Instance: 0
Respawn: OFF
Respawn count: 1
Max. spawns per minute: 0
Last started: Wed Jun 1 14:45:46 2011
Process state: sleeping
Max. core: 0
ARGS: -
TID LAST_CPU Stack PRI State HH:MM:SS:MESC Name
1 0 0K 120 S 0:0:5:220 scmd
Table 2 Output description
Field Descri
p
tion
Job ID Job ID that uniquely identifies a process. It remains the same even if the process
restarts.
PID Process ID that identifies a process. It may change when the process restarts.
Parent JID Job ID of a parent process.
Parent PID ID of a parent process.
Executable path Path for the process executable. The path for the kernel process displays as the
hyphen(-).
Instance Instance number of a process. (Whether a process runs multiple instances or not
is predefined.)
Respawn
The field indicates whether the process automatically restarts or not in case of
failure.
•On—The process restarts automatically.
•Off—The process does not restart automatically.
Respawn count Number of times the process has been restarted. (The first start makes the count
1.)
Max. spawns per minute
Maximum number of respawns allowed in 1 minute. If the number is exceeded,
the process automatically stops restarting. To restart the process, use the process
start command.
Last started Date and time the process was last started.
Process state
Process state:
•Running—In running state or waiting in the queue.
•Sleeping—In interruptible sleeping state.
•Traced or stopped—In traced or stopped state.
•Uninterruptible sleep—In uninterruptible sleep state.
•Zombie—In zombie state.
Max. core
Maximum number of core files that the process generates. 0 indicates no core
files are generated. The process generates a core file every time it respawns.
When the number of core files reaches the maximum, no more core files are
generated. Software development and maintenance engineers can locate the
fault and position based on the core files.

5
Field Descri
p
tion
ARGS Command-line arguments passed to the process. If no arguments pass, the
hyphen (-) displays.
TID Thread ID.
LAST_CPU CPU where the process is located in the last assignment.
Stack Stack size.
PRI Thread priority.
State
Thread state:
•R—In running state or waiting in the queue.
•S—In interruptible sleeping state.
•T—In traced or stopped state.
•D—In uninterruptible sleep state.
•Z—In zombie state.
HH:MM:SS:MESC Running time when the process started last time.
Name Process name.
# Display state information about all processes.
<Sysname> display process all
JID USER %CPU %MEM STAT PRI TTY HH:MM:SS COMMAND
1 0 1.7 0.0 S 120 - 00:00:06 scmd
2 0 0.0 0.0 S 115 - 00:00:00 [kthreadd]
3 0 0.0 0.0 S 99 - 00:00:00 [migration/0]
4 0 0.0 0.0 S 115 - 00:00:00 [ksoftirqd/0]
5 0 0.0 0.0 S 99 - 00:00:00 [watchdog/0]
6 0 0.0 0.0 S 99 - 00:00:00 [migration/1]
7 0 0.0 0.0 S 115 - 00:00:00 [ksoftirqd/1]
8 0 0.0 0.0 S 99 - 00:00:00 [watchdog/1]
9 0 0.0 0.0 S 99 - 00:00:00 [migration/2]
10 0 0.0 0.0 S 115 - 00:00:00 [ksoftirqd/2]
11 0 0.0 0.0 S 99 - 00:00:00 [watchdog/2]
12 0 0.0 0.0 S 99 - 00:00:00 [migration/3]
13 0 0.1 0.0 S 115 - 00:00:00 [ksoftirqd/3]
14 0 0.0 0.0 S 99 - 00:00:00 [watchdog/3]
15 0 0.0 0.0 S 99 - 00:00:00 [migration/4]
16 0 0.0 0.0 S 115 - 00:00:00 [ksoftirqd/4]
17 0 0.0 0.0 S 99 - 00:00:00 [watchdog/4]
18 0 0.0 0.0 S 115 - 00:00:00 [events/0]
19 0 0.0 0.0 S 115 - 00:00:00 [events/1]
20 0 0.0 0.0 S 115 - 00:00:00 [events/2]
21 0 0.0 0.0 S 115 - 00:00:00 [events/3]
---- More ----

6
Table 3 Output description
Field Descri
p
tion
JID Job ID that uniquely identifies a process. It remains the same even if the process restarts.
USER Username.
%CPU CPU usage in percentage.
%MEM Memory usage in percentage.
STAT
Process state:
•R—In running state or waiting in the queue.
•S—In interruptible sleeping state.
•T—In traced or stopped state.
•D—In uninterruptible sleep state.
•Z—In zombie state.
PRI Process priority. (The process priority counts in the assignment. The process with top
priority gets assigned earlier than others.)
TTY Terminal used by the process. It displays as the hyphen (-).
HH:MM:SS Running time when the process restarted last time.
COMMAND Process name and its parameters. If the process name is marked with the square brackets
([ ]), it refers to the kernel thread.
display process cpu
Use the display process cpu command to display the CPU usage for all processes.
Syntax
display process cpu [ slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
slot slot-number: Specifies an IRF member device ID. If this option is not specified, the command displays
state information about processes on the master device.
Examples
# Display the CPU usage for all processes.
<Sysname> display process cpu
CPU utilization in 5 secs: 16.8%; 1 min: 4.7%; 5 mins: 4.7%
JID 5Sec 1Min 5Min Name
1 0.0% 0.0% 0.0% scmd
2 0.0% 0.0% 0.0% [kthreadd]
3 0.1% 0.0% 0.0% [ksoftirqd/0]
4 0.0% 0.0% 0.0% [watchdog/0]

7
5 0.0% 0.0% 0.0% [events/0]
6 0.0% 0.0% 0.0% [khelper]
29 0.0% 0.0% 0.0% [kblockd/0]
49 0.0% 0.0% 0.0% [vzmond]
52 0.0% 0.0% 0.0% [pdflush]
53 0.0% 0.0% 0.0% [pdflush]
54 0.0% 0.0% 0.0% [kswapd0]
110 0.0% 0.0% 0.0% [aio/0]
712 0.0% 0.0% 0.0% [mtdblockd]
719 0.0% 0.0% 0.0% [TNetJob]
720 0.0% 0.0% 0.0% [TMTH]
727 0.0% 0.0% 0.0% [CF]
730 0.0% 0.0% 0.0% [DIBC]
752 0.0% 0.0% 0.0% [lipc_topology]
762 0.0% 0.0% 0.0% [MNET]
763 0.0% 0.0% 0.0% [SYSM]
---- More ----
Table 4 Output description
Field Descri
p
tion
CPU utilization in 5 secs: 16.8%;
1 min: 4.7%; 5 mins: 4.7%
CPU usage of the system in the last 5 seconds, in the last I minute, and in the
last 5 minutes.
JID Job ID that uniquely identifies a process. It remains the same even if the
process restarts.
5Sec Display CPU usage in the last 5 seconds.
1Min Display CPU usage in the last I minute.
5Min Display CPU usage in the last 5 minutes.
Name Process name. If the process name is marked with the square brackets ([ ]),
it refers to the kernel thread.
display process log
Use the display process command to display log information about all processes.
Syntax
display process log [ slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
slot slot-number: Specifies an IRF member device ID. If this option is not specified, the command displays
state information about processes on the master device.

8
Examples
# Display log information about all processes.
<Sysname> display process log
Name JID PID Normal-exit Core Start-time End-time
PKEYINIT 832 832 Y N 2010-12-20 09:45:45 2010-12-20 09:45:45
KNPHASE2 837 837 Y N 2010-12-20 09:45:45 2010-12-20 09:45:45
PKGM 834 834 Y N 2010-12-20 09:45:45 2010-12-20 09:45:45
recover 865 865 Y N 2010-12-20 09:45:47 2010-12-20 09:45:48
SSHD 992 992 Y N 2010-12-20 10:08:23 2010-12-20 10:08:23
SSHD 992 993 Y N 2010-12-20 10:08:23 2010-12-20 10:08:23
SSHD 992 994 Y N 2010-12-20 10:08:23 2010-12-20 10:08:23
SSHD 992 995 Y N 2010-12-20 10:08:23 2010-12-20 10:08:23
SSHD 992 996 Y N 2010-12-20 10:08:23 2010-12-20 10:08:23
SSHD 992 997 Y N 2010-12-20 10:08:23 2010-12-20 10:08:24
Table 5 Output description
Field Descri
p
tion
Name Process name
JID Job ID
PID Process ID
Normal-exit
Exit normally or not:
•Y—Yes
•N—No
Core
Generate core files or not:
•Y—Yes
•N—No
Start-time Time when the process starts
End-time Time when the process stops
display process memory
Use the display process memory command to display the memory usage for the code segments, data
segments, and stacks for all processes.
Syntax
display process memory [ slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator

9
Parameters
slot slot-number: Specifies an IRF member device ID. If this option is not specified, the command displays
state information about processes on the master device.
Usage guidelines
When the process starts, it requests text, data, stack, and dynamic memories, where:
•Text memory stores the process codes.
•Data memory stores the process data.
•Stack memory stores temporary data.
•Dynamic memory refers to heap memory. The system dynamically allocates and releases the heap
memory as required by the process. To display detailed information, use the display process
memory heap command.
Examples
#Display the memory usage for all processes.
<Sysname> display process memory
JID Text Data Stack Dynamic Name
1 384 1800 16 36 scmd
2 0 0 0 0 [kthreadd]
3 0 0 0 0 [ksoftirqd/0]
4 0 0 0 0 [watchdog/0]
5 0 0 0 0 [events/0]
6 0 0 0 0 [khelper]
29 0 0 0 0 [kblockd/0]
49 0 0 0 0 [vzmond]
52 0 0 0 0 [pdflush]
---- More ----
Table 6 Output description
Field Descri
p
tion
JID Job ID that uniquely identifies a process. It remains the same even if the process restarts.
Text Size of code segments, in KB. (It displays as 0 for the kernel process.)
Data Size of data segments, in KB. (It displays as 0 for the kernel process.)
Stack Size of stacks, in KB. (It displays as 0 for the kernel process.)
Dynamic Size of the memory dynamically requested by the process, in KB. (It displays as 0 for the
kernel process.)
Name Process name. If the process name is marked with the square brackets ([ ]), it refers to the
kernel thread.
Related commands
•display process memory heap
•display process memory heap address
•display process memory heap size

10
display process memory heap
Use the display process memory heap command to display the heap memory statistics for a specified
process.
Syntax
display process memory heap job job-id [ verbose ] [ slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
job job-id: Specifies a job ID that uniquely identifies a process. It remains the same even if the process
restarts. The job-id argument is in the range 1 to 2147483647.
verbose: Displays detailed statistics about the memory. If this keyword is not specified, brief statistics is
displayed.
slot slot-number: Specifies an IRF member device ID. If this option is not specified, the command displays
the state information about processes on the master device.
Usage guidelines
The heap memory comprises fixed-size memory blocks (such as size=16 bytes or size= 64 bytes), to store
necessary data or intermediate variables. When a process starts, the system dynamically allocates the
heap memory to the process as needed. To display heap memory information about a process, use the
display process memory heap command.
Each memory block has an address represented in hexadecimal numbers. To display the address, use
the display process memory heap size command. You can access the memory block through the address.
To display the memory block, use the display process memory heap address command.
Examples
# Display brief information about the heap memory for job 48.
<Sysname> display process memory heap job 48
Total virtual memory heap space (in bytes) : 2293760
Total physical memory heap space (in bytes) : 58368
Total allocated memory (in bytes) : 42368
# Display detailed information about the heap memory for job 48.
<Sysname> display process memory heap job 48 verbose
Heap usage:
Size Free Used Total Free Ratio
16 8 52 60 13%
64 3 1262 1265 0.2%
128 2 207 209 1%
512 3 55 58 5.1%
4096 3 297 300 1%
8192 1 19 20 5%
81920 0 1 1 0%

11
Summary:
Total virtual memory heap space (in bytes) : 2293760
Total physical memory heap space (in bytes) : 58368
Total allocated memory (in bytes) : 42368
The output shows that job 48 is allocated with 60 blocks each with a size of 16 bytes (52 already used
and 8 available), 1265 blocks each with a size of 64 bytes (1262 used and 3 available), and so on.
Table 7 Output description
Field Descri
p
tion
Total allocated memory
(in bytes) Heap memory space used by the job, in bytes.
Size Size of the memory block, in bytes.
Free Number of the free memory blocks.
Used Number of the used memory blocks.
Total Total number of memory blocks in specified size. It is the number of the free memory
blocks plus the number of the used memory blocks.
Free Ratio
Total number of the memory blocks in specified size divided by the number of the
free memory blocks. It indicates the fragment conditions of the specified memory
blocks.
Related commands
•display process memory
•display process memory heap address
•display process memory heap size
display process memory heap address
Use the display process memory heap address command to check the memory space from a specified
address.
Syntax
display process memory heap job job-id address starting-address length memory-length [ slot
slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
job job-id: Specifies a job ID that uniquely identifies a process. It remains the same even if the process
restarts. The job-id argument is in the range of 1 to 2147483647.
address starting-address: Specifies the starting address of the memory block.
length memory-length: Specifies the memory length. The memory-length argument is in the range of 1 to
1024 bytes.

12
slot slot-number: Specifies an IRF member device ID. If this option is not specified, the command displays
state information about processes on the master device.
Usage guidelines
When the process runs abnormally, use this command to diagnose and locate the failures.
Examples
# Display the memory space with a length of 128 bytes starting from the address 0xb7e30580 in job 1.
<Sysname> display process memory heap job 1 address b7e30580 length 128
B7E30580: 14 00 EF FF 00 00 00 00 E4 39 E2 B7 7C 05 E3 B7 .........9..|...
B7E30590: 14 00 EF FF 2F 73 62 69 6E 2F 73 6C 62 67 64 00 ..../sbin/slbgd.
B7E305A0: 14 00 EF FF 00 00 00 00 44 3B E2 B7 8C 05 E3 B7 ........D;......
B7E305B0: 14 00 EF FF 2F 73 62 69 6E 2F 6F 73 70 66 64 00 ..../sbin/ospfd.
B7E305C0: 14 00 EF FF 00 00 00 00 A4 3C E2 B7 AC 05 E3 B7 .........<......
B7E305D0: 14 00 EF FF 2F 73 62 69 6E 2F 6D 73 74 70 64 00 ..../sbin/mstpd.
B7E305E0: 14 00 EF FF 00 00 00 00 04 3E E2 B7 CC 05 E3 B7 .........>......
B7E305F0: 14 00 EF FF 2F 73 62 69 6E 2F 6E 74 70 64 00 00 ..../sbin/ntpd..
Related commands
•display process memory heap
•display process memory heap size
display process memory heap size
Use the display process memory heap size command to display the address of a memory block in a
specified size.
Syntax
display process memory heap job job-id size memory-size [ offset offset-size ] [ slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
size memory-size: Specifies the size of the memory block.
offset offset-size: Displays the offset of a specified memory block. If this option is not specified, it displays
the addresses of the first 128 memory blocks. For example, the system has allocated 100 memory blocks
with 16 bytes in size to job 1 and the current process is using 66 blocks. If you execute the display
process memory heap job 1size 16 offset 50 command, it displays the addresses of the 51st to the 66th
memory blocks with 16 bytes in size.
job job-id: Specifies a job ID that uniquely identifies a process. It remains the same even if the process
restarts. The job-id argument is in the range of 1 to 2147483647.
slot slot-number: Specifies an IRF member device ID. If this option is not specified, the command displays
the state information about processes on the master device.