Bug#245282: dmsetup: So, please at least document --showkeys

[Michael Karcher]

Package: dmsetup
Version: 2:1.02.24-3
Followup-For: Bug #245282

While I agree on not documenting everything about possible mappings in
dmsetup, I am not happy about the lack of documentation of features dmsetup
itself provides, in this case, "--showkeys".

A patch is included.

Regards,
  Michael Karcher

--- dmsetup.8.orig	2008-02-10 19:45:22.575103000 +0100
+++ dmsetup.8	2008-02-10 19:50:20.106261912 +0100
@@ -55,6 +55,7 @@
 .br
 .B dmsetup table
 .I [--target target_type]
+.I [--showkeys]
 .I [device_name]
 .br
 .B dmsetup wait
@@ -122,6 +123,9 @@
 specify a minimum value which will not be used if it is
 smaller than the value chosen by the kernel.
 "None" is equivalent to specifying zero.
+.IP \fB--showkews
+.br
+Do not hide encryption keys on the list command.
 .IP \fB--table\ <table>
 .br
 Specify a one-line table directly on the command line.
@@ -271,12 +275,14 @@
 device to remain unflushed.
 .IP \fBtable
 .I [--target target_type]
+.I [--showkeys]
 .I [device_name]
 .br
 Outputs the current table for the device in a format that can be fed
 back in using the create or load commands.
 With --target, only information relating to the specified target type
-is displayed.
+is displayed. Unless --showkeys is given, encryption keys of the crypt
+backend are replaced by an equal length string consisting only of zeroes.
 .IP \fBtargets
 .br
 Displays the names and versions of the currently-loaded targets.


-- System Information:
Debian Release: lenny/sid
  APT prefers testing
  APT policy: (990, 'testing'), (500, 'stable'), (490, 'unstable'), (1, 'experimental')
Architecture: amd64 (x86_64)

Kernel: Linux 2.6.24-rc4 (SMP w/2 CPU cores)
Locale: LANG=de_DE.UTF-8, LC_CTYPE=de_DE.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/bash

Versions of packages dmsetup depends on:
ii  libc6                        2.7-6       GNU C Library: Shared libraries
ii  libdevmapper1.02.1           2:1.02.24-3 The Linux Kernel Device Mapper use

dmsetup recommends no packages.

-- no debconf information