close

keyboard_arrow_left

Table of Contents Expand all

list Table of Contents

English

show system virtual-memory

date_range 19-Nov-23

arrow_backward

arrow_forward

Syntax

content_copy zoom_out_map
show system virtual-memory

Syntax (EX Series)

content_copy zoom_out_map
show system virtual-memory
<all-members>
<local>
<member member-id> 

Syntax (TX Matrix Router)

content_copy zoom_out_map
show system virtual-memory 
<all-chassis | all-lcc | lcc number | scc> 

Syntax (TX Matrix Plus Router)

content_copy zoom_out_map
show system virtual-memory
<all-chassis | all-lcc | lcc number | sfc number> 

Syntax (MX Series Router)

content_copy zoom_out_map
show system virtual-memory
<all-members>
<local>
<member member-id> 

Syntax (QFX Series)

content_copy zoom_out_map
show system virtual-memory
<infrastructure name>
<interconnect-device name>
<node-group name> 

Syntax (Junos OS Evolved)

content_copy zoom_out_map
show system virtual-memory
<node node-name> 

Description

Display the usage of Junos OS kernel memory listed first by size of allocation and then by type of usage. Use the show system virtual-memory command for troubleshooting with Juniper Networks Customer Support.

Options

none	Display kernel dynamic memory usage information.
all-chassis	(TX Matrix routers and TX Matrix Plus routers only) (Optional) Display kernel dynamic memory usage information for all chassis.
all-lcc	(TX Matrix routers and TX Matrix Plus routers only) (Optional) On a TX Matrix router, display kernel dynamic memory usage information for all T640 routers connected to the TX Matrix router. On a TX Matrix Plus router, display kernel dynamic memory usage information for all connected T1600 or T4000 LCCs.
all-members	(EX4200 switches and MX Series routers only) (Optional) Display kernel dynamic memory usage information for all members of the Virtual Chassis configuration.
infrastructure `name`	(QFabric systems only) (Optional) Display kernel dynamic memory usage information for the fabric control Routing Engine and fabric manager Routing Engine.
interconnect-device `name`	(QFabric systems only) (Optional) Display kernel dynamic memory usage information for the Interconnect device.
lcc `number`	(TX Matrix routers and TX Matrix Plus routers only) (Optional) On a TX Matrix router, display kernel dynamic memory usage information for a specific T640 router that is connected to the TX Matrix router. On a TX Matrix Plus router, display kernel dynamic memory usage information for a specific router that is connected to the TX Matrix Plus router. Replace `number` with the following values depending on the LCC configuration: 0 through 3, when T640 routers are connected to a TX Matrix router in a routing matrix. 0 through 3, when T1600 routers are connected to a TX Matrix Plus router in a routing matrix. 0 through 7, when T1600 routers are connected to a TX Matrix Plus router with 3D SIBs in a routing matrix. 0, 2, 4, or 6, when T4000 routers are connected to a TX Matrix Plus router with 3D SIBs in a routing matrix.
local	(EX4200 switches and MX Series routers only) (Optional) Display kernel dynamic memory usage information for the local Virtual Chassis member.
member `member-id`	(EX4200 switches and MX Series routers only) (Optional) Display kernel dynamic memory usage information for the specified member of the Virtual Chassis configuration. For EX4200 switches, replace `member-id` with a value from 0 through 9. For an MX Series Virtual Chassis, replace `member-id` with a value of 0 or 1.
`node node-name`	(Junos OS Evolved only) (Optional) Display the kernel memory information for the specified node. If no node is specified, information is displayed for all nodes.
node-group `name`	(QFabric systems only) (Optional) Display kernel dynamic memory usage information for the Node group.
scc	(TX Matrix routers only) (Optional) Display kernel dynamic memory usage information for the TX Matrix router (or switch-card chassis).
sfc `number`	(TX Matrix Plus routers only) (Optional) Display kernel dynamic memory usage information for the TX Matrix Plus router. Replace `number` with 0.

Additional Information

By default, when you issue the show system virtual-memory command on the primary Routing Engine of a TX Matrix router or a TX Matrix Plus router, the command is broadcast to all the primary Routing Engines of the LCCs connected to it in the routing matrix. Likewise, if you issue the same command on the backup Routing Engine of a TX Matrix or a TX Matrix Plus router, the command is broadcast to all backup Routing Engines of the LCCs that are connected to it in the routing matrix.

Note:

The show system virtual-memory command with the | display XML pipe option now displays XML output for the command in the parent tags: <vmstat-memstat-malloc>, <vmstat-memstat-zone>, <vmstat-sumstat>, <vmstat-intr>, and <vmstat-kernel-state> with each child element as a separate XML tag. In Junos OS Releases 10.1 and earlier, the | display XML option for this command does not have an XML API element and the entire output is displayed in a single <output> tag element.

kernel direct memory map only displays for the 64-bit platform.

Required Privilege Level

view

Output Fields

Table 1 lists the output fields for the show system virtual-memory command. Output fields are listed in the approximate order in which they appear.

Table 1: show system virtual-memory Output Fields
Field Name	Field Description
Memory statistics by bucket size
`Size`	Memory block size (bytes). The kernel memory allocator appropriates blocks of memory whose size is exactly a power of 2.
`In Use`	Number of memory blocks of this size that are in use (bytes).
`Free`	Number of memory blocks of this size that are free (bytes).
`Requests`	Number of memory allocation requests made.
`HighWater`	Maximum value the free list can have. Once the system starts reclaiming physical memory, it continues until the free list is increased to this value.
`Couldfree`	Total number of times that the free elements for a bucket size exceed the high-water mark for that bucket size.
Memory usage type by bucket size
`Size`	Memory block size (bytes).
`Type(s)`	Kernel modules that are using these memory blocks. For a definition of each type, refer to a FreeBSD book.
Memory statistics by type
`Type`	Kernel module that is using dynamic memory.
`InUse`	Number of memory blocks used by this type. The number is rounded up.
`MemUse`	Amount of memory in use, in kilobytes (KB).
`HighUse`	Maximum memory ever used by this type.
`Limit`	Maximum memory that can be allocated to this type.
`Requests`	Total number of dynamic memory allocation requests this type has made.
`Type Limit`	Number of times requests were blocked for reaching the maximum limit.
`Kern Limit`	Number of times requests were blocked for the kernel map.
`Size(s)`	Memory block sizes this type is using.
Memory Totals
`In Use`	Total kernel dynamic memory in use (bytes, rounded up).
`Free`	Total kernel dynamic memory free (bytes, rounded up).
`Requests`	Total number of memory allocation requests.
`ITEM`	Kernel module that is using memory.
`Size`	Memory block size (bytes).
`Limit`	Maximum memory that can be allocated to this type.
`Used`	Number of memory blocks used by this type. The number is rounded up.
`Free`	Number of memory blocks available to this type.
`Requests`	Total number of memory allocation requests this type has made.
`interrupt`	Timer events and scheduling interruptions.
`total`	Total number of interruptions for each type.
`rate`	Interruption rate.
`Total`	Total for all interruptions.

Sample Output