diff --git a/man/dmsetup.8.in b/man/dmsetup.8.in index 7b6e33130..8eb679b9a 100644 --- a/man/dmsetup.8.in +++ b/man/dmsetup.8.in @@ -64,6 +64,9 @@ dmsetup \- low level logical volume management .B dmsetup mknodes .RI [ device_name ] .br +.B dmsetup mangle +.RI [ device_name ] +.br .B dmsetup reload .I device_name .RB [ \-\-table @@ -186,6 +189,17 @@ 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. .TP +.IR \fB\-\-manglename \ < mangling_mode > +Mangle any character not on a whitelist using mangling_mode when +processing device-mapper device names. The names are mangled on +input and unmangled on output where the mangling_mode is one of: +none (no mangling), hex (always do the mangling) and auto +(only do the mangling if not mangled yet, do nothing if already +mangled, error on mixed; this is used by default). +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 \\x. +.TP .BR \-j | \-\-major\ \fImajor Specify the major number. .TP @@ -382,6 +396,15 @@ correspond to mapped devices currently loaded by the device-mapper kernel driver, adding, changing or removing nodes as necessary. .br .HP +.B mangle +.RI [ device_name ] +.br +Ensure existing device-mapper device name is in the correct mangled +form containing only whitelisted characters (supported by udev) and do +a rename if necessary. Any character not on the whitelist will be mangled +based on the --manglename settting. +.br +.HP .B remove .RB [ \-f | \-\-force ] .RB [ \-\-retry ]