SNMP::Info::AMAP(3pm)

👑 SNMP::Info::AMAP — the vibe

okay bestie, gather round, because we're talking about SNMP::Info::AMAP(3pm) — a page from the User Contributed Perl Documentation set. It's the SNMP interface to the Alcatel Mapping Adjacency Protocol</alcatel>… wait, AMAP. Let's go. 💅

---

✨ NAME ✨

SNMP::Info::AMAP — your SNMP interface to the Alcatel Mapping Adjacency Protocol (AMAP). 🦋

🌸 AUTHOR 🌸

Eric Miller. (thank you king, we stan 🫶)

---

⭐ SYNOPSIS ⭐

here's the whole thing, verbatim, take it in:

my $amap = new SNMP::Info (
                            AutoSpecify => 1,
                            Debug       => 1,
                            DestHost    => 'router',
                            Community   => 'public',
                            Version     => 2
                          );

my $class = $amap->class();
print " Using device sub class : $class\n";

$hasamap   = $amap->hasAMAP() ? 'yes' : 'no';

# Print out a map of device ports with AMAP neighbors:
my $interfaces    = $amap->interfaces();
my $amap_if       = $amap->amap_if();
my $amap_ip       = $amap->amap_ip();
my $amap_port     = $amap->amap_port();

foreach my $amap_key (keys %$amap_ip){
   my $iid           = $amap_if->{$amap_key};
   my $port          = $interfaces->{$iid};
   my $neighbor      = $amap_ip->{$amap_key};
   my $neighbor_port = $amap_port->{$amap_key};
   print "Port : $port connected to $neighbor / $neighbor_port\n";
}

look at her go 😭 she's mapping neighbors and everything.

---

💖 DESCRIPTION 💖

So. SNMP::Info::AMAP is a subclass of SNMP::Info, and what it does is give you an object oriented interface to Alcatel Mapping Adjacency Protocol (AMAP) info, pulled straight over SNMP. slay.

AMAP is a Layer 2 protocol — basically a network device gets to flex and advertise its identity and capabilities on the local network, which hands you topology information. it's giving "hey everyone, this is me, here's what I can do." iconic.

⚠️ real talk though: you're supposed to create or use a device subclass that inherits this class. Do not use directly. periodt. 🙈

🎀 Inherited Classes 🎀

None. nothing inherited, she's self-made. main character energy.

🧚 Required MIBs 🧚

• ALCATEL-IND1-INTERSWITCH-PROTOCOL-MIB

you need this one, no cap. 💜

---

🔥 GLOBALS 🔥

these are methods that return scalar values from SNMP:

• $amap->hasAMAP() — is AMAP actually active on this device? 👀

---

🍓 TABLE METHODS 🍓

these return tables of information in the form of a reference to a hash. data, but make it a hashref. ✨

• $amap->amap_id() — returns the string value used to identify the remote system. who is she? 💅
• $amap->amap_if() — returns the mapping to the SNMP Interface Table.
• $amap->amap_ip() — returns remote IPv4 addresses. and now the important bit, listen up bestie: AMAP returns all IP addresses associated with the remote device. It would be preferable to include only one address since they should all originate from the same device, but amap_ip() can not determine if all addresses are reachable from the network management application. therefore all addresses are returned, and the calling application must determine which address to use and if they are in fact from the same device. so like, do your own vibe check on the addresses, okay? 😭
• $amap->amap_port() — returns remote port ID.
• $amap->amap_platform() — returns remote platform ID.

---

and that's the whole page, no skips, no cuts. 🫶

this lil writeup is from perl v5.40.1, dated 2026-02-28, and it's SNMP::Info::AMAP(3pm) — go forth and map those adjacencies. bye bestie, mwah 💖💅