[From nobody Fri Oct 30 08:39:10 2026
Received: (at submit) by bugs.debian.org; 30 Oct 2026 04:45:11 +0000
X-Spam-Checker-Version: SpamAssassin 4.0.1-bugs.debian.org_2005_01_02
 (2024-03-25) on buxtehude.debian.org
X-Spam-Level: 
X-Spam-Status: No, score=-18.6 required=4.0 tests=BAYES_00,
 BODY_INCLUDES_PACKAGE,DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,
 DKIM_VALID_EF,FOURLA,GENDER,HAS_PACKAGE,SPF_HELO_NONE,SPF_PASS,
 XMAILER_REPORTBUG autolearn=ham autolearn_force=no
 version=4.0.1-bugs.debian.org_2005_01_02
X-Spam-Bayes: score:0.0000 Tokens: new, 10; hammy, 150; neutral, 193; spammy,
 0. spammytokens: hammytokens:0.000-+--trixie, 0.000-+--H*Ad:N*Bug,
 0.000-+--HTo:N*Debian, 0.000-+--forky, 0.000-+--HTo:N*Bug
Return-path: &lt;russell-sender@coker.com.au&gt;
Received: from smtp.sws.net.au ([144.76.186.9]:53632)
 by buxtehude.debian.org with esmtps
 (TLS1.3:ECDHE_X25519__RSA_PSS_RSAE_SHA256__AES_256_GCM:256)
 (Exim 4.96) (envelope-from &lt;russell-sender@coker.com.au&gt;)
 id 1xMeUI-0036a6-24 for submit@bugs.debian.org;
 Fri, 30 Oct 2026 04:45:11 +0000
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=coker.com.au;
 s=2008; t=1793335505;
 bh=yEbQDKm1q8XyMGfEBfJQ1mat6Cjpk4jVbN4+iRPRulk=; l=2727;
 h=From:To:Subject:Date:From;
 b=WJPkUmWnu2lg+u9an/4N1dWDPhiS6pD7rI8/7lqU9UZh1BRRtOCxNtj9dOmgEuCJt
 ezqgk5R0SgVaBrX9/yeBzvFMGQyVH8PrbnTxMse20gRXeZma4XDpp5QTpSIHp3x/ID
 ooFc0kPy7i/hYE8mW5TXB79BWcinudQuerFtcKO0=
Received: from [127.0.0.1] (localhost [127.0.0.1])
 by smtp.sws.net.au (Postfix) with ESMTP id D9A43EEFA;
 Fri, 30 Oct 2026 15:45:04 +1100 (AEDT)
Content-Type: text/plain; charset=&quot;us-ascii&quot;
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
From: Russell Coker &lt;russell@coker.com.au&gt;
To: Debian Bug Tracking System &lt;submit@bugs.debian.org&gt;
Subject: cryptsetup: The man page does not adequately explain the initramfs
 option for swap
Message-ID: &lt;179333550036.2.10670930381125125033.reportbug@xev&gt;
X-Mailer: reportbug 13.2.0+nmu1
Date: Fri, 30 Oct 2026 15:45:00 +1100
Delivered-To: submit@bugs.debian.org

Package: cryptsetup
Version: 2:2.8.8-1
Severity: normal

In Trixie x-initrd.attach is the way to autostart encrypted swap on boot.
That doesn't work on current Testing and all the documentation returned by
web searches refers to the old way to do it.

I think there needs to be a mention in the crypttab(5) man page that
x-initrd.attach is no longer supported and the examples section needs to
have a line about swap containing the &quot;initramfs&quot; option.  I believe that
x-initrd.attach was never parsed by code in the cryptsetup package (I coould
be mistaken) but I still think it's a good place to document this as it's
where people will look.

Also it might be worth having the cryptdisks_start script give a warning about
x-initrd.attach when run from the command-line.

One could argue that the bug is in not supporting Trixie syntax, I don't have
strong feelings on this, as long as man pages clearly describe what happens
and for this sort of case I can copy a line from the man page and have it work
after changing the device name I'll be happy.

https://wiki.debian.org/Swap

I have added a section to the Wiki about this which will hopefully save time
for some people.  I literally spent hours investigating this and installed a
new test machine for the sole purpose of discovering how to do it only to find
that Testing and Trixie work differently.

As an aside I ended up getting the answer from ChatGPT after numerous web
searches failed to get the right answer.

There are many ways to alleviate the problems this change will cause people
and I think we should have at least a couple of actions taken to address it.

PS None of this bug report was from ChatGPT, all I got from it was one single
keyword to use and after that I did it all myself.

-- Package-specific info:

-- System Information:
Debian Release: forky/sid
Architecture: amd64 (x86_64)
Foreign Architectures: i386

Kernel: Linux 7.2.10+deb14-amd64 (SMP w/22 CPU threads; PREEMPT)
Locale: LANG=en_AU.UTF-8, LC_CTYPE=en_AU.UTF-8 (charmap=UTF-8), LANGUAGE not set
Shell: /bin/sh linked to /usr/bin/dash
Init: unable to detect

Versions of packages cryptsetup depends on:
ii  cryptsetup-bin         2:2.8.8-1
ii  debconf [debconf-2.0]  1.5.92
ii  dmsetup                2:1.02.205-2+b2
ii  libc6                  2.43-7

cryptsetup recommends no packages.

Versions of packages cryptsetup suggests:
ii  cryptsetup-initramfs    2:2.8.8-1
ii  dosfstools              4.2-1.2
ii  keyutils                1.6.3-6+b2
ii  liblocale-gettext-perl  1.07-7+b1

-- Configuration Files:
/etc/init.d/cryptdisks [Errno 13] Permission denied: '/etc/init.d/cryptdisks'
/etc/init.d/cryptdisks-early [Errno 13] Permission denied: '/etc/init.d/cryptdisks-early'

-- debconf-show failed
]