show memory

---

Displays memory usage information for the specified server or module.

Syntax: show memory {server server-id | bay [1|2] | module bay/slot} [verbose | group [group-name] | bucket-size [bucket-size]]

server server-id	Display memory information for the specified server. Valid values are 1 or 2.
bay [1|2]	Display memory information for the specified bay controller.
module bay/slot	Display memory information for the specified module.
group group -name	Display memory information for all functional groups or the specified functional group.
verbose	Display detailed information.
bucket-size bucket-size	Display memory information by bucket-size, or for all bucket-sizes.

Description: Use the show memory server server-id command to display memory usage for the specified server.

Use the show memory bay bay-id command to display memory usage for the specified bay controller.

Use the show memory module bay/slot command to display memory usage for the specified module.

Use the verbose keyword to display more detailed memory usage information.

Use the group keyword to display memory usage by individual functions (groups).

Use the group group-name keyword to display memory usage for the specified group-name.

IPriori divides memory into buckets. Use the bucket-size keyword to show memory by bucket size.

Use the bucket-size bucket-size keyword to display memory usage for the specified bucket size.

Default: None.

Command mode: Privileged.

Example 1: In the following example the show memory server 1 command displays memory usage for server 1:

router#show memory server 1 Memory stats Total bytes 2089426944 Allocated bytes 370307156 Free bytes 1719119788 Free Pages 138978 Page Size 12288 Max Free Block 1641394176 Router1_S1#

The following table describes the fields in the display:

Table 3-20. Fields Displayed by show memory server 

Field	Description
Total bytes	The total amount of dynamic memory available on the platform.
Allocated bytes	The amount of dynamic memory that is currently being used by applications on the platform.
Free bytes	The amount of dynamic memory that is available for applications on the platform.
Free Pages	Number of pages that are available on the platform.
Page Size	Number of contiguous bytes that constitute a page.
Max Free Block	The largest number of contiguous bytes that are available on the platform.

Example 2: In the following example, the show memory server 1 verbose command displays detailed information for server 1:

router#show mem server 1 verbose Total Managed Memory: Start End Size Used Free 0x1fb2000 0x135ff000 291819520 37765576 254053944 Regular Memory: Start End Size Pages 0x1fb2000 0x10df9000 249851904 60999 Free: Total Bytes Bytes In Buckets Pages 249118280 1580616 60434 Used: Total Bytes Bytes In Use Fragmentation Pages 733624 724944 8680 565 Large Memory: Start End Size Pages 0x10df9000 0x135ff000 41967616 10246 Free: Total Bytes Blocks AvgBlockSize Max Block 4935664 8 616958 2692832 Used: Total Bytes Blocks AvgBlockSize Overhead 37031952 1175 31516 9448

The following table describes the fields in the display:

Table 3-21. Fields Displayed by show memory server verbose  

Field	Description
Total Managed Memory	Amount of memory that can be used by processes.
Start	The starting physical address of the memory pool.
End	The ending physical address of the memory pool.
Size	The size of the memory pool in bytes.
Used	The amount used memory.
Free	The amount available memory.
Regular Memory	Memory pool that services memory requests less than a page size.
Free	Statistics on available memory in the regular size memory pool.
Pages	The size of the memory pool in pages.
BytesInBucket	Number of bytes assigned to pages but have not yet been allocated. If this value is very high and the number of pages is very low, then this is a good indication that memory has been fragmented.
TotalBytes	Available memory. (Total Bytes = Free Pages * Page Size + BytesInBucket).
Used	Statistics on used memory in the regular size memory pool.
Pages	The size of the memory pool in pages.
BytesInUse	Bytes that have been assigned to pages and are currently in use.
PageEnd Fragmentation	Bytes used due to page ending fragmentation. Page ending fragmentation occurs when the block size of the page is not an even multiple of the page size.
TotalBytes	The total amount of used bytes in the regular memory pool.
Large Memory	Memory pool that services memory requests larger than a page size.
Free	Statistics on available memory in the large size memory pool.
Blocks	The number of contiguous byte regions (block) that are unused.
AvgBlockSize	The average size of the blocks.
MaxBlock	The largest unused block.
Used	Statistics on used memory in the large size memory pool.
Overhead	The amount of bytes used to store internal information on each block.

Example 3: Memory allocation is labeled by tags. Tags are associated into groups. The following example shows partial output of the show memory server 1 group command, and displays memory allocation arranged by group:

router#show memory server 1 group Memory tag usage tag inUse maxUsed elemInUse maxElemUsed group_name tag_name 0 94304 98400 617 661 avmalloc avm_internal 1 0 0 0 0 avmalloc avm_realloc . . . 325 1104 1104 3 3 selena insert_co_event 326 48 96 1 2 routing ospf_lsa_1_48

The following table describes the fields in the display:

Table 3-22. Fields Displayed by show memory server n group  

Field	Description
tag	Numerical identifier within the group.
inUse	Number of bytes of memory in use by this tag.
maxUsed	The maximum amount of memory ever used by this tag.
elemInUse	Number of elements associated with this tag that are in use.
maxElemUsed	Maximum number of elements associated with this tag ever in use.
group_name	Name of group.
tag_name	Name of tag.

Example 4: A bucket is a piece of the memory pool. In the following example, the show memory server 1 bucket command displays memory usage by general purpose buckets:

router #show memory server 1 bucket Bucket size inUse free maxUsed lowMark highMark pages fullPages tag 0 8 298 2774 344 2560 5120 6 0 1 16 314 1478 314 1280 2560 7 0 2 24 149 871 149 850 1700 6 0 3 32 49 719 59 640 1280 6 0 4 40 81 531 81 510 1020 6 0 5 48 50 460 51 425 850 6 0

The following table describes the fields in the display:

Table 3-23. Fields Displayed by show memory server n bucket  

Field	Description
Bucket tag	Numerical identifier of the bucket.
size	Number of bytes per element in this bucket.
inUse	Number of elements in use in this bucket.
free	Number of free elements in this bucket.
maxUsed	Maximum number of elements ever in use in this bucket.
lowMark	Low threshold number of elements maintained in this bucket.
highMark	High threshold number of elements maintained in this bucket.
pages	Number of memory pages assigned to this bucket.
fullPages	Number of full pages assigned (not allocated) to this bucket.

Related Commands: show bay
show modules
show server
show version

Copyright © 2005 Avici Systems Inc.
Avici® and TSR® is a registered trademark of Avici Systems Inc.
IPriori™, Composite Links™, SSR™, QSR, and NSR® are trademarks of Avici Systems Inc.

   Source File Name: sys_mgmt.fm
    HTML File Name: sys_mgmt49.html
    Last Updated: 02/25/05 at 14:26:49

Please email suggestions and comments to: doc@avici.com