NAME

       lvm2-activation-generator - generator for systemd units to activate LVM2 volumes on boot

SYNOPSIS

       /lib/systemd/system-generators/lvm2-activation-generator

DESCRIPTION

       The lvm2-activation-generator is called by systemd(1) on boot to generate systemd units at
       runtime  to  activate  LVM2  volumes  if  lvmetad(8)  is  disabled   (global/use_lvmetad=0
       lvm.conf(5)    option    is    used).   Otherwise,   if   lvmetad(8)   is   enabled,   the
       lvm2-activation-generator exits immediately without generating any systemd units and  LVM2
       fully  relies  on  event-based  activation  to activate the LVM2 volumes instead using the
       pvscan(8) (pvscan --cache -aay) call that is a part of udev(8) rules.

       These systemd units are generated by lvm2-activation-generator:

       lvm2-activation-early.service used for activation of LVM2 volumes that is  ordered  before
       systemd's  special  cryptsetup.target to support LVM2 volumes which are not layered on top
       of encrypted devices.

       lvm2-activation.service used  for  activation  of  LVM2  volumes  that  is  ordered  after
       systemd's  special  cryptsetup.target  to support LVM2 volumes which are layered on top of
       encrypted devices.

       lvm2-activation-net.service used for activation of LVM2  volumes  that  is  ordered  after
       systemd's  special  remote-fs-pre.target  to  support  LVM2  volumes  which are layered on
       attached remote devices.

       Note that all the underlying devices (Physical  Volumes)  need  to  be  present  when  the
       service  is  run.  If the there are any devices presented in the system anytime later, any
       LVM2 volumes on top of such devices need  to  be  activated  directly  by  lvchange(8)  or
       vgchange(8).  This limitation does not exist when using lvmetad(8) and accompanying event-
       based activation since such LVM volumes are activated automatically as soon as the  Volume
       Group  is  ready  (all  the Physical Volumes making up the Volume Group are present in the
       system).

       The lvm2-activation-generator implements the Generators  Specification  as  referenced  in
       systemd(1).

SEE ALSO

       lvm.conf(5)    vgchange(8)    lvchange(8)    lvmetad(8)   pvscan(8)   udev(7)   systemd(1)
       systemd.target(5) systemd.special(7)