mirror of
git://sourceware.org/git/lvm2.git
synced 2024-12-22 17:35:59 +03:00
ca905681cc
For each section 8 man page, a .8_gen file is created from one of: .8_main - Old-style man page - content used directly .8_des and .8_end - Description and end section of a generated page .8_pregen - Pre-generated page used if the generator fails Other man sections are not generated and use the suffix .5_main or .7_main. Developers should use 'make generate' to regenerate the .8_pregen files.
151 lines
3.7 KiB
Plaintext
151 lines
3.7 KiB
Plaintext
.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 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 LVM PLUGINS
|
|
.
|
|
.HP
|
|
.BR Mirror
|
|
.br
|
|
Attempts to handle device failure automatically. See
|
|
.BR lvm.conf (5).
|
|
.
|
|
.HP
|
|
.BR Raid
|
|
.br
|
|
Attempts to handle device failure automatically. See
|
|
.BR lvm.conf (5).
|
|
.
|
|
.HP
|
|
.BR 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
|
|
.BR 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 more then 85%, 90% and 95%
|
|
of the thin pool is filled. See
|
|
.BR lvm.conf (5).
|
|
When a thin pool fills over 50% (data or metadata) thin plugin calls
|
|
configured \fIdmeventd/thin_command\fP with every 5% increase.
|
|
With default setting it calls internal
|
|
\fBlvm lvextend --use-policies\fP to resize thin pool
|
|
when it's been filled above configured threshold
|
|
\fIactivation/thin_pool_autoextend_threshold\fP.
|
|
If the command fails, dmeventd thin plugin will keep
|
|
retrying execution with increasing time delay between
|
|
retries upto 42 minutes.
|
|
User may also configure external command to support more advanced
|
|
maintenance operations of a thin pool.
|
|
Such external command can e.g. remove some unneeded snapshots,
|
|
use \fBfstrim\fP(8) to free recover space in a thin pool,
|
|
but also can use \fBlvextend --use-policies\fP if other actions
|
|
have not released enough space.
|
|
Command is executed with environmental variable
|
|
\fBLVM_RUN_BY_DMEVENTD=1\fP so any lvm2 command executed
|
|
in this environment will not try to interact with dmeventd.
|
|
To see the fullness of a thin pool command may check these
|
|
two environmental variables
|
|
\fBDMEVENTD_THIN_POOL_DATA\fP and \fBDMEVENTD_THIN_POOL_DATA\fP.
|
|
Command can also read status with tools like \fBlvs\fP(8).
|
|
.
|
|
.SH ENVIRONMENT VARIABLES
|
|
.
|
|
.TP
|
|
.B DMEVENTD_THIN_POOL_DATA
|
|
Variable is set by thin plugin and is available to executed program. Value present
|
|
actual usage of thin pool data volume. Variable is not set when error event
|
|
is processed.
|
|
.TP
|
|
.B DMEVENTD_THIN_POOL_DATA
|
|
Variable is set by thin plugin and is available to executed program. Value present
|
|
actual usage of thin pool metadata volume. Variable is not set when error event
|
|
is processed.
|
|
.TP
|
|
.B LVM_RUN_BY_DMEVENTD
|
|
Variable is set by thin plugin to prohibit recursive interation
|
|
with dmeventd by any executed lvm2 command from
|
|
a thin_command environment.
|
|
.
|
|
.SH SEE ALSO
|
|
.
|
|
.BR lvm (8),
|
|
.BR lvm.conf (5)
|