lvm2/man/dmeventd.8.in

.TH DMEVENTD 8 "DM TOOLS #VERSION#" "Red Hat Inc" \" -*- nroff -*-
.
.SH NAME
.
dmeventd \(em Device-mapper event daemon
.
.SH SYNOPSIS
.
.B dmeventd
.RB [ \-d
.RB [ \-d
.RB [ \-d ]]]
.RB [ \-f ]
.RB [ \-h ]
.RB [ \-l ]
.RB [ \-R ]
.RB [ \-V ]
.RB [ \-? ]
.
.SH DESCRIPTION
.
dmeventd is the event monitoring daemon for device-mapper devices.
Library plugins can register and carry out actions triggered when
particular events occur.
.
.SH LVM PLUGINS
.
.HP
.IR Mirror
.br
Attempts to handle device failure automatically. See
.BR lvm.conf (5).
.
.HP
.IR Raid
.br
Attempts to handle device failure automatically. See
.BR lvm.conf (5).
.
.HP
.IR Snapshot
.br
Monitors how full a snapshot is becoming and emits a warning to
syslog when it exceeds 80% full.
The warning is repeated when 85%, 90% and 95% of the snapshot is filled.
See
.BR lvm.conf (5).
Snapshot which runs out of space gets invalid and when it is mounted,
it gets umounted if possible.
.
.HP
.IR Thin
.br
Monitors how full a thin pool data and metadata is becoming and emits
a warning to syslog when it exceeds 80% full.
The warning is repeated when 85%, 90% and 95% of the thin pool is filled.
See
.BR lvm.conf (5).
If the thin-pool runs out of space, thin volumes are umounted if possible.
.
.SH OPTIONS
.
.HP
.BR \-d
.br
Repeat from 1 to 3 times (
.BR \-d ,
.BR \-dd ,
.BR \-ddd
) to increase the detail of
debug messages sent to syslog.
Each extra d adds more debugging information.
.
.HP
.BR \-f
.br
Don't fork, run in the foreground.
.
.HP
.BR \-h
.br
Show help information.
.
.HP
.BR \-l
.br
Log through stdout and stderr instead of syslog.
This option works only with option \-f, otherwise it is ignored.
.
.HP
.BR \-?
.br
Show help information on stderr.
.
.HP
.BR \-R
.br
Replace a running dmeventd instance. The running dmeventd must be version
2.02.77 or newer. The new dmeventd instance will obtain a list of devices and
events to monitor from the currently running daemon.
.
.HP
.BR \-V
.br
Show version of dmeventd.
.
.SH SEE ALSO
.
.BR lvm (8),
.BR lvm.conf (5)
Add man page for dmeventd (inspired by patch from Danny Rawlins, monster.romster at gmail dot com) 2010-06-17 16:14:43 +04:00			`.TH DMEVENTD 8 "DM TOOLS #VERSION#" "Red Hat Inc" \" -- nroff --`
man: dmeventd update 2015-10-12 12:35:53 +03:00			`.`
Add man page for dmeventd (inspired by patch from Danny Rawlins, monster.romster at gmail dot com) 2010-06-17 16:14:43 +04:00			`.SH NAME`
man: dmeventd update 2015-10-12 12:35:53 +03:00			`.`
man: properly escape - Dash should be using '\' to be typographically correct. 2014-06-11 13:06:30 +04:00			`dmeventd \(em Device-mapper event daemon`
man: dmeventd update 2015-10-12 12:35:53 +03:00			`.`
Add man page for dmeventd (inspired by patch from Danny Rawlins, monster.romster at gmail dot com) 2010-06-17 16:14:43 +04:00			`.SH SYNOPSIS`
man: dmeventd update 2015-10-12 12:35:53 +03:00			`.`
Add man page for dmeventd (inspired by patch from Danny Rawlins, monster.romster at gmail dot com) 2010-06-17 16:14:43 +04:00			`.B dmeventd`
man: properly escape - Dash should be using '\' to be typographically correct. 2014-06-11 13:06:30 +04:00			`.RB [ \-d`
			`.RB [ \-d`
			`.RB [ \-d ]]]`
Updated documentation for dmeventd. Update man page style. Mention raid and thin plugins. Update help text printed by command to match man page. 2011-12-22 19:50:38 +04:00			`.RB [ \-f ]`
			`.RB [ \-h ]`
dmeventd: support logging on stdout Add new supported option '-l' log to stdout/stderr. It has to be paired with '-f' (foreground run). 2015-10-13 16:14:11 +03:00			`.RB [ \-l ]`
Updated documentation for dmeventd. Update man page style. Mention raid and thin plugins. Update help text printed by command to match man page. 2011-12-22 19:50:38 +04:00			`.RB [ \-R ]`
			`.RB [ \-V ]`
			`.RB [ \-? ]`
man: dmeventd update 2015-10-12 12:35:53 +03:00			`.`
Add man page for dmeventd (inspired by patch from Danny Rawlins, monster.romster at gmail dot com) 2010-06-17 16:14:43 +04:00			`.SH DESCRIPTION`
man: dmeventd update 2015-10-12 12:35:53 +03:00			`.`
Add man page for dmeventd (inspired by patch from Danny Rawlins, monster.romster at gmail dot com) 2010-06-17 16:14:43 +04:00			`dmeventd is the event monitoring daemon for device-mapper devices.`
Various cleanups following recent commits. 2010-06-21 19:56:57 +04:00			`Library plugins can register and carry out actions triggered when`
			`particular events occur.`
man: dmeventd update 2015-10-12 12:35:53 +03:00			`.`
			`.SH LVM PLUGINS`
			`.`
			`.HP`
			`.IR Mirror`
			`.br`
			`Attempts to handle device failure automatically. See`
			`.BR lvm.conf (5).`
			`.`
			`.HP`
			`.IR Raid`
			`.br`
			`Attempts to handle device failure automatically. See`
			`.BR lvm.conf (5).`
			`.`
			`.HP`
			`.IR Snapshot`
			`.br`
Various cleanups following recent commits. 2010-06-21 19:56:57 +04:00			`Monitors how full a snapshot is becoming and emits a warning to`
			`syslog when it exceeds 80% full.`
			`The warning is repeated when 85%, 90% and 95% of the snapshot is filled.`
man: dmeventd update 2015-10-12 12:35:53 +03:00			`See`
			`.BR lvm.conf (5).`
			`Snapshot which runs out of space gets invalid and when it is mounted,`
			`it gets umounted if possible.`
			`.`
			`.HP`
			`.IR Thin`
			`.br`
			`Monitors how full a thin pool data and metadata is becoming and emits`
			`a warning to syslog when it exceeds 80% full.`
Updated documentation for dmeventd. Update man page style. Mention raid and thin plugins. Update help text printed by command to match man page. 2011-12-22 19:50:38 +04:00			`The warning is repeated when 85%, 90% and 95% of the thin pool is filled.`
man: dmeventd update 2015-10-12 12:35:53 +03:00			`See`
			`.BR lvm.conf (5).`
			`If the thin-pool runs out of space, thin volumes are umounted if possible.`
			`.`
Add man page for dmeventd (inspired by patch from Danny Rawlins, monster.romster at gmail dot com) 2010-06-17 16:14:43 +04:00			`.SH OPTIONS`
man: dmeventd update 2015-10-12 12:35:53 +03:00			`.`
			`.HP`
			`.BR \-d`
			`.br`
man: properly escape - Dash should be using '\' to be typographically correct. 2014-06-11 13:06:30 +04:00			`Repeat from 1 to 3 times (`
			`.BR \-d ,`
			`.BR \-dd ,`
			`.BR \-ddd`
			`) to increase the detail of`
Add man page for dmeventd (inspired by patch from Danny Rawlins, monster.romster at gmail dot com) 2010-06-17 16:14:43 +04:00			`debug messages sent to syslog.`
			`Each extra d adds more debugging information.`
man: dmeventd update 2015-10-12 12:35:53 +03:00			`.`
			`.HP`
			`.BR \-f`
			`.br`
Add man page for dmeventd (inspired by patch from Danny Rawlins, monster.romster at gmail dot com) 2010-06-17 16:14:43 +04:00			`Don't fork, run in the foreground.`
man: dmeventd update 2015-10-12 12:35:53 +03:00			`.`
			`.HP`
			`.BR \-h`
			`.br`
Updated documentation for dmeventd. Update man page style. Mention raid and thin plugins. Update help text printed by command to match man page. 2011-12-22 19:50:38 +04:00			`Show help information.`
man: dmeventd update 2015-10-12 12:35:53 +03:00			`.`
			`.HP`
dmeventd: support logging on stdout Add new supported option '-l' log to stdout/stderr. It has to be paired with '-f' (foreground run). 2015-10-13 16:14:11 +03:00			`.BR \-l`
			`.br`
			`Log through stdout and stderr instead of syslog.`
			`This option works only with option \-f, otherwise it is ignored.`
			`.`
			`.HP`
man: dmeventd update 2015-10-12 12:35:53 +03:00			`.BR \-?`
			`.br`
			`Show help information on stderr.`
			`.`
			`.HP`
			`.BR \-R`
			`.br`
As requested in BZ 454618: - dmeventd -R will continue to start up even if no dmeventd is currently running + a test for this behaviour - add -R to dmeventd manpage 2011-03-02 15:49:13 +03:00			`Replace a running dmeventd instance. The running dmeventd must be version`
			`2.02.77 or newer. The new dmeventd instance will obtain a list of devices and`
			`events to monitor from the currently running daemon.`
man: dmeventd update 2015-10-12 12:35:53 +03:00			`.`
			`.HP`
			`.BR \-V`
			`.br`
Various cleanups following recent commits. 2010-06-21 19:56:57 +04:00			`Show version of dmeventd.`
man: dmeventd update 2015-10-12 12:35:53 +03:00			`.`
Add man page for dmeventd (inspired by patch from Danny Rawlins, monster.romster at gmail dot com) 2010-06-17 16:14:43 +04:00			`.SH SEE ALSO`
man: dmeventd update 2015-10-12 12:35:53 +03:00			`.`
Add man page for dmeventd (inspired by patch from Danny Rawlins, monster.romster at gmail dot com) 2010-06-17 16:14:43 +04:00			`.BR lvm (8),`
			`.BR lvm.conf (5)`