AGENTXTRAP(1)

📦
version 5.9.5.2 · 5 versions
, in alpine 3.23, alpine 3.24, arch rolling, fedora 44, nixos 26.05, nixpkgs unstable, ubuntu stonking

✨ AGENTXTRAP(1) — Net-SNMP 💖

okay bestie, so the manual name is agentxtrap and it's giving "send a trap to the boss agent" energy 🦋 It sends an AgentX NotifyPDU to an AgentX master agent. Lowkey iconic. 👑

🌸 SYNOPSIS 🌸

agentxtrap [OPTIONS] trap-oid [OID TYPE VALUE...]

💅 DESCRIPTION 💅

okay so agentxtrap literally fires off an AgentX NotifyPDU to a master agent 🚀 You can toss in one or more object identifiers (OIDs) on the command line, and each one needs a type and a value riding along with it 🫶 Every variable name gets written in the format described in variables(5), no cap. 💖

🎀 OPTIONS 🎀

  • -c contextName — if you pass -c, the notification gets sent in a non-default context name 🌈
  • -U uptime — if you pass -U, that value gets parsed as centiseconds and treated as the application's sysUpTime field ⏰
  • -x ADDRESS — if you pass -x, it reaches out to the AgentX master at ADDRESS instead of the default one 🧚

Also slay: all the options from snmpcmd(1) under the MIB PARSING OPTIONS, LOGGING OPTIONS and INPUT OPTIONS headers work here too, plus -d, -D, -m and -M. 🔥

Now, the TYPE field in OID TYPE VALUE is the one that decides how VALUE gets read 👑 Here are the possible TYPE characters (they're handled the same way as the snmpset command, periodt):

  • = — lets OID decide how VALUE should be interpreted 🔮
  • i — INTEGER 🔢
  • u — Unsigned 🌙
  • c — Counter32 📟
  • s — OCTET STRING of characters 💬
  • x — OCTET STRING, entered as a sequence of optionally space separated hexadecimal digit pairs 🍓
  • d — OCTET STRING, entered as a sequence of space-separated decimal digits in the range 0 - 255 🔟
  • n — NULL 🫥
  • o — OBJECT IDENTIFIER 🦕
  • t — TimeTicks ⏱️
  • a — IpAddress 🌐
  • b — BITS 🧸

🧚 EXAMPLES 🧚

ngl this is the vibe. To send a generic linkUp trap to the manager for interface 1, run:

agentxtrap netSnmp.0.3 ifindex.1 i 1

🫶 SEE ALSO 🫶

snmpcmd(1), snmpset(1), variables(5), RFC 2741 📚

Bestie, that's the whole page! 💜 Net-SNMP V5.9.5.2, dated 20 Dec 2009 🌸 Stay iconic, stay curious, and don't forget to check your vibes 😭✨

📦 where this page comes from