Add dmsetup manpage entries for mangle command and --manglename option.

1 files changed, 23 insertions, 0 deletions

diff --git a/man/dmsetup.8.in b/man/dmsetup.8.in
index 7b6e3313..8eb679b9 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 ]