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