lvm-lvpoll(8)

1LVM(LVPOLL)                      Red Hat, Inc.                     LVM(LVPOLL)
2
3
4

NAME

6       lvm  lvpoll  —  Continue  already initiated poll operation on a logical
7       volume
8

SYNOPSIS

10       lvm lvpoll option_args position_args
11           [ option_args ]
12

DESCRIPTION

14       lvm lvpoll is an internal command used by lvmpolld(8)  to  monitor  and
15       complete  lvconvert(8) and pvmove(8) operations. lvpoll itself does not
16       initiate these operations and should not normally need to  be  run  di‐
17       rectly.
18

USAGE

20       lvm lvpoll --polloperation pvmove|convert|merge|merge_thin LV ...
21           [ -A|--autobackup y|n ]
22           [ -i|--interval Number ]
23           [    --abort ]
24           [    --handlemissingpvs ]
25           [ COMMON_OPTIONS ]
26
27       Common options for lvm:
28           [ -d|--debug ]
29           [ -h|--help ]
30           [ -q|--quiet ]
31           [ -t|--test ]
32           [ -v|--verbose ]
33           [ -y|--yes ]
34           [    --commandprofile String ]
35           [    --config String ]
36           [    --devices PV ]
37           [    --devicesfile String ]
38           [    --driverloaded y|n ]
39           [    --journal String ]
40           [    --lockopt String ]
41           [    --longhelp ]
42           [    --nohints ]
43           [    --nolocking ]
44           [    --profile String ]
45           [    --version ]
46

OPTIONS

48       --abort
49              Stop processing a poll operation in lvmpolld.
50
51       -A|--autobackup y|n
52              Specifies  if metadata should be backed up automatically after a
53              change.  Enabling this is strongly advised!  See  vgcfgbackup(8)
54              for more information.
55
56       --commandprofile String
57              The  command  profile  to  use  for  command configuration.  See
58              lvm.conf(5) for more information about profiles.
59
60       --config String
61              Config settings for the command. These override lvm.conf(5) set‐
62              tings.   The  String arg uses the same format as lvm.conf(5), or
63              may use section/field syntax.  See lvm.conf(5) for more informa‐
64              tion about config.
65
66       -d|--debug ...
67              Set debug level. Repeat from 1 to 6 times to increase the detail
68              of messages sent to the log file and/or syslog (if configured).
69
70       --devices PV
71              Restricts the devices that are visible  and  accessible  to  the
72              command.  Devices not listed will appear to be missing. This op‐
73              tion can be repeated, or accepts a comma separated list  of  de‐
74              vices. This overrides the devices file.
75
76       --devicesfile String
77              A file listing devices that LVM should use.  The file must exist
78              in /etc/lvm/devices/ and is managed with the lvmdevices(8)  com‐
79              mand.   This  overrides  the lvm.conf(5) devices/devicesfile and
80              devices/use_devicesfile settings.
81
82       --driverloaded y|n
83              If set to no, the command will not attempt to use device-mapper.
84              For testing and debugging.
85
86       --handlemissingpvs
87              Allows  a  polling  operation  to continue when PVs are missing,
88              e.g. for repairs due to faulty devices.
89
90       -h|--help
91              Display help text.
92
93       -i|--interval Number
94              Report progress at regular intervals.
95
96       --journal String
97              Record information in the systemd journal.  This information  is
98              in  addition  to information enabled by the lvm.conf log/journal
99              setting.  command: record information about the  command.   out‐
100              put: record the default command output.  debug: record full com‐
101              mand debugging.
102
103       --lockopt String
104              Used to pass options for special cases to  lvmlockd.   See  lvm‐
105              lockd(8) for more information.
106
107       --longhelp
108              Display long help text.
109
110       --nohints
111              Do  not  use the hints file to locate devices for PVs. A command
112              may read more devices to find PVs when hints are not  used.  The
113              command will still perform standard hint file invalidation where
114              appropriate.
115
116       --nolocking
117              Disable locking. Use with caution, concurrent commands may  pro‐
118              duce incorrect results.
119
120       --polloperation pvmove|convert|merge|merge_thin
121              The command to perform from lvmpolld.
122
123       --profile String
124              An alias for --commandprofile or --metadataprofile, depending on
125              the command.
126
127       -q|--quiet ...
128              Suppress output and log messages. Overrides --debug  and  --ver‐
129              bose.   Repeat  once  to  also  suppress any prompts with answer
130              'no'.
131
132       -t|--test
133              Run in test mode. Commands will not update  metadata.   This  is
134              implemented  by  disabling all metadata writing but nevertheless
135              returning success to the calling function. This may lead to  un‐
136              usual  error messages in multi-stage operations if a tool relies
137              on reading back metadata it believes has changed but hasn't.
138
139       -v|--verbose ...
140              Set verbose level. Repeat from 1 to 4 times to increase the  de‐
141              tail of messages sent to stdout and stderr.
142
143       --version
144              Display version information.
145
146       -y|--yes
147              Do  not  prompt for confirmation interactively but always assume
148              the answer yes. Use with extreme caution.   (For  automatic  no,
149              see -qq.)
150

VARIABLES

152       LV     Logical  Volume  name.  See lvm(8) for valid names.  An LV posi‐
153              tional arg generally includes the VG  name  and  LV  name,  e.g.
154              VG/LV.
155
156       String See the option description for information about the string con‐
157              tent.
158
159       Size[UNIT]
160              Size is an input number that accepts an  optional  unit.   Input
161              units are always treated as base two values, regardless of capi‐
162              talization, e.g. 'k' and 'K' both refer to  1024.   The  default
163              input unit is specified by letter, followed by |UNIT.  UNIT rep‐
164              resents other possible input units: b|B is bytes, s|S is sectors
165              of  512  bytes,  k|K is KiB, m|M is MiB, g|G is GiB, t|T is TiB,
166              p|P is PiB, e|E is EiB.  (This should not be confused  with  the
167              output  control  --units, where capital letters mean multiple of
168              1000.)
169

ENVIRONMENT VARIABLES

171       See lvm(8) for information about environment  variables  used  by  lvm.
172       For example, LVM_VG_NAME can generally be substituted for a required VG
173       parameter.
174

NOTES

176       To find the name of the pvmove LV that was created by an  original  pv‐
177       move /dev/name command, use the command:
178       lvs -a -S move_pv=/dev/name.
179

EXAMPLES

181       Continue polling a pvmove operation.
182       lvm lvpoll --polloperation pvmove vg00/pvmove0
183
184       Abort a pvmove operation.
185       lvm lvpoll --polloperation pvmove --abort vg00/pvmove0
186
187       Continue polling a mirror conversion.
188       lvm lvpoll --polloperation convert vg00/lvmirror
189
190       Continue mirror repair.
191       lvm lvpoll --polloperation convert vg/damaged_mirror --handlemissingpvs
192
193       Continue snapshot merge.
194       lvm lvpoll --polloperation merge vg/snapshot_old
195
196       Continue thin snapshot merge.
197       lvm lvpoll --polloperation merge_thin vg/thin_snapshot
198