shaba/lvm2
1
0
Fork 0
mirror of git://sourceware.org/git/lvm2.git synced 2024-12-22 17:35:59 +03:00
Code Releases Activity
3f0434057b
lvm2/man/lvmetad.8.in

72 lines
2.3 KiB
Groff
Raw Normal View History

Add a rudimentary lvmetad manpage.
2012-04-15 19:40:48 +04:00
.TH LVMETAD 8 "LVM TOOLS #VERSION#" "Red Hat Inc" \" -*- nroff -*-
.SH NAME
man: properly escape - Dash should be using '\' to be typographically correct.
2014-06-11 13:06:30 +04:00
lvmetad \(em LVM metadata cache daemon
Add a rudimentary lvmetad manpage.
2012-04-15 19:40:48 +04:00
.SH SYNOPSIS
.B lvmetad
lvmetad: use -l for logging level not -d
2012-10-15 13:44:43 +04:00
.RB [ \-l
man: colorization fixes Fix style
2014-03-26 17:04:44 +04:00
.RI { all | wire | debug }]
lvmetad: extend socket/pid file handling Make it easier to run a live lvmetad in debugging mode and to avoid conflicts if multiple test instances need to be run alongside a live one. No longer require -s when -f is used: use built-in default. Add -p to lvmetad to specify the pid file. No longer disable pidfile if -f used to run in foreground. If specified socket file appears to be genuine but stale, remove it before use. On error, only remove lvmetad socket file if created by the same process. (Previous code removes socket even while a running instance is using it!)
2013-11-30 00:56:29 +04:00
.RB [ \-p
man: colorization fixes Fix style
2014-03-26 17:04:44 +04:00
.IR pidfile_path ]
lvmetad: document and tidy cmdline args Try to bring the lvmetad usage text and man page closer to the code. There seem to be 3 useful ways to use -d with lvmetad at the moment: -d all -d wire -d debug (They can also be comma-separated like -d wire,debug.) Prior to the last release, -d, -dd and -ddd were supported. Fail if an unrecognised debug arg is supplied on the command line. Change -V to report the same version as the lvm binary: previously it just reported version 0.
2012-10-15 05:06:27 +04:00
.RB [ \-s
man: colorization fixes Fix style
2014-03-26 17:04:44 +04:00
.IR socket_path ]
Add a rudimentary lvmetad manpage.
2012-04-15 19:40:48 +04:00
.RB [ \-f ]
.RB [ \-h ]
.RB [ \-V ]
.RB [ \-? ]
.SH DESCRIPTION
lvmetad is a metadata caching daemon for LVM. The daemon receives notifications
from udev rules (which must be installed for LVM to work correctly when lvmetad
is in use). Through these notifications, lvmetad has an up-to-date and
consistent image of the volume groups available in the system.
man: minor fixes in lvmetad man page - better add reference to lvm dumpconfig --type default than stating that lvmetad is not enabled by default - substitute #DEFAULT_PID_DIR# with concrete value
2014-04-23 16:31:42 +04:00
lvmetad is used by LVM only if it is enabled in \fBlvm.conf\fP(5) by specifying the
\fBglobal/use_lvmetad\fP setting. If this is not defined in the LVM configuration
explicitly then default setting is used instead (see the output of
config: Introduce lvmconfig. 'lvm dumpconfig' now does a lot more than just dumping configuration information and is no longer only a support tool. Users now need to run it to find out about configuration information that has been removed from the lvm.conf man page so we need to promote this to full command line status as 'lvmconfig'. Also accept 'lvm config' and mention it in the usage information of lvmconf (which should also get merged in eventually).
2015-04-28 19:00:37 +03:00
\fBlvmconfig \-\-type default global/use_lvmetad\fP command).
Add a rudimentary lvmetad manpage.
2012-04-15 19:40:48 +04:00
.SH OPTIONS
lvmetad: extend socket/pid file handling Make it easier to run a live lvmetad in debugging mode and to avoid conflicts if multiple test instances need to be run alongside a live one. No longer require -s when -f is used: use built-in default. Add -p to lvmetad to specify the pid file. No longer disable pidfile if -f used to run in foreground. If specified socket file appears to be genuine but stale, remove it before use. On error, only remove lvmetad socket file if created by the same process. (Previous code removes socket even while a running instance is using it!)
2013-11-30 00:56:29 +04:00
To run the daemon in a test environment both the pidfile_path and the
socket_path should be changed from the defaults.
.TP
.B \-f
Don't fork, but run in the foreground.
.TP
.BR \-h ", " \-?
Show help information.
Add a rudimentary lvmetad manpage.
2012-04-15 19:40:48 +04:00
.TP
man: colorization fixes Fix style
2014-03-26 17:04:44 +04:00
.IR \fB\-l " {" all | wire | debug }
lvmetad: document and tidy cmdline args Try to bring the lvmetad usage text and man page closer to the code. There seem to be 3 useful ways to use -d with lvmetad at the moment: -d all -d wire -d debug (They can also be comma-separated like -d wire,debug.) Prior to the last release, -d, -dd and -ddd were supported. Fail if an unrecognised debug arg is supplied on the command line. Change -V to report the same version as the lvm binary: previously it just reported version 0.
2012-10-15 05:06:27 +04:00
Select the type of log messages to generate.
Messages are logged by syslog.
man: properly escape - Dash should be using '\' to be typographically correct.
2014-06-11 13:06:30 +04:00
Additionally, when \-f is given they are also sent to standard error.
lvmetad: document and tidy cmdline args Try to bring the lvmetad usage text and man page closer to the code. There seem to be 3 useful ways to use -d with lvmetad at the moment: -d all -d wire -d debug (They can also be comma-separated like -d wire,debug.) Prior to the last release, -d, -dd and -ddd were supported. Fail if an unrecognised debug arg is supplied on the command line. Change -V to report the same version as the lvm binary: previously it just reported version 0.
2012-10-15 05:06:27 +04:00
Since release 2.02.98, there are two classes of messages: wire and debug.
Selecting 'all' supplies both and is equivalent to a comma-separated list
man: properly escape - Dash should be using '\' to be typographically correct.
2014-06-11 13:06:30 +04:00
\-l wire,debug.
Prior to release 2.02.98, repeating \-d from 1 to 3 times, viz. \-d, \-dd, \-ddd,
lvmetad: document and tidy cmdline args Try to bring the lvmetad usage text and man page closer to the code. There seem to be 3 useful ways to use -d with lvmetad at the moment: -d all -d wire -d debug (They can also be comma-separated like -d wire,debug.) Prior to the last release, -d, -dd and -ddd were supported. Fail if an unrecognised debug arg is supplied on the command line. Change -V to report the same version as the lvm binary: previously it just reported version 0.
2012-10-15 05:06:27 +04:00
increased the detail of messages.
Add a rudimentary lvmetad manpage.
2012-04-15 19:40:48 +04:00
.TP
lvmetad: extend socket/pid file handling Make it easier to run a live lvmetad in debugging mode and to avoid conflicts if multiple test instances need to be run alongside a live one. No longer require -s when -f is used: use built-in default. Add -p to lvmetad to specify the pid file. No longer disable pidfile if -f used to run in foreground. If specified socket file appears to be genuine but stale, remove it before use. On error, only remove lvmetad socket file if created by the same process. (Previous code removes socket even while a running instance is using it!)
2013-11-30 00:56:29 +04:00
.B \-p \fIpidfile_path
Path to the pidfile. This overrides both the built-in default
(#DEFAULT_PID_DIR#/lvmetad.pid) and the environment variable
\fBLVM_LVMETAD_PIDFILE\fP. This file is used to prevent more
than one instance of the daemon running simultaneously.
Add a rudimentary lvmetad manpage.
2012-04-15 19:40:48 +04:00
.TP
lvmetad: extend socket/pid file handling Make it easier to run a live lvmetad in debugging mode and to avoid conflicts if multiple test instances need to be run alongside a live one. No longer require -s when -f is used: use built-in default. Add -p to lvmetad to specify the pid file. No longer disable pidfile if -f used to run in foreground. If specified socket file appears to be genuine but stale, remove it before use. On error, only remove lvmetad socket file if created by the same process. (Previous code removes socket even while a running instance is using it!)
2013-11-30 00:56:29 +04:00
.B \-s \fIsocket_path
Path to the socket file. This overrides both the built-in default
Add a rudimentary lvmetad manpage.
2012-04-15 19:40:48 +04:00
(#DEFAULT_RUN_DIR#/lvmetad.socket) and the environment variable
lvmetad: extend socket/pid file handling Make it easier to run a live lvmetad in debugging mode and to avoid conflicts if multiple test instances need to be run alongside a live one. No longer require -s when -f is used: use built-in default. Add -p to lvmetad to specify the pid file. No longer disable pidfile if -f used to run in foreground. If specified socket file appears to be genuine but stale, remove it before use. On error, only remove lvmetad socket file if created by the same process. (Previous code removes socket even while a running instance is using it!)
2013-11-30 00:56:29 +04:00
\fBLVM_LVMETAD_SOCKET\fP. To communicate successfully with lvmetad,
all LVM2 processes should use the same socket path.
Add a rudimentary lvmetad manpage.
2012-04-15 19:40:48 +04:00
.TP
.B \-V
man: updates
2013-05-05 23:38:44 +04:00
Display the version of lvmetad daemon.
.SH ENVIRONMENT VARIABLES
.TP
lvmetad: extend socket/pid file handling Make it easier to run a live lvmetad in debugging mode and to avoid conflicts if multiple test instances need to be run alongside a live one. No longer require -s when -f is used: use built-in default. Add -p to lvmetad to specify the pid file. No longer disable pidfile if -f used to run in foreground. If specified socket file appears to be genuine but stale, remove it before use. On error, only remove lvmetad socket file if created by the same process. (Previous code removes socket even while a running instance is using it!)
2013-11-30 00:56:29 +04:00
.B LVM_LVMETAD_PIDFILE
Path for the pid file.
.TP
man: updates
2013-05-05 23:38:44 +04:00
.B LVM_LVMETAD_SOCKET
lvmetad: extend socket/pid file handling Make it easier to run a live lvmetad in debugging mode and to avoid conflicts if multiple test instances need to be run alongside a live one. No longer require -s when -f is used: use built-in default. Add -p to lvmetad to specify the pid file. No longer disable pidfile if -f used to run in foreground. If specified socket file appears to be genuine but stale, remove it before use. On error, only remove lvmetad socket file if created by the same process. (Previous code removes socket even while a running instance is using it!)
2013-11-30 00:56:29 +04:00
Path for the socket file.
Add a rudimentary lvmetad manpage.
2012-04-15 19:40:48 +04:00
.SH SEE ALSO
.BR lvm (8),
.BR lvm.conf (5)
Copy Permalink