Date: Wed, 15 Feb 2017 19:14:28 +0100
From: "G.raud" <graud@gmx.com>
Message-ID: <20170215181428.GB28234@gmx.com>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Subject: [dm-crypt] cryptsetup manpage: misleading/imprecise description of
 --size for resize
To: dm-crypt@saout.de

Incriminated part of the cryptsetup manpage:

" If --size (in sectors) is not specified, the size of the
  underlying block device is used. "

In fact the size of the underlying block device is used _to compute_ the
_maximum_ size that can be made available, which in case of LUKS is not
the whole block device space.  The manpage can be misleading to someone
who doesn't know dmcrypt well and wants to resize a LUKS container.  At
least append something like "to compute the maximum available size" or
change to "the whole available space is used" for example.

The maximum size in the case of LUKS is, I think, the size of the block
device minus the offset; this could be additionaly stated in the
manpage.

Thanks