VxWorks API Reference : OS Libraries

distIfShow

NAME

distIfShow - distributed objects interface adapter show routines (VxFusion option)

ROUTINES

distIfShow( ) - display information about the installed interface adapter (VxFusion option)

DESCRIPTION

This library provides a show routine for displaying information about the installed interface adapter.

AVAILABILITY

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

INCLUDE FILES

distIfLib.h

SEE ALSO

distStatLib


OS Libraries : Routines

distIfShow( )

NAME

distIfShow( ) - display information about the installed interface adapter (VxFusion option)

SYNOPSIS

STATUS distIfShow (void)

DESCRIPTION

This routine displays information about the installed interface adapter. It displays the configuration parameters, as well as some statistical data.

EXAMPLE

-> distIfShow
Interface Name                 : "UDP adapter"
MTU                            : 1500
Network Header Size            : 14
SWP Buffer                     : 32
Maximum Number of Fragments    : 10
Maximum Length of Packet       : 14860 
Broadcast Address              : 0x930b26ff

Telegrams received             : 23
Telegrams received for sending : 62
Incoming Telegrams discarded   : 0
Outgoing Telegrams discarded   : 0
In this example, the installed interface adapter has the name "UDP adapter." The largest telegram that can be transmitted without fragmentation is 1500 bytes long. The network header requires fourteen (14) of those bytes; therefore the largest amount of user data that can be transmitted without fragmentation is 1486 bytes. The sliding window protocol's buffer has 32 entries, which results in a window of size 16. The number of fragments that the packet can be broken into is limited by the size of the sequence field in the network header. The example interface adapter can handle up to 10 fragments, which results in a maximum packet length of 14860 ((1500 - 14) * 128) bytes. The broadcast address of this driver is 0x930b26ff (147.11.38.255). The last four lines of output show statistical data.

AVAILABILITY

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

RETURNS

OK, or ERROR if there is no interface installed.

SEE ALSO

distIfShow