VxWorks Reference Manual : Libraries

smObjShow

NAME

smObjShow - shared memory objects show routines (VxMP Option)

ROUTINES

smObjShow( ) - display the current status of shared memory objects (VxMP Option)

DESCRIPTION

This library provides routines to show shared memory object statistics, such as the current number of shared tasks, semaphores, message queues, etc.

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

smObjLib.h

SEE ALSO

smObjShow, smObjLib, VxWorks Programmer's Guide: Shared Memory Objects


Libraries : Routines

smObjShow( )

NAME

smObjShow( ) - display the current status of shared memory objects (VxMP Option)

SYNOPSIS


STATUS smObjShow ()

DESCRIPTION

This routine displays useful information about the current status of shared memory objects facilities.

WARNING

The information returned by this routine is not static and may be obsolete by the time it is examined. This information is generally used for debugging purposes only.

EXAMPLE

    -> smObjShow
    Shared Mem Anchor Local Addr: 0x600.
    Shared Mem Hdr Local Addr:    0xb1514.
    Attached CPU :                5
    Max Tries to Take Lock:       1


    Shared Object Type    Current    Maximum  Available
    -------------------- ---------- --------- ----------
    Tasks                         1        20         19
    Binary Semaphores             8        30         20
    Counting Semaphores           2        30         20
    Messages Queues               3        10          7
    Memory Partitions             1         4          3
    Names in Database            16       100         84

AVAILABILITY

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

RETURNS

OK, or ERROR if no shared memory objects are initialized.

ERRNO

 S_smObjLib_NOT_INITIALIZED
 S_smLib_NOT_ATTACHED

SEE ALSO

smObjShow, smObjLib