VxWorks Reference Manual : Libraries

smMemShow

NAME

smMemShow - shared memory management show routines (VxMP Option)

ROUTINES

smMemShow( ) - show the shared memory system partition blocks and statistics (VxMP Option)

DESCRIPTION

This library provides routines to show the statistics on a shared memory system partition.

General shared memory management routines are provided by smMemLib.

CONFIGURATION

The routines in this library are included by default if INCLUDE_SM_OBJ is defined in configAll.h.

AVAILABILITY

This module is distributed as a component of the unbundled shared memory objects support option, VxMP.

INCLUDE FILES

smLib.h, smObjLib.h, smMemLib.h

SEE ALSO

smMemShow, smMemLib, VxWorks Programmer's Guide: Shared Memory Objects


Libraries : Routines

smMemShow( )

NAME

smMemShow( ) - show the shared memory system partition blocks and statistics (VxMP Option)

SYNOPSIS

void smMemShow
    (
    int type /* 0 = statistics, 1 = statistics & list */
    )

DESCRIPTION

This routine displays the total amount of free space in the shared memory system partition, including the number of blocks, the average block size, and the maximum block size. It also shows the number of blocks currently allocated, and the average allocated block size.

If type is 1, it displays a list of all the blocks in the free list of the shared memory system partition.

WARNING

This routine locks access to the shared memory system partition while displaying the information. This can compromise the access time to the partition from other CPUs in the system. Generally, this routine is used for debugging purposes only.

EXAMPLE

   -> smMemShow 1

   FREE LIST:
     num    addr       size
     --- ---------- ----------
       1   0x4ffef0        264
       2   0x4fef18       1700


   SUMMARY:
       status        bytes    blocks   ave block  max block
   --------------- --------- -------- ---------- ----------
           current
              free      1964        2        982       1700
             alloc      2356        1       2356         -
        cumulative
             alloc      2620        2       1310         -
   value = 0 = 0x0

AVAILABILITY

This routine is distributed as a component of the unbundled shared memory objects support option, VxMP.

RETURNS

N/A

SEE ALSO

smMemShow, windsh, Tornado User's Guide: Shell