ap-trapd(8)

🌸 ap-trapd — bestie's guide to the SNMP trap daemon 🌸

okay so like. hi. you're reading the manual for ap-trapd, which lives in section 8 (System Manager's Manual, so it's a system admin girlie, very demure, very mindful). it's the daemon that sits there catching SNMP traps and writing them down. let's get into it 💅

---

✨ NAME ✨

ap-trapd — a SNMP trap processing daemon 🫶

---

✨ SYNOPSIS ✨

ap-trapd [ -i device ] [-u user ] [-s]

---

✨ DESCRIPTION ✨

okay so ap-trapd is a SNMP trap processing daemon, no cap. it accepts traps, parses them, and stores the useful data using syslog at logging LEVEL0. that's the whole personality.

you can specify device to listen for SNMP traps on that particular device — and heads up bestie, this option only works on Linux. 🐧

if you wanna be running as a user that isn't nobody, you may specify user.

to correct work with Smartbridges APs you gotta specify the -s key, because they use specific traps (they're ✨special✨ like that).

this utility was added to ap-utils from version 0.8. iconic behavior honestly.

---

✨ SYSLOG ✨

so if you want to store traps in their own log file, you may add this next string to your /etc/syslog.conf:

local0.*       /var/log/ap-traps.log

after doing it, just restart syslogd with a command like:

killall -HUP syslogd

and boom, you're logging 🎀

---

✨ TRAPS ✨

when a trap is received, a message will be logged indicating that an action happened to the Access Point, such as:

• Trap Reassociation: — this trap message is sent when a Station reassociation request is received from Access Point.
• Trap Association: — indicates the reception of an association request packet and the sender Station's successful association with the Access Point.
• Trap Disassociation: — this trap message is sent when a disassociation notification packet is received from a Station.
• Trap Reset: — this trap message is sent when Access Point Resets.
• Trap Setting IP Address with Ping: — this trap message is sent when the Access Point IP address is set with the transmission of a ping message.
• Trap Start Up: — this trap message is sent when the Access Point Starts Up.
• Trap Failed To Erase Flash: — this trap message is sent when Access Point Failed To Erase Flash.
• APClientScanning — Access Point Client is scanning...
• APClientAuthenticating — Access Point Client is authenticating with the AP.
• APClientAssociating — Access Point Client is associating with the AP.
• APClientReAssociating — Access Point Client is reassociating with the AP.
• APClientAuthenticationFailed — Access Point Client has failed authenticating with the AP.
• APClientAssociationFailed — Access Point Client has failed associating with the AP.
• APClientConnected — Access Point Client has been connected with the AP.
• APClientDisconnected — Access Point Client has been disconnected from the AP.
• APClientScanFailed — Access Point Client has failed scanning!
• APClientJoinFailed — Access Point Client has failed joining!
• APClientJoining — Access Point Client is in join state.

---

💜 Smartbridges specific TRAPS 💜

• MultiAttachedStation — Multiple attached stations in the ethernet size

---

🔐 SECURITY 🔐

bestie, listen. this one matters.

Utility ap-trapd must be running by root. after opening the port, the utility changes owner to nobody, so this user must exist in your system. like, fr fr, it has to be there.

you may set the user using the -u option as described below, to change the default unprivileged user.

---

👑 AUTHOR 👑

Roman Festchook <roma@polesye.net> http://ap-utils.polesye.net

---

🌈 SEE ALSO 🌈

ap-config(8), ap-mrtg(8), syslogd(8)

---

aaaand that's the whole page 💖 this came to you straight out of the Wireless Access Point Utilities for Unix era, and yes, the manual name on the bottom of every page is still ap-trapd(8), as it should be. go forth and trap responsibly, bestie 🦋✨