VxWorks API Reference : OS Libraries

distNameShow

NAME

distNameShow - distributed name database show routines (VxFusion option)

ROUTINES

distNameShow( ) - display the entire distributed name database (VxFusion option)
distNameFilterShow( ) - display the distributed name database filtered by type (VxFusion option)

DESCRIPTION

This library provides routines for displaying the contents of the distributed name database.

AVAILABILITY

This module is distributed as a component of the unbundled distributed message queues option, VxFusion.

INCLUDE FILES

distNameLib.h

SEE ALSO

distNameLib

---

OS Libraries : Routines

distNameShow( )

NAME

distNameShow( ) - display the entire distributed name database (VxFusion option)

SYNOPSIS

void distNameShow (void)

DESCRIPTION

This routine displays the entire contents of the distributed name database. The data displayed includes the symbolic ASCII name, the type, and the value. If the type is not pre-defined, it is printed in decimal and the value shown in a hexdump.

NOTE

Option VX_FP_TASK should be set when spawning any task in which distNameShow( ) is called unless it is certain that no floating point values will be in the database. The target shell has this option set.

EXAMPLE

-> distNameShow()
        NAME              TYPE               VALUE
-------------------- -------------- -------------------------
nile                    T_DIST_NODE 0x930b2617 (2466981399)
columbia                T_DIST_NODE 0x930b2616 (2466981398)
dmq-01                 T_DIST_MSG_Q 0x3ff9fb
dmq-02                 T_DIST_MSG_Q 0x3ff98b
dmq-03                 T_DIST_MSG_Q 0x3ff94b
dmq-04                 T_DIST_MSG_Q 0x3ff8db
dmq-05                 T_DIST_MSG_Q 0x3ff89b
gData                          4096 0x48 0x65 0x6c 0x6c 0x6f 0x00 
gCount                T_DIST_UINT32 0x2d (45)
grp1                   T_DIST_MSG_Q 0x3ff9bb
grp2                   T_DIST_MSG_Q 0x3ff90b
value = 0 = 0x0

AVAILABILITY

This routine is distributed as a component of the unbundled distributed message queues option, VxFusion.

RETURNS

N/A

SEE ALSO

distNameShow

---

OS Libraries : Routines

distNameFilterShow( )

NAME

distNameFilterShow( ) - display the distributed name database filtered by type (VxFusion option)

SYNOPSIS

void distNameFilterShow
    (
    DIST_NAME_TYPE type       /* type to filter the database by */
    )

DESCRIPTION

This routine displays the contents of the distributed name database filtered by type. The data displayed includes the symbolic ASCII name, the type, and the value. If the type is not pre-defined, it is printed in decimal and the value shown in a hexdump.

NOTE

Option VX_FP_TASK should be set when spawning any task in which distNameFilterShow( ) is called unless it is certain that no floating point values will be displayed. The target shell has this option set.

EXAMPLE

-> distNameFilterShow(0)
        NAME              TYPE               VALUE
-------------------- -------------- -------------------------
dmq-01                 T_DIST_MSG_Q 0x3ff9fb
dmq-02                 T_DIST_MSG_Q 0x3ff98b
dmq-03                 T_DIST_MSG_Q 0x3ff94b
dmq-04                 T_DIST_MSG_Q 0x3ff8db
dmq-05                 T_DIST_MSG_Q 0x3ff89b
grp1                   T_DIST_MSG_Q 0x3ff9bb
grp2                   T_DIST_MSG_Q 0x3ff90b
value = 0 = 0x0

AVAILABILITY

This routine is distributed as a component of the unbundled distributed message queues option, VxFusion.

RETURNS

N/A

SEE ALSO

distNameShow