DMEVENT_TOOL(8)

💖 DMEVENT_TOOL 💖

okay bestie, welcome to dmevent_tool from section 8 of the manual — she's a userspace utility, she's lowkey iconic, and she's here to load a DSO into dmeventd and (un)register devices with it for monitoring. yes, that's the whole vibe. let's go 🦋

✨ NAME ✨

dmevent_tool — a utility used to load a DSO into dmeventd and (un)register devices with it for monitoring 💅

🎀 SYNOPSIS 🎀

dmevent_tool -[Vhmru] {RAID device name} {DSO Name}

🌸 DESCRIPTION 🌸

so dmevent_tool is a userspace utility, and her whole job is registering and unregistering DSOs with the daemon dmeventd. that's it, that's the gig, and she eats every time 💖

and if you run her with the -m command line parameter, you can display all of the actively dmeventd monitored devices. main character behavior fr fr 👑

🌈 OPTIONS 🌈

• -V — show version of dmevent_tool ✨
• -{h/?} — show this help information 🫶
• -m[r|u] — list all currently active device mapper devices and their current status with dmeventd for registered (-r)/unregistered (-m) devices
  • Syntax: dmevent_tool -m[u|r]
• -a[r|u] — same as -m, but for devices with UUID only!
  • Syntax: dmevent_tool -a[u|r]
• -r — register a device with dmeventd
  • Syntax: dmevent_tool -r <device name> <path to DSO library>
  • Example: dmevent_tool -r isw_abcdeh_Volume0 libdmraid-events.so
• -u — unregister a device with dmeventd
  • Syntax: dmevent_tool -u <device name> [<path to DSO library>]
  • Example: dmevent_tool -u isw_abcdefgh_Volume0

🧚 EXAMPLES 🧚

dmevent_tool -m is used to display all of the actively monitored devices 🍓

dmevent_tool -m
Device Name: isw_defeaigdde_Volume0_dmraid00
    Registered DSO:                   libdmraid-events.so
    UUID:
isw_defeaigdde_Volume0_dmraid00
    status:                           Active
    major device #:                   253
    minor device #:                   0
    read only device:                 No
    number of recorded kernel events: 0
    SATA drives in this volume group: /dev/sdb /dev/sdc

dmevent_tool -r is used to register a volume group device with dmeventd 💜

dmevent_tool -r isw_defeaigdde_Volume0_dmraid00 libdmraid-events.so

dmevent_tool -u is used to unregister a volume group from dmeventd ⭐

dmevent_tool -u isw_defeaigdde_Volume0_dmraid00

💀 DIAGNOSTICS 💀

dmevent_tool returns an exit code of 0 for success or 1 for error. no cap, that's the whole spectrum 😭

👑 AUTHOR 👑

Brian Wood <brian.j.wood@intel.com> 💌

that's the page bestie, you're officially fluent in dmevent_tool. go register something. slay 💅

written by Brian Wood, version 1.0.0.rc3, and yeah the manual page itself is DMEVENT_TOOL(8) — periodt, that's the sign-off 🌸🦋