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
17       directly.
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           [    --driverloaded y|n ]
37           [    --lockopt String ]
38           [    --longhelp ]
39           [    --nolocking ]
40           [    --profile String ]
41           [    --version ]
42

OPTIONS

44       --abort
45              Stop processing a poll operation in lvmpolld.
46
47       -A|--autobackup y|n
48              Specifies if metadata should be backed up automatically after a
49              change.  Enabling this is strongly advised! See vgcfgbackup(8)
50              for more information.
51
52       --commandprofile String
53              The command profile to use for command configuration.  See
54              lvm.conf(5) for more information about profiles.
55
56       --config String
57              Config settings for the command. These override lvm.conf set‐
58              tings.  The String arg uses the same format as lvm.conf, or may
59              use section/field syntax.  See lvm.conf(5) for more information
60              about config.
61
62       -d|--debug ...
63              Set debug level. Repeat from 1 to 6 times to increase the detail
64              of messages sent to the log file and/or syslog (if configured).
65
66       --driverloaded y|n
67              If set to no, the command will not attempt to use device-mapper.
68              For testing and debugging.
69
70       --handlemissingpvs
71              Allows a polling operation to continue when PVs are missing,
72              e.g. for repairs due to faulty devices.
73
74       -h|--help
75              Display help text.
76
77       -i|--interval Number
78              Report progress at regular intervals.
79
80       --lockopt String
81              Used to pass options for special cases to lvmlockd.  See lvm‐
82              lockd(8) for more information.
83
84       --longhelp
85              Display long help text.
86
87       --nolocking
88              Disable locking.
89
90       --polloperation pvmove|convert|merge|merge_thin
91              The command to perform from lvmpolld.
92
93       --profile String
94              An alias for --commandprofile or --metadataprofile, depending on
95              the command.
96
97       -q|--quiet ...
98              Suppress output and log messages. Overrides --debug and --ver‐
99              bose.  Repeat once to also suppress any prompts with answer
100              'no'.
101
102       -t|--test
103              Run in test mode. Commands will not update metadata.  This is
104              implemented by disabling all metadata writing but nevertheless
105              returning success to the calling function. This may lead to
106              unusual error messages in multi-stage operations if a tool
107              relies on reading back metadata it believes has changed but
108              hasn't.
109
110       -v|--verbose ...
111              Set verbose level. Repeat from 1 to 4 times to increase the
112              detail of messages sent to stdout and stderr.
113
114       --version
115              Display version information.
116
117       -y|--yes
118              Do not prompt for confirmation interactively but always assume
119              the answer yes. Use with extreme caution.  (For automatic no,
120              see -qq.)
121

VARIABLES

123       LV
124              Logical Volume name.  See lvm(8) for valid names.  An  LV  posi‐
125              tional  arg  generally  includes  the  VG name and LV name, e.g.
126              VG/LV.
127
128       String
129              See the option description for information about the string con‐
130              tent.
131
132       Size[UNIT]
133              Size  is  an  input number that accepts an optional unit.  Input
134              units are always treated as base two values, regardless of capi‐
135              talization,  e.g.  'k'  and 'K' both refer to 1024.  The default
136              input unit is specified by letter, followed by |UNIT.  UNIT rep‐
137              resents  other  possible  input units: bBsSkKmMgGtTpPeE.  b|B is
138              bytes, s|S is sectors of 512 bytes, k|K  is  kilobytes,  m|M  is
139              megabytes, g|G is gigabytes, t|T is terabytes, p|P is petabytes,
140              e|E is exabytes.  (This should not be confused with  the  output
141              control --units, where capital letters mean multiple of 1000.)
142

ENVIRONMENT VARIABLES

144       See  lvm(8)  for  information  about environment variables used by lvm.
145       For example, LVM_VG_NAME can generally be substituted for a required VG
146       parameter.
147

NOTES

149       To  find  the  name  of  the  pvmove LV that was created by an original
150       pvmove /dev/name command, use the command:
151       lvs -a -S move_pv=/dev/name.
152

EXAMPLES

154       Continue polling a pvmove operation.
155       lvm lvpoll --polloperation pvmove vg00/pvmove0
156
157       Abort a pvmove operation.
158       lvm lvpoll --polloperation pvmove --abort vg00/pvmove0
159
160       Continue polling a mirror conversion.
161       lvm lvpoll --polloperation convert vg00/lvmirror
162
163       Continue mirror repair.
164       lvm lvpoll --polloperation convert vg/damaged_mirror --handlemissingpvs
165
166       Continue snapshot merge.
167       lvm lvpoll --polloperation merge vg/snapshot_old
168
169       Continue thin snapshot merge.
170       lvm lvpoll --polloperation merge_thin vg/thin_snapshot
171

SEE ALSO

173       lvm(8) lvm.conf(5) lvmconfig(8)
174
175       pvchange(8)  pvck(8)  pvcreate(8)  pvdisplay(8)  pvmove(8)  pvremove(8)
176       pvresize(8) pvs(8) pvscan(8)
177
178       vgcfgbackup(8)  vgcfgrestore(8)  vgchange(8) vgck(8) vgcreate(8) vgcon‐
179       vert(8)  vgdisplay(8)  vgexport(8)  vgextend(8)  vgimport(8)  vgimport‐
180       clone(8)  vgmerge(8)  vgmknodes(8)  vgreduce(8) vgremove(8) vgrename(8)
181       vgs(8) vgscan(8) vgsplit(8)
182
183       lvcreate(8) lvchange(8)  lvconvert(8)  lvdisplay(8)  lvextend(8)  lvre‐
184       duce(8) lvremove(8) lvrename(8) lvresize(8) lvs(8) lvscan(8)
185
186       lvm-fullreport(8) lvm-lvpoll(8) lvm2-activation-generator(8) blkdeacti‐
187       vate(8) lvmdump(8)
188
189       dmeventd(8) lvmpolld(8)  lvmlockd(8)  lvmlockctl(8)  cmirrord(8)  lvmd‐
190       busd(8)
191
192       lvmsystemid(7) lvmreport(7) lvmraid(7) lvmthin(7) lvmcache(7)
193
194
195
196LVM TOOLS 2.03.09(2) (2020-03-26)      8                           LVM(LVPOLL)
Impressum