---
name: "dmevent_tool"
section: "8"
platform: "linux"
package: "dmraid"
version: "1.0.0.rc16.3-15"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/dmevent_tool"
---

# dmevent\_tool(8)

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

## 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

dmevent\_tool is a userspace utility used to register/unregister DSOs with the daemon dmeventd.

If used with the **-m** command line parameter users can display all of the actively dmeventd monitored devices.

## 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.

## AUTHOR

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