GNU Linux-libre 6.6.34-gnu
[releases.git] / Documentation / admin-guide / device-mapper / linear.rst
1 =========
2 dm-linear
3 =========
4
5 Device-Mapper's "linear" target maps a linear range of the Device-Mapper
6 device onto a linear range of another device.  This is the basic building
7 block of logical volume managers.
8
9 Parameters: <dev path> <offset>
10     <dev path>:
11         Full pathname to the underlying block-device, or a
12         "major:minor" device-number.
13     <offset>:
14         Starting sector within the device.
15
16
17 Example scripts
18 ===============
19
20 ::
21
22   #!/bin/sh
23   # Create an identity mapping for a device
24   echo "0 `blockdev --getsz $1` linear $1 0" | dmsetup create identity
25
26 ::
27
28   #!/bin/sh
29   # Join 2 devices together
30   size1=`blockdev --getsz $1`
31   size2=`blockdev --getsz $2`
32   echo "0 $size1 linear $1 0
33   $size1 $size2 linear $2 0" | dmsetup create joined
34
35 ::
36
37   #!/usr/bin/perl -w
38   # Split a device into 4M chunks and then join them together in reverse order.
39
40   my $name = "reverse";
41   my $extent_size = 4 * 1024 * 2;
42   my $dev = $ARGV[0];
43   my $table = "";
44   my $count = 0;
45
46   if (!defined($dev)) {
47           die("Please specify a device.\n");
48   }
49
50   my $dev_size = `blockdev --getsz $dev`;
51   my $extents = int($dev_size / $extent_size) -
52                 (($dev_size % $extent_size) ? 1 : 0);
53
54   while ($extents > 0) {
55           my $this_start = $count * $extent_size;
56           $extents--;
57           $count++;
58           my $this_offset = $extents * $extent_size;
59
60           $table .= "$this_start $extent_size linear $dev $this_offset\n";
61   }
62
63   `echo \"$table\" | dmsetup create $name`;