^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1) ======
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2) dm-ebs
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 3) ======
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 5)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 6) This target is similar to the linear target except that it emulates
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7) a smaller logical block size on a device with a larger logical block
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 8) size. Its main purpose is to provide emulation of 512 byte sectors on
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 9) devices that do not provide this emulation (i.e. 4K native disks).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11) Supported emulated logical block sizes 512, 1024, 2048 and 4096.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) Underlying block size can be set to > 4K to test buffering larger units.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16) Table parameters
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17) ----------------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18) <dev path> <offset> <emulated sectors> [<underlying sectors>]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) Mandatory parameters:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22) <dev path>:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) Full pathname to the underlying block-device,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24) or a "major:minor" device-number.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) <offset>:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26) Starting sector within the device;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) has to be a multiple of <emulated sectors>.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28) <emulated sectors>:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) Number of sectors defining the logical block size to be emulated;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30) 1, 2, 4, 8 sectors of 512 bytes supported.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32) Optional parameter:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) <underyling sectors>:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35) Number of sectors defining the logical block size of <dev path>.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) 2^N supported, e.g. 8 = emulate 8 sectors of 512 bytes = 4KiB.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37) If not provided, the logical block size of <dev path> will be used.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40) Examples:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42) Emulate 1 sector = 512 bytes logical block size on /dev/sda starting at
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) offset 1024 sectors with underlying devices block size automatically set:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45) ebs /dev/sda 1024 1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47) Emulate 2 sector = 1KiB logical block size on /dev/sda starting at
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48) offset 128 sectors, enforce 2KiB underlying device block size.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49) This presumes 2KiB logical blocksize on /dev/sda or less to work:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51) ebs /dev/sda 128 2 4