xref: /freebsd/share/man/man4/geom_linux_lvm.4 (revision fa9896e082a1046ff4fbc75fcba4d18d1f2efc19)
113328753SAndrew Thompson.\"
213328753SAndrew Thompson.\" Copyright (c) 2008 Andrew Thompson
313328753SAndrew Thompson.\" All rights reserved.
413328753SAndrew Thompson.\"
513328753SAndrew Thompson.\" Redistribution and use in source and binary forms, with or without
613328753SAndrew Thompson.\" modification, are permitted provided that the following conditions
713328753SAndrew Thompson.\" are met:
813328753SAndrew Thompson.\" 1. Redistributions of source code must retain the above copyright
913328753SAndrew Thompson.\"    notice, this list of conditions and the following disclaimer.
1013328753SAndrew Thompson.\" 2. Redistributions in binary form must reproduce the above copyright
1113328753SAndrew Thompson.\"    notice, this list of conditions and the following disclaimer in the
1213328753SAndrew Thompson.\"    documentation and/or other materials provided with the distribution.
1313328753SAndrew Thompson.\"
1413328753SAndrew Thompson.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
1513328753SAndrew Thompson.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
1613328753SAndrew Thompson.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
1713328753SAndrew Thompson.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
1813328753SAndrew Thompson.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
1913328753SAndrew Thompson.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
2013328753SAndrew Thompson.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
2113328753SAndrew Thompson.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
2213328753SAndrew Thompson.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
2313328753SAndrew Thompson.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
2413328753SAndrew Thompson.\" SUCH DAMAGE.
2513328753SAndrew Thompson.\"
2605d98029SSergey Kandaurov.Dd October 1, 2013
2713328753SAndrew Thompson.Dt GEOM_LINUX_LVM 4
28aa12cea2SUlrich Spörlein.Os
2913328753SAndrew Thompson.Sh NAME
3013328753SAndrew Thompson.Nm geom_linux_lvm
3113328753SAndrew Thompson.Nd "GEOM based Linux LVM logical volume mapping"
3213328753SAndrew Thompson.Sh SYNOPSIS
3313328753SAndrew ThompsonTo compile this driver into the kernel,
3413328753SAndrew Thompsonplace the following line in your
3513328753SAndrew Thompsonkernel configuration file:
3613328753SAndrew Thompson.Bd -ragged -offset indent
3713328753SAndrew Thompson.Cd "options GEOM_LINUX_LVM"
3813328753SAndrew Thompson.Ed
3913328753SAndrew Thompson.Pp
4013328753SAndrew ThompsonAlternatively, to load the driver as a
4113328753SAndrew Thompsonmodule at boot time, place the following line in
4213328753SAndrew Thompson.Xr loader.conf 5 :
4313328753SAndrew Thompson.Bd -literal -offset indent
4413328753SAndrew Thompsongeom_linux_lvm_load="YES"
4513328753SAndrew Thompson.Ed
4613328753SAndrew Thompson.Sh DESCRIPTION
4713328753SAndrew ThompsonThe
4813328753SAndrew Thompson.Nm
4913328753SAndrew Thompsonframework provides support for mapping Linux LVM volumes to GEOM providers.
5013328753SAndrew Thompson.Nm
5113328753SAndrew Thompsoncurrently supports linear stripes with segments on one or more physical disks.
5213328753SAndrew ThompsonThe parser is able to read LVM2 Text Format metadata, the logical volumes will
5313328753SAndrew Thompsonbe assembled and made available under
5413328753SAndrew Thompson.Pa /dev/linux_lvm/ .
5513328753SAndrew ThompsonThe metadata is read-only, logical volumes cannot be allocated or resized.
5613328753SAndrew Thompson.Sh EXAMPLES
5713328753SAndrew ThompsonTo view which
5813328753SAndrew Thompson.Nm
5913328753SAndrew Thompsondevices are available:
6013328753SAndrew Thompson.Bd -literal -offset indent
6113328753SAndrew Thompson# geom linux_lvm list
6213328753SAndrew ThompsonGeom name: vg1
6313328753SAndrew ThompsonProviders:
6413328753SAndrew Thompson1. Name: linux_lvm/vg1-home
6513328753SAndrew Thompson   Mediasize: 4294967296 (4.0G)
6613328753SAndrew Thompson   Sectorsize: 512
6713328753SAndrew Thompson   Mode: r0w0e0
6813328753SAndrew Thompson2. Name: linux_lvm/vg1-logs
6913328753SAndrew Thompson   Mediasize: 4294967296 (4.0G)
7013328753SAndrew Thompson   Sectorsize: 512
7113328753SAndrew Thompson   Mode: r0w0e0
7213328753SAndrew ThompsonConsumers:
7305d98029SSergey Kandaurov1. Name: ada0s1
7413328753SAndrew Thompson   Mediasize: 80023716864 (75G)
7513328753SAndrew Thompson   Sectorsize: 512
7613328753SAndrew Thompson   Mode: r0w0e0
7713328753SAndrew Thompson.Ed
7813328753SAndrew Thompson.Sh SEE ALSO
7913328753SAndrew Thompson.Xr GEOM 4 ,
8013328753SAndrew Thompson.Xr geom 8
8113328753SAndrew Thompson.Sh AUTHORS
8213328753SAndrew Thompson.An -nosplit
8313328753SAndrew ThompsonThe
8413328753SAndrew Thompson.Nm
8513328753SAndrew Thompsondriver was written by
86*6c899950SBaptiste Daroussin.An Andrew Thompson Aq Mt thompsa@FreeBSD.org .
87