Bug 1743399
| Summary: | 'cryptsetup reencrypt" and "cryptsetup-reencrypt" are two distinct utilities yet both give old CRYPTSETUP-REENCRYPT(8) man page | ||
|---|---|---|---|
| Product: | Red Hat Enterprise Linux 8 | Reporter: | Corey Marthaler <cmarthal> |
| Component: | cryptsetup | Assignee: | Ondrej Kozina <okozina> |
| Status: | CLOSED ERRATA | QA Contact: | guazhang <guazhang> |
| Severity: | low | Docs Contact: | |
| Priority: | high | ||
| Version: | 8.1 | CC: | agk, guazhang, jbrassow, mbroz, okozina, prajnoha |
| Target Milestone: | rc | Flags: | pm-rhel:
mirror+
|
| Target Release: | 8.0 | ||
| Hardware: | x86_64 | ||
| OS: | Linux | ||
| Whiteboard: | |||
| Fixed In Version: | cryptsetup-2.2.2-1.el8 | Doc Type: | If docs needed, set a value |
| Doc Text: | Story Points: | --- | |
| Clone Of: | Environment: | ||
| Last Closed: | 2020-04-28 16:54:37 UTC | Type: | Bug |
| Regression: | --- | Mount Type: | --- |
| Documentation: | --- | CRM: | |
| Verified Versions: | Category: | --- | |
| oVirt Team: | --- | RHEL 7.3 requirements from Atomic Host: | |
| Cloudforms Team: | --- | Target Upstream Version: | |
| Embargoed: | |||
| Bug Depends On: | 1757783 | ||
| Bug Blocks: | |||
Hmm, this never occurred to me. I'd like to solve this problem by removing cryptsetup-reencrypt in future releases (while moving LUKS1 reencryption in cryptsetup as well). But for now I think we should perhaps just add remark that "If looking for LUKS2 online reencryption, please read man cryptsetup" or similar? There's following hint in cryptsetup-reencrypt manual page since cryptsetup v2.2.2:
>> NOTE: If you're looking for LUKS2 online reencryption manual please read cryptsetup(8) man page instead (see reencrypt action). This page is for legacy offline reencryption utility only.
I don't think we can do anything else about it unless we fully merge cryptsetup-reencnrypt code in cryptsetup later (no sooner than 2.4.0 upstream release)
Hello
It seem the cryptsetup-2.2.2-1.el8 don't update the man pageļ¼ May I move to verified for the fixed version ?
#man cryptsetup-reencrypt
CRYPTSETUP-REENCRYPT(8) Maintenance Commands CRYPTSETUP-REENCRYPT(8)
NAME
cryptsetup-reencrypt - tool for offline LUKS device re-encryption
SYNOPSIS
cryptsetup-reencrypt <options> <device>
#man cryptsetup reencrypt
CRYPTSETUP-REENCRYPT(8) Maintenance Commands CRYPTSETUP-REENCRYPT(8)
NAME
cryptsetup-reencrypt - tool for offline LUKS device re-encryption
SYNOPSIS
cryptsetup-reencrypt <options> <device>
That note is man page for cryptsetup-reencrypt (installed separately from basic cryptsetup). Let me check... yup. It's there. man cryptsetup-reencrypt | grep "NOTE:.*LUKS2 online" Hello
# man cryptsetup-reencrypt | grep "NOTE:.*LUKS2 online"
NOTE: If you're looking for LUKS2 online reencryption manual please read cryptsetup(8) man page instead (see
# man cryptsetup reencrypt | grep "NOTE:.*LUKS2 online"
NOTE: If you're looking for LUKS2 online reencryption manual please read cryptsetup(8) man page instead (see
so move to verified
thanks
guazhang
Since the problem described in this bug report should be resolved in a recent advisory, it has been closed with a resolution of ERRATA. For information on the advisory, and where to find the updated files, follow the link below. If the solution does not work for you, open a new bug report. https://access.redhat.com/errata/RHBA-2020:1848 |
Description of problem: # cryptsetup reencrypt [root@hayes-01 ~]# man cryptsetup reencrypt CRYPTSETUP-REENCRYPT(8) Maintenance Commands CRYPTSETUP-REENCRYPT(8) NAME cryptsetup-reencrypt - tool for offline LUKS device re-encryption SYNOPSIS cryptsetup-reencrypt <options> <device> # cryptsetup-reencrypt [root@hayes-01 ~]# man cryptsetup-reencrypt CRYPTSETUP-REENCRYPT(8) Maintenance Commands CRYPTSETUP-REENCRYPT(8) NAME cryptsetup-reencrypt - tool for offline LUKS device re-encryption SYNOPSIS cryptsetup-reencrypt <options> <device> Version-Release number of selected component (if applicable): cryptsetup-2.2.0-1.el8 BUILT: Fri Aug 16 01:22:41 CDT 2019 cryptsetup-libs-2.2.0-1.el8 BUILT: Fri Aug 16 01:22:41 CDT 2019 cryptsetup-reencrypt-2.2.0-1.el8 BUILT: Fri Aug 16 01:22:41 CDT 2019