dmsetup(8)

dmsetup — low level logical volume management

Synopsis

dmsetup clear device_name
dmsetup create device_name [-u|–uuid uuid] [–addnodeoncreate|–addnodeonresume] [-n|–notable|–table table|table_file] [–readahead [+]sectors|auto|none]
dmsetup create –concise [concise_device_specification]
dmsetup deps [-o options] [device_name…]
dmsetup help [-c|-C|–columns]
dmsetup info [device_name…]
dmsetup info -c|-C|–columns [–count count] [–interval seconds] [–nameprefixes] [–noheadings] [-o fields] [-O|–sort sort_fields] [–separator separator] [device_name]
dmsetup load device_name [–table table|table_file]
dmsetup ls [–target target_type] [–exec command] [–tree] [-o options]
dmsetup mangle [device_name…]
dmsetup message device_name sector message
dmsetup mknodes [device_name…]
dmsetup reload device_name [–table table|table_file]
dmsetup remove [-f|–force] [–retry] [–deferred] device_name…
dmsetup remove_all [-f|–force] [–deferred]
dmsetup rename device_name new_name
dmsetup rename device_name –setuuid uuid
dmsetup resume device_name… [–addnodeoncreate|–addnodeonresume] [–noflush] [–nolockfs] [–readahead [+]sectors|auto|none]
dmsetup setgeometry device_name cyl head sect start
dmsetup splitname device_name [subsystem]
dmsetup stats command [options]
dmsetup status [–target target_type] [–noflush] [device_name…]
dmsetup suspend [–nolockfs] [–noflush] device_name…
dmsetup table [–concise] [–target target_type] [–showkeys] [device_name…]
dmsetup targets
dmsetup udevcomplete cookie
dmsetup udevcomplete_all [age_in_minutes]
dmsetup udevcookie
dmsetup udevcreatecookie
dmsetup udevflags cookie
dmsetup udevreleasecookie [cookie]
dmsetup version
dmsetup wait [–noflush] device_name [event_nr]
dmsetup wipe_table device_name… [-f|–force] [–noflush] [–nolockfs]

devmap_name major minor
devmap_name major:minor

Description

dmsetup manages logical devices that use the device-mapper driver. Devices are created by loading a table that specifies a target for each sector (512 bytes) in the logical device.

The first argument to dmsetup is a command. The second argument is the logical device name or uuid.

Invoking the dmsetup tool as devmap_name (which is not normally distributed and is supported only for historical reasons) is equivalent to dmsetup info -c –noheadings -j major -m minor.

Options

–addnodeoncreate: Ensure /dev/mapper node exists after dmsetup create.
–addnodeonresume: Ensure /dev/mapper node exists after dmsetup resume (default with udev).
–checks: Perform additional checks on the operations requested and report potential problems. Useful when debugging scripts. In some cases these checks may slow down operations noticeably.
-c|-C|–columns: Display output in columns rather than as Field: Value lines.
–count count: Specify the number of times to repeat a report. Set this to zero continue until interrupted. The default interval is one second.
-f|–force: Try harder to complete operation.
-h|–help: Outputs a summary of the commands available, optionally including the list of report fields (synonym with help command).
–inactive: When returning any table information from the kernel report on the inactive table instead of the live table. Requires kernel driver version 4.16.0 or above.
–interval seconds: Specify the interval in seconds between successive iterations for repeating reports. If –interval is specified but –count is not, reports will continue to repeat until interrupted. The default interval is one second.
–manglename auto|hex|none: Mangle any character not on a whitelist using mangling_mode when processing device-mapper device names and UUIDs. The names and UUIDs are mangled on input and unmangled on output where the mangling mode is one of: auto (only do the mangling if not mangled yet, do nothing if already mangled, error on mixed), hex (always do the mangling) and none (no mangling). Default mode is auto. Character whitelist: 0-9, A-Z, a-z, #+-.:=@_. This whitelist is also supported by udev. Any character not on a whitelist is replaced with its hex value (two digits) prefixed by