LP Mapping Table Functions

The entLPMappingTable contains zero or more rows that associate logical entities to physical equipment. For each logical entity that is known by this agent, there are zero or more mappings to the physical resources that are used to realize that logical entity. An agent should limit the number and nature of entries in this table so that only meaningful and non-redundant information is returned. See the /etc/sma/snmp/mibs/ENTITY-MIB.txt file for more information about the entLPMappingTable.

The following functions are for use with the entLPMappingTable:

• addLPMappingTableEntry()

• deleteLPMappingTableEntry()

• deleteLPMappingLogicalIndex()

• deleteLPMappingPhysicalIndex()

addLPMappingTableEntry()

Synopsis

extern int addLPMappingTableEntry(int xentLogicalIndex, int xentPhysicalIndex );

Description

Adds an entry to the entLPMappingTable with the xentLogicalIndex as the primary index and xentPhysicalIndex as the secondary index.

Returns

0

for successful addition.

1

if the entry already exists for the given xentPhysicalIndex and xentLogicalIndex.

-1

for failure to add.

-2

for stale index.

deleteLPMappingTableEntry()

Synopsis

extern int deleteLPMappingTableEntry(int xentLogicalIndex, int xentPhysicalIndex );

Description

Deletes the entry of the LP Mapping table that uses the specified xentLogicalIndex as the primary index and xentPhysicalIndex as the secondary index.

Returns

0

for successful deletion.

-1

for failure to delete.

-2

for stale entry, either logical index or physical index, or both.

deleteLPMappingLogicalIndex()

Synopsis

extern int deleteLPMappingLogicalIndex(int xentLogicalIndex);

Description

Deletes all the entries of the entLPMappingTable that have the xentLogicalIndex as the primary index.

Returns

number

of successfully deleted entries.

-1

for failure.

-2

for stale logical entry.

deleteLPMappingPhysicalIndex()

Synopsis

extern int deleteLPMappingPhysicalIndex(int xentPhysicalIndex);

Description

Deletes all the entries of the entLPMappingTable that have xentPhysicalIndex as the secondary index.

Returns

number

of successfully deleted entries.

–1

if no entry was deleted.

-2

for stale physical entry.