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           [    --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 un‐
106              usual error messages in multi-stage operations if a tool relies
107              on reading back metadata it believes has changed but hasn't.
108
109       -v|--verbose ...
110              Set verbose level. Repeat from 1 to 4 times to increase the de‐
111              tail of messages sent to stdout and stderr.
112
113       --version
114              Display version information.
115
116       -y|--yes
117              Do not prompt for confirmation interactively but always assume
118              the answer yes. Use with extreme caution.  (For automatic no,
119              see -qq.)
120

VARIABLES

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

ENVIRONMENT VARIABLES

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

NOTES

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

EXAMPLES

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

SEE ALSO

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