From patchwork Wed Jan 29 12:58:55 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Milan Broz X-Patchwork-Id: 13953730 X-Patchwork-Delegate: mpatocka@redhat.com Received: from mail-ed1-f53.google.com (mail-ed1-f53.google.com [209.85.208.53]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 380CC2E40B for ; Wed, 29 Jan 2025 12:59:05 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.208.53 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1738155547; cv=none; b=SBU8aAW2Q2+LSpbWKGsb9MJ1m22StiKp0KnAbdlC8ZIIPglSo6tD294+UoLpcQLukRweMoqY+M9e5+jdl7fI4JSv7qHlVT2uxjwB8h/YcJlujBhSkhI89q3qJN9lMy9TMX94y7l8guJourrIdfNc92wrGz1O+3eib4UKjcctr+g= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1738155547; c=relaxed/simple; bh=TXRSvUsu/J8dndeS/fB+dvNxR5/6tkXFDwpKmWgjH78=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version; b=rz930dAYZscSjsDLrUAueNOafWyvfiz9ooASyUq3cYBA9HGohA6Q28lUotAuiQjlk7iNzdMVX3bNLELhZALxaXmTo4vDM31kIi86cDxmd9SmohaWiZY7g1/LJPAj73A4R1SqFaea8/9yRWAl7NqPbgKYfJ9HsO7KqzYA+FkRgIs= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=iwV3/amQ; arc=none smtp.client-ip=209.85.208.53 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="iwV3/amQ" Received: by mail-ed1-f53.google.com with SMTP id 4fb4d7f45d1cf-5dc59303334so2390367a12.2 for ; Wed, 29 Jan 2025 04:59:05 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1738155544; x=1738760344; darn=lists.linux.dev; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to; bh=4czCed/mOts1YqzeI7jcTAk/O3TM9fvff4OPJ+gxFoI=; b=iwV3/amQWSJrEAVlpph3KC2NHM755MHDWZFuulSDBkeBavZHRFd4L6cFayzVXW4C59 G/+JCAMfdqbIyzgHOuh05QkHzvjcF3xNVEWS/xNdcdERxETY/EnpY9lGfcJsbDgZVI2t USpuJal6RL2JkWBm1PskDt7kbYmbDfjS4wg5jVDMJZbA1tBLi2nqE55cOHtzSF4nNZkJ On96Z0tuZG3M+t3Kkbb4Lh/agz2QgUXfcnj/vzGgrbH2Mp2CfdUdGfnyYsnS0ihWP2U3 rJ9Dbgxzpcpo8oVDUwlDq/qBPeYZ5LvAAX7sIgv4kUkDjYUzJzJm6iBZNb/ieb511G74 Zcwg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1738155544; x=1738760344; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=4czCed/mOts1YqzeI7jcTAk/O3TM9fvff4OPJ+gxFoI=; b=Lipa8LHi8rs076XJbBvcRG7bTeC2HGxLE2t+vSdWiOQuzstbYWVaSZub6rdtXcrWlh 2gvSCLk+Zmt72RmKrg+ZfYhU+bYojQhj7Yv7+aWNQjWD9g97SfIKiUFO42CfRWPlxX/x i5h7HyuVwQLllwFNRsf7a1J48iJnoKhGp4xVcX2zoLuLT8AxsRbldBnaMI6gdiXcYQ1N RHZrXNepDVnvXuzS7urUzOLJFjnJF/isODv8Ov0La83ZfUsJ+FB4PuHZZbg9YgQpmMIC p22pqSDjY3Lp7axxk4e7cJjqvh8HwZdr7vXc1uxXuXGZ9YCnQS2wV4onWl1vGbMaoZIm BC+Q== X-Gm-Message-State: AOJu0Yx0e3REzbn/hss0TaAq7x+l5xGQ25apsrUlzJn2COceYnZnIJg4 LGYwL5Re9ZJZ4wq9an99zxFVZ784KjIKEhuWA8Grvtv8RTdPnD9BtbB68g== X-Gm-Gg: ASbGncukv7hhFl3fp2N7D+PL+0fQya0/111HNV4OqV5A3s/cXAiuydsYNQMZcqx01lK 0op2OH9aDD4Fsux57dx9pdVAmS8+Ze6rM8vzvm265JKQqUq2Eu9CP52gyBIfXwIabcMl/tHV6Me ySvUa6EgCLdqSH5TM3Hzn8BiHQzTZXaoI4q4BB6uzGvfuwYPIjfLuXHvTu+wMa/sb1u1Yhd+NI4 mUVBwqnT6MC+rbkYar3DR0d1uC1V3OZH5DPakdU4DIVQggWyTIPfK1yfiAK5ZkPIyXNVZYF/w72 2W/B0sVo7kqzNA97XMxjrQ== X-Google-Smtp-Source: AGHT+IHRcAG6AWwN+xDdFJBYVY/wc4vfXGJqJWVuagx1Woau+0kAukJ8xBrgzUIM+e4B7DUg+8HqZw== X-Received: by 2002:a17:906:40c7:b0:ab6:d660:c845 with SMTP id a640c23a62f3a-ab6d660cb02mr160863866b.50.1738155544151; Wed, 29 Jan 2025 04:59:04 -0800 (PST) Received: from syrah.fi.muni.cz ([2001:718:801:22c:1369:c402:50e6:7236]) by smtp.gmail.com with ESMTPSA id 4fb4d7f45d1cf-5dc186c9115sm8537417a12.54.2025.01.29.04.59.03 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 29 Jan 2025 04:59:03 -0800 (PST) From: Milan Broz To: dm-devel@lists.linux.dev Cc: Milan Broz Subject: [PATCH 1/3] dm-verity: Document restart_on_error and panic_on_error options Date: Wed, 29 Jan 2025 13:58:55 +0100 Message-ID: <20250129125857.252448-1-gmazyland@gmail.com> X-Mailer: git-send-email 2.47.2 Precedence: bulk X-Mailing-List: dm-devel@lists.linux.dev List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 This patch adds documentation for options introduced in commit f811b83879fb ("dm-verity: introduce the options restart_on_error and panic_on_error"). Signed-off-by: Milan Broz --- Documentation/admin-guide/device-mapper/verity.rst | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/Documentation/admin-guide/device-mapper/verity.rst b/Documentation/admin-guide/device-mapper/verity.rst index a65c1602cb23..fb3a045d0c72 100644 --- a/Documentation/admin-guide/device-mapper/verity.rst +++ b/Documentation/admin-guide/device-mapper/verity.rst @@ -87,6 +87,15 @@ panic_on_corruption Panic the device when a corrupted block is discovered. This option is not compatible with ignore_corruption and restart_on_corruption. +restart_on_error + Restart the system when an I/O error is detected. + This option can be combined with the restart_on_corruption option. + +panic_on_error + Panic the device when an I/O error is detected. This option is + not compatible with the restart_on_error option but can be combined + with the panic_on_corruption option. + ignore_zero_blocks Do not verify blocks that are expected to contain zeroes and always return zeroes instead. This may be useful if the partition contains unused blocks From patchwork Wed Jan 29 12:58:56 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Milan Broz X-Patchwork-Id: 13953731 X-Patchwork-Delegate: mpatocka@redhat.com Received: from mail-ed1-f42.google.com (mail-ed1-f42.google.com [209.85.208.42]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id E7C8EBA4A for ; Wed, 29 Jan 2025 12:59:06 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.208.42 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1738155548; cv=none; b=kuql72WlJgxCVsmtSIHrqApPy0TvTltedWMaeHYtWrKzVGp3cm1Ge+01F2XYBW6ZQwiauWZ8ZBRE4A3IUEyeYEtSU8r7/Fz23lGkV6hM+1LXHrE5vj45FK+8D64P6NS1mRzSg/6pzHdbRfkHRWNoTKDqOK6wNjpP7V6QyxO/Ilg= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1738155548; c=relaxed/simple; bh=D5EJlDaTq1xvcK8GXnVUJKOt0a7vKxl95DFxHvHZ/0w=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=S9+suXTb3B6sfY0ly3YniSj4C9SDsyhPqFFkZVuHJ5IVOfbfZCqLsQ9zhdDByq3R9LSGxOp44n8AyqLhLsXg4C9ZzwlEVTSBNMkpeZDIDXwPes1PXe/rkRc3Z9bLVzxEMyZrnpidHJ3x2m2t6rBre6idGIv7//vrm2nYILemMNI= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=FlTY9oW8; arc=none smtp.client-ip=209.85.208.42 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="FlTY9oW8" Received: by mail-ed1-f42.google.com with SMTP id 4fb4d7f45d1cf-5d4e2aa7ea9so13358942a12.2 for ; Wed, 29 Jan 2025 04:59:06 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1738155545; x=1738760345; darn=lists.linux.dev; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=kZ6nySZDXEYnxo9zaQ2qibAXcWCySP1ewi7gpJhtdt0=; b=FlTY9oW8f9/fw/13pv4LbvawdmfSalb6DrCfSj5+evcKfoAE7XcmuEzxYr0JPsJxal +gAt+s5H41QlmTcZG/3ek2+0sxhEWI17En1t7QLinZHVcNK9Syf8zb7mv5tYdLLVrZuD 3ptMraDy+KIcNGvXQY6bqhqYmlQBcRuAv+3uHsOemiH06BzlMKZlsY6XGYAFrzx0x7iD BvRGZy1NbpTG0JvVuxhL1Ayr/Is76QvAUG+f0x1S2n2WPgyGFWWV86NJXN3+/wL2NBxQ Ec5xMVZXHFE+Zy5KDvWnmzZSnmlfpQEnok64Y/orkcfhgF1+fj4rGg4T7WItwifCc9VV PzeA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1738155545; x=1738760345; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=kZ6nySZDXEYnxo9zaQ2qibAXcWCySP1ewi7gpJhtdt0=; b=W8ymInN1mbi75iHp2RwiNu53zuusYiy7IFgxNnUYtvclqQqkogH6V36kNQr5tagvfw m/splryd2q8uN91k0PnqcLPfFJjbrvs+SCKLMVOg/H3jTvbvU2w1C5GW0SuFpiW8tjLQ X4M2YOSeMWnZfkH/JFMzpafJ5HOslEYL3Q3Bwl5xvESyCzKDgmJb9/u/SARcwPtVZqny q0LKnsgZL/KWy0ol4xz1o/n5AKFTXnebDV3xHwopx3OWEMRcyFVa3baB5PSeY961fzde K5aIl+iEGruA8obeW8vOeiiru0Qv422RF0Pz2wm0J18w39CcCpvVAEdoY32i8migNxMZ 9v2w== X-Gm-Message-State: AOJu0YwUTwZW6Wx8P6gUsVMPqqW86miW3ivsU4pPOgyXJoH1WrcCBC3D /ylYXNJdcDrav0qswWOH3sLhkj/o7XndWxG3WqsUXkmFgQrfA42qi+kqIQ== X-Gm-Gg: ASbGncu51GYb4MRWcXGLfJ080EQXzmqgLblMuGwiT4kYMIiMDsTjJXfofKxeQmYJMRw yYgJbEVw9gdMUG0+CkjQHOIb9f1cAT+ogct2tvU/yVBjZo2aLtxiACHRDAH34S26D3x5AnfYEiO 5dAEQGswxiC08W50a6vbE23fION6GnP4JbTb4EnYQMWMiotxG9aIozBKHwUKOt6Vt7z45jGh7jY dhMctuA4m3s2vAKDGWONn8lwo80CS8QEWTpxxAXp4zeFogXbzG+HAci9xJ0eDWVgmUe/z+zp2UM HOftDvRVThbaN1exDv4v+g== X-Google-Smtp-Source: AGHT+IGPjXCbKMwb8El5TVeme64FwOdzK+yLz8nbF58j4Lk9outICHyLEOinjfOzdEUPyT7nhbmTIw== X-Received: by 2002:a05:6402:3589:b0:5dc:6c1:816c with SMTP id 4fb4d7f45d1cf-5dc5efa8ee0mr2243435a12.1.1738155544817; Wed, 29 Jan 2025 04:59:04 -0800 (PST) Received: from syrah.fi.muni.cz ([2001:718:801:22c:1369:c402:50e6:7236]) by smtp.gmail.com with ESMTPSA id 4fb4d7f45d1cf-5dc186c9115sm8537417a12.54.2025.01.29.04.59.04 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 29 Jan 2025 04:59:04 -0800 (PST) From: Milan Broz To: dm-devel@lists.linux.dev Cc: Milan Broz Subject: [PATCH 2/3] dm-integrity: Document Inline mode for storing integrity data Date: Wed, 29 Jan 2025 13:58:56 +0100 Message-ID: <20250129125857.252448-2-gmazyland@gmail.com> X-Mailer: git-send-email 2.47.2 In-Reply-To: <20250129125857.252448-1-gmazyland@gmail.com> References: <20250129125857.252448-1-gmazyland@gmail.com> Precedence: bulk X-Mailing-List: dm-devel@lists.linux.dev List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 This patch adds documentation for new 'I' mode for dm-integrity introduced in commit fb0987682c62 ("dm-integrity: introduce the Inline mode"). Signed-off-by: Milan Broz --- Documentation/admin-guide/device-mapper/dm-integrity.rst | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/Documentation/admin-guide/device-mapper/dm-integrity.rst b/Documentation/admin-guide/device-mapper/dm-integrity.rst index d8a5f14d0e3c..c2e18ecc065c 100644 --- a/Documentation/admin-guide/device-mapper/dm-integrity.rst +++ b/Documentation/admin-guide/device-mapper/dm-integrity.rst @@ -92,6 +92,11 @@ Target arguments: allowed. This mode is useful for data recovery if the device cannot be activated in any of the other standard modes. + I - inline mode - in this mode, dm-integrity will store integrity + data directly in the underlying device sectors. + The underlying device must have an integrity profile that + allows storing user integrity data and provides enough + space for the selected integrity tag. 5. the number of additional arguments From patchwork Wed Jan 29 12:58:57 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Milan Broz X-Patchwork-Id: 13953732 X-Patchwork-Delegate: mpatocka@redhat.com Received: from mail-ed1-f48.google.com (mail-ed1-f48.google.com [209.85.208.48]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 74742C2E0 for ; Wed, 29 Jan 2025 12:59:07 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.208.48 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1738155549; cv=none; b=AKmHNwbyjt3/2T7BlFmz0IWHLbtdbpTGcZ6axGd22glhxssbfIm89fCOZyq8tum3kj5lDqe61gL778sxRUzpfJ/A4LkoYrhuBaVEts8HrgBtfCzTwvrIu3SU+7XUXZTnR+Vj6W+Ps3nsj0DVGbq0U31oOWANtXMxoyb8xIf3J9E= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1738155549; c=relaxed/simple; bh=mn/Iu4vck2zoNoFdfEsTsKoU50+fcOBn+RnOc9kbLd4=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=su0Zstq/m+nOq6pArxhKtTuIgW7yxM+iacrjvK98s/rgFB0aEeW8U8nL+MgGpMmHXnk/UJwgKi8wCm9+XMbF+AC1JGB3PiNzFTn1ARuqTkefgyfbSsuDw/sQHzX+wixFnZhIlDvIsUC7iAWOrRXJQPirttskoxv8ZL1PCwXkUls= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=a4jyPAaY; arc=none smtp.client-ip=209.85.208.48 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="a4jyPAaY" Received: by mail-ed1-f48.google.com with SMTP id 4fb4d7f45d1cf-5d96944401dso11302134a12.0 for ; Wed, 29 Jan 2025 04:59:07 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1738155546; x=1738760346; darn=lists.linux.dev; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=G40G1T9SUUvupscQgoMk+NwyLFLkXFcpsWcAlUwTaJI=; b=a4jyPAaYMBjxpHXgmUcpBx6fdMpEie05vtw2R2pUhtdSO6lKsdKgBvutSTzd9hy3C1 8PI+lDkH5UL0bgBV0PQF9GYeUefJXgCimlhhcjMf/U8YxiJIdNjkFweiMKGNAwZVZZLL Edy2En+daVry/tmK8Fh2PVGSxI+BUmJGuodeeTbyP/T5pCf2YNKG+lJf9JQFQFHbQfgV 9N1H6oDNmQe31FetcvRYLm73oz+vcLch4RZ6Zrd5l6FDx1ykOwQM07Sufkq5u4caeZ7n MMSo8/Hr9qr08UzVr5oxumYOCu9FdqpfJSxfcCPcgW3kyJmK3hQwBoKdN3WWBxRelu2a 6RQg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1738155546; x=1738760346; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=G40G1T9SUUvupscQgoMk+NwyLFLkXFcpsWcAlUwTaJI=; b=EHbOm3C1baStVg1LgrXXB2r3Q9a2x/vyR1ogMfInUwKC4h0qEFI2vse8N6pKM0dG7J mF36+Pp7nZBziNGS2aj2YUx2pOLMMb6xZTBVRSEq6MXJlyu8pStN7zWKPSyLICoeY19k O4Wwx8XpqPDH/vFPn+SHPtOGs84mHxIZufzwIo5DlApoWi1bqr+UY8vcaAWJCLfqGZ7v r5o+R0Q7TuQlBsILWsBoZQdYGo6IXaPoWXol+RllzvASxLO8zoNXHAwgIHc1NpzeF1Nk Yg+e0BzUUP8K5qor5JC1oExsQP/KEfngdkYwTrNEn4uHKTZKs6sTrM15bKrMc4ERogMd z55A== X-Gm-Message-State: AOJu0YxqQf4GmivtGnmR+pssNZDjJWsdhELyw13IwkfHELynqiWP9YMe zbI2Q1CniHQjZm3hq2kRR6gb8fDQXa1Vln7vuJX9EEu9fM15hFV1Vn4Rqw== X-Gm-Gg: ASbGncsY69zEjBWr1WMKJLTzsFiFSUC9Qhfw8z5cZXlG9Rdb8ENnZSiI60gzVqoYfrs RaPZKOkUF42+B7qCtyKxuPuMhh/pIgni+Zsv0KKeOcixaBRW5r1JfUeApqnWuXpabip5xTk2tw/ t47mOHzRdPT4Re1kEeOHhSIVjxGepFiTRm3XSv8xcFXDlXNorL3OSY5+wXL9xuhjt7WBm/+2Muw +OqZJYqbkQcWo9mpeV3cRLHA+AKjfj8RoYGr2TZj20LIJhji4TJRa3Hl6s4/+C+4ksjxIwZVpZT ETwGohUVs7e/JJ9GbaWeVQ== X-Google-Smtp-Source: AGHT+IF62U0Vtl/z45QR0pI+nCippifMDlXOvbjODPi2TutH+2nK7nzwydBin9WcrJBv4ZuyFKfRxQ== X-Received: by 2002:a05:6402:1ec9:b0:5d0:e410:468b with SMTP id 4fb4d7f45d1cf-5dc5efa8adamr2647746a12.2.1738155545680; Wed, 29 Jan 2025 04:59:05 -0800 (PST) Received: from syrah.fi.muni.cz ([2001:718:801:22c:1369:c402:50e6:7236]) by smtp.gmail.com with ESMTPSA id 4fb4d7f45d1cf-5dc186c9115sm8537417a12.54.2025.01.29.04.59.04 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 29 Jan 2025 04:59:05 -0800 (PST) From: Milan Broz To: dm-devel@lists.linux.dev Cc: Milan Broz Subject: [PATCH 3/3] dm-crypt: Document integrity_key_size option. Date: Wed, 29 Jan 2025 13:58:57 +0100 Message-ID: <20250129125857.252448-3-gmazyland@gmail.com> X-Mailer: git-send-email 2.47.2 In-Reply-To: <20250129125857.252448-1-gmazyland@gmail.com> References: <20250129125857.252448-1-gmazyland@gmail.com> Precedence: bulk X-Mailing-List: dm-devel@lists.linux.dev List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 This patch adds documentation for new option introduced in commit 4441686b24a1 ("dm-crypt: Allow to specify the integrity key size as option"). Signed-off-by: Milan Broz --- Documentation/admin-guide/device-mapper/dm-crypt.rst | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/Documentation/admin-guide/device-mapper/dm-crypt.rst b/Documentation/admin-guide/device-mapper/dm-crypt.rst index 9f8139ff97d6..4467f6d4b632 100644 --- a/Documentation/admin-guide/device-mapper/dm-crypt.rst +++ b/Documentation/admin-guide/device-mapper/dm-crypt.rst @@ -146,6 +146,11 @@ integrity:: integrity for the encrypted device. The additional space is then used for storing authentication tag (and persistent IV if needed). +integrity_key_size: + Optionally set the integrity key size if it differs from the digest size. + It allows the use of wrapped key algorithms where the key size is + independent of the cryptographic key size. + sector_size: Use as the encryption unit instead of 512 bytes sectors. This option can be in range 512 - 4096 bytes and must be power of two.