H3C S5830V2 series Command Reference 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

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, , H

3

Care, , TOP G, , IRF, NetPilot, Neocean, NeoVTL,

SecPro, SecPoint, SecEngine, SecPath, Comware, Secware, Storware, NQA, VVG, V

2

G, V

n

G, 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 info@h3c.com.

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

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 1 size 16 offset 50 command, it displays the addresses of the 51

st

to the 66

th

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.

Page is loading ...

H3C S5830V2 series Command Reference Manual

This manual is also suitable for

H3C S5830V2 series Command Reference Manual

Related papers

Other documents