xref: /freebsd/share/man/man4/geom_linux_lvm.4 (revision 39ee7a7a6bdd1557b1c3532abf60d139798ac88b)
1.\"
2.\" Copyright (c) 2008 Andrew Thompson
3.\" All rights reserved.
4.\"
5.\" Redistribution and use in source and binary forms, with or without
6.\" modification, are permitted provided that the following conditions
7.\" are met:
8.\" 1. Redistributions of source code must retain the above copyright
9.\"    notice, this list of conditions and the following disclaimer.
10.\" 2. Redistributions in binary form must reproduce the above copyright
11.\"    notice, this list of conditions and the following disclaimer in the
12.\"    documentation and/or other materials provided with the distribution.
13.\"
14.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
24.\" SUCH DAMAGE.
25.\"
26.\" $FreeBSD$
27.\"
28.Dd October 1, 2013
29.Dt GEOM_LINUX_LVM 4
30.Os
31.Sh NAME
32.Nm geom_linux_lvm
33.Nd "GEOM based Linux LVM logical volume mapping"
34.Sh SYNOPSIS
35To compile this driver into the kernel,
36place the following line in your
37kernel configuration file:
38.Bd -ragged -offset indent
39.Cd "options GEOM_LINUX_LVM"
40.Ed
41.Pp
42Alternatively, to load the driver as a
43module at boot time, place the following line in
44.Xr loader.conf 5 :
45.Bd -literal -offset indent
46geom_linux_lvm_load="YES"
47.Ed
48.Sh DESCRIPTION
49The
50.Nm
51framework provides support for mapping Linux LVM volumes to GEOM providers.
52.Nm
53currently supports linear stripes with segments on one or more physical disks.
54The parser is able to read LVM2 Text Format metadata, the logical volumes will
55be assembled and made available under
56.Pa /dev/linux_lvm/ .
57The metadata is read-only, logical volumes cannot be allocated or resized.
58.Sh EXAMPLES
59To view which
60.Nm
61devices are available:
62.Bd -literal -offset indent
63# geom linux_lvm list
64Geom name: vg1
65Providers:
661. Name: linux_lvm/vg1-home
67   Mediasize: 4294967296 (4.0G)
68   Sectorsize: 512
69   Mode: r0w0e0
702. Name: linux_lvm/vg1-logs
71   Mediasize: 4294967296 (4.0G)
72   Sectorsize: 512
73   Mode: r0w0e0
74Consumers:
751. Name: ada0s1
76   Mediasize: 80023716864 (75G)
77   Sectorsize: 512
78   Mode: r0w0e0
79.Ed
80.Sh SEE ALSO
81.Xr GEOM 4 ,
82.Xr geom 8
83.Sh AUTHORS
84.An -nosplit
85The
86.Nm
87driver was written by
88.An Andrew Thompson Aq Mt thompsa@FreeBSD.org .
89