1DMEVENT_TOOL(8)                                                DMEVENT_TOOL(8)
2
3
4

NAME

6       dmevent_tool  - A utility used to load a DSO into dmeventd and (un)reg‐
7       ister devices with it for monitoring
8

SYNOPSIS

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

DESCRIPTION

14       dmevent_tool is a userspace utility used  to  register/unregister  DSOs
15       with the daemon dmeventd.
16
17       If used with the -m command line parameter users can display all of the
18       actively dmeventd monitored devices.
19
20
21

OPTIONS

23       -V      Show version of dmevent_tool
24
25
26       -{h/?}  Show this help information
27
28
29       -m[r|u] List all currently active device mapper devices
30               and their current status with dmeventd
31               for registered (-r)/unregistered (-m) devices
32                   Syntax: dmevent_tool -m[u|r]
33
34
35       -a[r|u] Same as -m, but for devices with UUID only!
36                   Syntax: dmevent_tool -a[u|r]
37
38
39       -r      Register a device with dmeventd
40                   Syntax: dmevent_tool -r <device name> <path to DSO library>
41                   Example:  dmevent_tool  -r  isw_abcdeh_Volume0   libdmraid-
42       events.so
43
44
45       -u      Unregister a device with dmeventd
46                   Syntax:   dmevent_tool  -u  <device  name>  [<path  to  DSO
47       library>]
48                   Example: dmevent_tool -u isw_abcdefgh_Volume0
49
50

EXAMPLES

52       dmevent_tool -m is used  to  display  all  of  the  actively  monitored
53       devices
54           dmevent_tool -m
55           Device Name: isw_defeaigdde_Volume0_dmraid00
56               Registered DSO:                   libdmraid-events.so
57               UUID:                                       isw_defeaigdde_Vol‐
58       ume0_dmraid00
59               status:                           Active
60               major device #:                   253
61               minor device #:                   0
62               read only device:                 No
63               number of recorded kernel events: 0
64               SATA drives in this volume group: /dev/sdb /dev/sdc
65
66       dmevent_tool -r is used to register a volume group device with dmeventd
67           dmevent_tool -r isw_defeaigdde_Volume0_dmraid00 libdmraid-events.so
68
69
70       dmevent_tool -u is used to unregister a volume group from dmeventd
71           dmevent_tool -u isw_defeaigdde_Volume0_dmraid00
72
73

DIAGNOSTICS

75       dmevent_tool returns an exit code of 0 for success or 1 for error.
76
77

AUTHOR

79       Brian Wood <brian.j.wood@intel.com>
80
81
82
83Brian Wood                         1.0.0.rc3                   DMEVENT_TOOL(8)