dmsetup (8) Linux Manual Page
dmsetup — low level logical volume management
Synopsis
-
dmsetupcleardevice_namedmsetupcreatedevice_name [-u|–uuiduuid] [–addnodeoncreate|–addnodeonresume] [-n|–notable|–tabletable|table_file] [–readahead[+]sectors|auto|none]dmsetupcreate–concise[concise_device_specification]dmsetupdeps[-ooptions] [device_name…]dmsetuphelp[-c|-C|–columns]dmsetupinfo[device_name…]dmsetupinfo-c|-C|–columns[–countcount] [–intervalseconds] [–nameprefixes] [–noheadings] [-ofields] [-O|–sortsort_fields] [–separatorseparator] [device_name]dmsetuploaddevice_name [–tabletable|table_file]dmsetupls[–targettarget_type] [–execcommand] [–tree] [-ooptions]dmsetupmangle[device_name…]dmsetupmessagedevice_name sector messagedmsetupmknodes[device_name…]dmsetupreloaddevice_name [–tabletable|table_file]dmsetupremove[-f|–force] [–retry] [–deferred] device_name…dmsetupremove_all[-f|–force] [–deferred]dmsetuprenamedevice_name new_namedmsetuprenamedevice_name–setuuiduuiddmsetupresumedevice_name… [–addnodeoncreate|–addnodeonresume] [–noflush] [–nolockfs] [–readahead[+]sectors|auto|none]dmsetupsetgeometrydevice_name cyl head sect startdmsetupsplitnamedevice_name [subsystem]dmsetupstatscommand [options]dmsetupstatus[–targettarget_type] [–noflush] [device_name…]dmsetupsuspend[–nolockfs] [–noflush] device_name…dmsetuptable[–concise] [–targettarget_type] [–showkeys] [device_name…]dmsetuptargetsdmsetupudevcompletecookiedmsetupudevcomplete_all[age_in_minutes]dmsetupudevcookiedmsetupudevcreatecookiedmsetupudevflagscookiedmsetupudevreleasecookie[cookie]dmsetupversiondmsetupwait[–noflush] device_name [event_nr]dmsetupwipe_tabledevice_name… [-f|–force] [–noflush] [–nolockfs]
-
devmap_namemajor minordevmap_namemajor:minor
Description
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. - Ensure /dev/mapper node exists after
-
–addnodeonresume -
- Ensure /dev/mapper node exists after
dmsetup resume(default with udev). - Ensure /dev/mapper node exists after
-
–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.
-
–countcount -
- 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
helpcommand). - Outputs a summary of the commands available, optionally including the list of report fields (synonym with
-
–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.
-
–intervalseconds -
- Specify the interval in seconds between successive iterations for repeating reports. If
–intervalis specified but–countis not, reports will continue to repeat until interrupted. The default interval is one second. - Specify the interval in seconds between successive iterations for repeating reports. If
-
–manglenameauto|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) andnone(no mangling). Default mode isauto. 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 - 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: