svPortMonConst(2MON)

NAME | SYNOPSIS | API RESTRICTIONS | FEATURES | DESCRIPTION | PARAMETERS | RETURN VALUES | ATTRIBUTES | SEE ALSO

NAME

svPortMonConst- retrieve port monitoring constant values

SYNOPSIS

#include <mon/chMon.h>

int svPortMonConst(MonPortConst *constants, int size);

API RESTRICTIONS

The function or functions documented here may not be used safely in all application contexts with all APIs provided in the ChorusOS 5.0 product.

See API(5FEA) for details.

FEATURES

MON

DESCRIPTION

The svPortMonConst() microkernel call fills the MonPortConst structure pointed to by the constants parameter. The size parameter must be set to sizeof(MonPortConst). It is provided for compatibility between different releases of the microkernel.

PARAMETERS

The members of the MonPortConst structure are the following:

int   prtName_offset;
int   prtName_sizeof;
int   prtLid_offset;

They specify monitoring constants related to ports, and important offsets which detail the layout of the MonPortState structure (the MonPortState structure gives the internal representation of a port within the microkernel data space, see svPortProbeConnect(2MON)).

The prtName_offset member is the offset of the string representing the name of the port. The prtName_sizeof member is the space reserved for the name. The prtLid_offset member is the offset of the local identifier of the port.

The semantics of the members of the MonPortConst structure is summarized by the following lines of pseudocode:

MonPortState*   portState;
char            (portState + prtName_offset) [prtName_sizeof];
int*            (portState + prtLid_offset);

The special K_ENOTIMP value indicates that the corresponding offset or constant does not apply to this particular release of the microkernel.

RETURN VALUES

The return value is set to the size in bytes of the MonPortConst object.

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Interface Stability	Evolving

SEE ALSO

svSiteMonConst(2MON), svActorMonConst(2MON), svThreadMonConst(2MON), svPortProbeConnect(2MON)

ChorusOS 5.0  Last Revised December 2001

NAME | SYNOPSIS | API RESTRICTIONS | FEATURES | DESCRIPTION | PARAMETERS | RETURN VALUES | ATTRIBUTES | SEE ALSO