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           [    --profile String ]
40           [    --version ]
41

OPTIONS

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

VARIABLES

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

ENVIRONMENT VARIABLES

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

NOTES

145       To  find  the  name  of  the  pvmove LV that was created by an original
146       pvmove /dev/name command, use the command:
147       lvs -a -S move_pv=/dev/name.
148

EXAMPLES

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

SEE ALSO

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