All of lore.kernel.org
 help / color / mirror / Atom feed
From: Borden <borden_c@tutanota.com>
To: Cryptsetup <cryptsetup@lists.linux.dev>
Subject: What does cryptsetup luksAddKey --new-key-description do?
Date: Sat, 13 Jun 2026 03:32:29 +0200 (CEST)	[thread overview]
Message-ID: <OuyYP0g--F-9@tutanota.com> (raw)

I can't seem to figure this out through the usual means. `man cryptsetup-luksAddKey` says:

--new-key-description text : Set the key description in the keyring that will be used for new passphrase retrieval.

... which I assume is the kernel's keyring. Passing --new-key-description="Value" yields:
# Verifying key from keyslot 0, digest 0.
# Requesting key Value (user type)
# keyring_request_key_id failed with errno 126.
Failed to read passphrase from keyring.
# Rolling back in-memory LUKS2 json metadata.
# Releasing crypt device /home/me/dev.img context.
# Releasing device-mapper backend.
# Closing read only fd for /home/me/dev.img.
Command failed with code -1 (wrong or missing parameters).

luksAddKey works fine without --new-key-description. I'm trying to understand what this parameter does and how it should work. I'd also like to ask that the manpage be updated to explain this parameter a little more thoroughly. I'm not sure how I am supposed to know what I'm doing wrong with the documentation. AI said it should work, so there must be a problem with my bash or cryptsetup installation. Something's obviously missing.

                 reply	other threads:[~2026-06-13  1:41 UTC|newest]

Thread overview: [no followups] expand[flat|nested]  mbox.gz  Atom feed

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=OuyYP0g--F-9@tutanota.com \
    --to=borden_c@tutanota.com \
    --cc=cryptsetup@lists.linux.dev \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.