Alias Mapping Table Functions

The entAliasMappingTable contains zero or more rows that represent mappings of logical entity and physical entities for ports to external MIB identifiers. Each physical port in the system can be associated with a mapping to an external identifier. The external identifier is associated with a particular logical entity's naming scope. A wildcard mechanism is provided to indicate that an identifier is associated with more than one logical entity.

The following functions are for use with the entAliasMappingTable in the Entity MIB:

• addAliasMappingTableEntry()

• deleteAliasMappingTableEntry()

• deleteAliasMappingLogicalIndex()

• deleteAliasMappingPhysicalIndex()

addAliasMappingTableEntry()

Synopsis

extern int addAliasMappingTableEntry(int xentPhysicalIndex, int xentLogicalIndex, oid* xAliasMapId, int xAliasMapIdSize);

Description

Adds an entry to the entAliasMappingTable with the xentPhysicalIndex as the primary index and xentLogicalIndex as the secondary index. xAliasMapId is the alias (OID) for the entry and xAliasMapIdSize is the size in bytes of xAliasMapId.

Note that if entAliasMapId = NULL, the request is rejected.

Returns

0

for successful addition.

1

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

-1

for failure.

-2

for stale entry.

deleteAliasMappingTableEntry()

Synopsis

extern int deleteAliasMappingTableEntry(int xentPhysicalIndex, int xentLogicalIndex);

Description

Deletes the entry in the entAliasMappingTable that has xentPhysicalIndex as the primary index and xentLogicalIndex as the secondary index.

Returns

0

for successful deletion.

-1

for entry not found.

-2

for stale entry.

deleteAliasMappingLogicalIndex()

Synopsis

extern int deleteAliasMappingLogicalIndex(int xentLogicalIndex);

Description

Deletes all entries of the entAliasMappingTable that have xentLogicalIndex as the secondary index.

This function cannot be used to delete all indexes that have an xentLogicalIndex of zero. Use the deleteAliasMappingTableEntry() function to delete such entries one at a time, with the appropriate xentPhysicalIndex specified.

Returns

number

of entries successfully deleted.

-1

for entry not found.

-2

for stale logical entry.

deleteAliasMappingPhysicalIndex()

Synopsis

extern int deleteAliasMappingPhysicalIndex(int xentPhysicalIndex);

Description

Deletes all entries in the entAliasMappingTable whose primary index matches the specified xentPhysicalIindex.

Returns

number

of entries successfully deleted.

–1

for entry not found.

–2

for stale physical entry.