From nobody Sat Oct 4 14:33:04 2025 Received: from mail-pf1-f175.google.com (mail-pf1-f175.google.com [209.85.210.175]) (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 7E6152C3264; Fri, 15 Aug 2025 07:56:49 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.210.175 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755244610; cv=none; b=EhVCoew4rvO6FJdFR+jmS0gH8IZnSJwvg+2XpBKxKQJnqZ+0yhoNFepaslTJF62bFqc7nNGEqgWi65wt26+P0TYLMxV6f+9al42PqpNCxf0BJ0gP79sgELvjxSUYvw4phRXsPElsRMezvksJKd9FQ+p4zoS4lnil6Xb09RyovoQ= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755244610; c=relaxed/simple; bh=LhTo5cCdwQe8pulukYwJ1m6eHZbBpd52JQDpSBVReeY=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version:Content-Type; b=k6Bl7DK1PDyU/frcCRWGKXLuOPuZzRhLaA36Xlnkz1mmRZPFmxr9GZex342o+6t5vtEb4usBnLiLDDoVZyP/22CopN0WfThCbyZBkkomP9kNGUrNS45XF2fdmutG8NIS+H4bwvZqDXyK3Wigqi3aQAuEqEp+qwf2KRMho5v1LuY= 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=Olvlv3eR; arc=none smtp.client-ip=209.85.210.175 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="Olvlv3eR" Received: by mail-pf1-f175.google.com with SMTP id d2e1a72fcca58-76e2e60433eso1416135b3a.0; Fri, 15 Aug 2025 00:56:49 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1755244609; x=1755849409; darn=vger.kernel.org; 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=+F9NmXtez3GpQw5LIS9Oo9You3cZ7+F/dZD1WEotmBQ=; b=Olvlv3eRPjbyaxlmiY/KydZ6YuteKczH0Le1idMo5PL1Jh7XTEI+7RhX0KfSs/puZ0 iSq+TKtrx7bRTXnuVVbH0dTp3m5i30V6NxmKNQuQ3rcWVnwXabOhZS9JG97faexrl+5Y sqYNRLBvOb1/G7oyvVcO+H49oRCboCVCIriuNjZEopGDHahFbvnLGsowPIlibamKjNvD Tkytzwo5juseNlTiq4lvhcFOTv1IiGxCKBXSQeadVIKWiBY6xsGOTaT0ETnW4CyN/qA0 JONnI6VYjWdULDmoEn+unHJqgPh89mjH8nMmbC567F+fmTRwWOo8MoxWZ2tpQ2Nq5Dmz z1Bw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1755244609; x=1755849409; 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=+F9NmXtez3GpQw5LIS9Oo9You3cZ7+F/dZD1WEotmBQ=; b=tljQ83vgpUOe4vmKMxKlTki2TZ7CrdK8RtU/Xrc/GTT0SvHI6BtiIiIERCQ4jnGVNv 3zbW37iy2DY+nCCPrkAnKRB3JIQeyysoRzNTankwFeA5Aew/LqLYvZssz4KqvwwAVKk+ YFgTG6x86YgTYeIbLDy/utHraU7gHrWd5pRLLhpxF/WoMCTTkWzby0+Un87xup62i+M2 04ozcYrbGENsDxkvfQp/iS74ctSvSgLScjWyN/c3wRq7zw+8PVFn/99zrOqzAECGs7Vc a/4CiEnVHIbFdcnQa2FngBJe2piIB0pNn71FuLZbnnWf7uy9+f4h33D3IbpH6BxFZlJ3 Qazw== X-Forwarded-Encrypted: i=1; AJvYcCXL6DX7C2zoPa9ZkqAOb+rcitUFJsXFjm7xrMnNUJ+jkeg09AQ4a9mX56J5O4YWiqJTkderot3BO88=@vger.kernel.org X-Gm-Message-State: AOJu0Ywc342472dtv8BmUtmQl0pvOWiEhaFyiUMBAWONjNduJLAuL90s w9bdkcwJGS19rKW8RRXEEx65hnE5qk302oqDJfvMhTA67r8YWlwV6UQE X-Gm-Gg: ASbGncvC+J1tD2/EJ+jAUP5LcK3n7ucE/H6K4ExYfsA6xVyJ08h9unHGvcyVSyosbWR iBbbmjm00eA6ZDkN8SARPuxveOqblXBYDqLzXB6Sa/lYVnm9bzHoQXrvMG07zqlci8lnBpmjev9 ZCZ6oL+5aHDTuc2GBLPiWUcmetKAaGUJblggxJAeRTCWkhL8nLqtBsBUNlI951AJ2bi3fX64mg7 s+i9kukYTWEQ+Qt0S0/QuyiBxWwJDdYYA0g9+vODuF6qS5nhoeC9ShygMdfWjqYDswR7V8w7KQk l++GFxVoTVvkdGsgPHf6ivLE9pjhbkW/GVxpMi4MJSBFMonXjksa5BFEjVMsXn4NktrH5ociOJ1 Tuq9Mm4vSTzUGzj7Q7GLiZg== X-Google-Smtp-Source: AGHT+IG2n5h40h0uXDvhOaYG1ODrl6MH66mS0Kg0YJ2Fc6MbnZC5W+akAaB8uZW/JgLmbU+Z8yK1Xw== X-Received: by 2002:a05:6a00:993:b0:76b:fd9d:853d with SMTP id d2e1a72fcca58-76e447bf915mr1371167b3a.14.1755244608609; Fri, 15 Aug 2025 00:56:48 -0700 (PDT) Received: from archie.me ([103.124.138.155]) by smtp.gmail.com with ESMTPSA id d2e1a72fcca58-76e45292dc1sm587699b3a.50.2025.08.15.00.56.46 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 15 Aug 2025 00:56:47 -0700 (PDT) Received: by archie.me (Postfix, from userid 1000) id 2B3EB42BF64F; Fri, 15 Aug 2025 14:56:40 +0700 (WIB) From: Bagas Sanjaya To: Linux Kernel Mailing List , Linux Documentation , Linux Device Mapper Cc: Dongsheng Yang , Zheng Gu , Alasdair Kergon , Mike Snitzer , Mikulas Patocka , Bagas Sanjaya , Stephen Rothwell Subject: [PATCH 1/3] dm-pcache: Remove unnecessary line breaks Date: Fri, 15 Aug 2025 14:56:14 +0700 Message-ID: <20250815075622.23953-3-bagasdotme@gmail.com> X-Mailer: git-send-email 2.50.1 In-Reply-To: <20250815075622.23953-2-bagasdotme@gmail.com> References: <20250815075622.23953-2-bagasdotme@gmail.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=3370; i=bagasdotme@gmail.com; h=from:subject; bh=LhTo5cCdwQe8pulukYwJ1m6eHZbBpd52JQDpSBVReeY=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDBnznq9XeaPT6ddyxvznDt+WUuX/07Z5cE+YENi4cufF2 jXZquqFHaUsDGJcDLJiiiyTEvmaTu8yErnQvtYRZg4rE8gQBi5OAZjI+lyGf/pbZkxcdY+ff7Xm 0vMFG9oTpi0tzT3Lfl3geHvzYeN9N/gY/nCs/fxc/TBncZFI1oe4ac8iHrQ8vvOE+ev1PHfD+hm Ld7IDAA== X-Developer-Key: i=bagasdotme@gmail.com; a=openpgp; fpr=701B806FDCA5D3A58FFB8F7D7C276C64A5E44A1D Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Sphinx confuses line breaks that are placed right before section headings with title heading overline. This causes htmldocs build to spit out markup error: Documentation/admin-guide/device-mapper/dm-pcache.rst:27: CRITICAL: Title o= verline & underline mismatch. Acked-by: Dongsheng Yang Reported-by: Stephen Rothwell Reviewed-by: Randy Dunlap ---------------------------------------------------------------------------= ---- Constructor =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D [docutils] reStructuredText markup error! Remove line breaks to keep htmldocs building. Fixes: 6fb8fbbaf147 ("dm-pcache: add persistent cache target in device-mapp= er") Reported-by: Stephen Rothwell Closes: https://lore.kernel.org/linux-next/20250815130543.3112144e@canb.auu= g.org.au/ Signed-off-by: Bagas Sanjaya --- Documentation/admin-guide/device-mapper/dm-pcache.rst | 8 -------- 1 file changed, 8 deletions(-) diff --git a/Documentation/admin-guide/device-mapper/dm-pcache.rst b/Docume= ntation/admin-guide/device-mapper/dm-pcache.rst index e6433fab7bd64b..ecd015be798243 100644 --- a/Documentation/admin-guide/device-mapper/dm-pcache.rst +++ b/Documentation/admin-guide/device-mapper/dm-pcache.rst @@ -24,7 +24,6 @@ Quick feature summary * Pure *DAX path* I/O =E2=80=93 no extra BIO round-trips * *Log-structured write-back* that preserves backend crash-consistency =20 ---------------------------------------------------------------------------= ----- Constructor =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =20 @@ -57,7 +56,6 @@ Example The first time a pmem device is used, dm-pcache formats it automatically (super-block, cache_info, etc.). =20 ---------------------------------------------------------------------------= ----- Status line =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =20 @@ -97,7 +95,6 @@ Field meanings ``key_tail`` First key-set that may be reclaimed by GC. =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D =20 ---------------------------------------------------------------------------= ----- Messages =3D=3D=3D=3D=3D=3D=3D=3D =20 @@ -107,7 +104,6 @@ Messages =20 dmsetup message 0 gc_percent <0-90> =20 ---------------------------------------------------------------------------= ----- Theory of operation =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =20 @@ -151,7 +147,6 @@ If ``data_crc is enabled`` dm-pcache computes a CRC32 o= ver every cached data range when it is inserted and stores it in the on-media key. Reads validate the CRC before copying to the caller. =20 ---------------------------------------------------------------------------= ----- Failure handling =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =20 @@ -163,7 +158,6 @@ Failure handling rebuild the in-core trees; every segment=E2=80=99s generation guards aga= inst use-after-free keys. =20 ---------------------------------------------------------------------------= ----- Limitations & TODO =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =20 @@ -172,7 +166,6 @@ Limitations & TODO * Table reload is not supported currently. * Discard planned. =20 ---------------------------------------------------------------------------= ----- Example workflow =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =20 @@ -196,6 +189,5 @@ Example workflow umount /mnt dmsetup remove pcache_sdb =20 ---------------------------------------------------------------------------= ----- ``dm-pcache`` is under active development; feedback, bug reports and patch= es are very welcome! --=20 An old man doll... just what I always wanted! - Clara From nobody Sat Oct 4 14:33:04 2025 Received: from mail-pf1-f170.google.com (mail-pf1-f170.google.com [209.85.210.170]) (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 627452BDC09; Fri, 15 Aug 2025 07:56:47 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.210.170 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755244608; cv=none; b=aDRiD9UI2uSlJuTNnEj7OxAYzM9P5siFxi1XGnxeD17s22/F2iQCNYLpYzwoZxL3jq2ZRc5UC0POzopFT+c3rh3KbWcnA+svulw54+xTGDrSZoV0Hf+qEILPuvJiL9aeqZ64RnegGm7YUVZ4JM5h4bqVi/rUW/Xb2c2oAIQgL0I= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755244608; c=relaxed/simple; bh=BSdi2w3mGBfqx7vQ62yyAGKSjWZXG1QSCbm15ZVydcE=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version:Content-Type; b=FqmUZR1e+0dhv7hG8W+ExJauS/TbQducVKViYfSQfnndFd07bgRpeSyHFbZdoVBX2rF9c9IEltbT8AX7QS40YIfKbjG5tIgOObSV2TLtQ+XvaTtSxYz2U8gA141u5opXn1fdgZ2UEGlP+Dky8PyLmRIvx6QSL1vFhdnVsqtat2A= 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=e3TicxVS; arc=none smtp.client-ip=209.85.210.170 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="e3TicxVS" Received: by mail-pf1-f170.google.com with SMTP id d2e1a72fcca58-76e2e614b84so1826594b3a.0; Fri, 15 Aug 2025 00:56:47 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1755244606; x=1755849406; darn=vger.kernel.org; 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=4SqBwk/eT0E+fNoZp9YX9tGh8FiPKp3ALbCTa/kbWN8=; b=e3TicxVSX7l2Brq0uuZj1xw8FeDIwxSZZjwRtq72jdiEpjHyBc0a3JSie8ORzUI/bu zkYx8/6ia+5Vau/KhVHWMWSIJIdxQ0fAcxaK2junhk+4/EvMi2rjr2GOeoPRq2oF/tFf 9eQXVcqVZmr1Ra+ABsjm3JuljmMJpUzEq/QEo5d8OD0p1YhnThaqveYYAzQ/ZI1pAK8h NNB9AUZCUB+mxYrll5sI+KyUhCplVv8fhuXt0a2QdLCdY2f49t27VcSID+pyz+Lwad+6 xmLtgmF9P+lk2gGDt/DrRX2sHyU/GakE9heKpeoz3TWNZyz/2pi/2glZgBtYV1w9TPoy WMxg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1755244606; x=1755849406; 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=4SqBwk/eT0E+fNoZp9YX9tGh8FiPKp3ALbCTa/kbWN8=; b=FUBLxuIkLWvHuiJ73Cpn8D5fc4MzMnG0EzZT2wfgKoUClXpZa++MJILBGXMZF0AE80 /Tn919f6SqYAcQcoB+9r/kzKpbWM9O9bMaL66hJpTzDvRBDCvR40hf2ThhQ92qwO6b3f L9tJO64mI4issqhSwjsuBXVsPHgmnzWFcQb+0vbOxBKhPfE2u7aZxyeH/2rZQ3M+KGI2 lknAfE0maZ07lWPYdApb8OSE/U9Qm+y42KM+hBAhBeimISBgYA0S1id6LKfvo81iQmnz JSFT7+4i819/jqkwoQMBjIyGOR7vpc0CWF53QIFTrtjNwBagKjHjL6+A4LCByZ1/YOhe nLIA== X-Forwarded-Encrypted: i=1; AJvYcCWLXtmX4D6GFT8GDvWHENYTt41KajDiklNubx1gU22JQOGZJXRXAuvupYoOh1jZpVbad5Pf+TmsbXw=@vger.kernel.org X-Gm-Message-State: AOJu0YydCUFUBuvCTz28OO0xZlhHR4I7ku5GCFFjpeByNNz6tIUgdnWE kjYGTXwvZ6o06PMpDM6247s48tIGEEkGDWTKu3tdcXYwjZdS8BXN6fdc X-Gm-Gg: ASbGnct6uFSmMwJNL+WXUepmwtrIhVEeIpmqXWAN86vKaA6/3ONuJ4P29Df+4YjCwdr HACblrsQHz6vhl025ihZewTpCSfUowgA1ct/g+FwKW3c2dFMdDLmc1utJhVHpPhTwg/q2bXdu10 eTvqfMBt91vKdDgaQQAx83d3oqz2k4bhtXez3fj/HUDWL56n4wtOiCzBIGePKy2Q3I3kg4KfpNr KhmWegFmEXYwlaF3P52PdSaBz62g5chuQY6gyXLgVap2s+9m9chXbagX3xhpBHTkTi3h/Zf7X4t DRho9mUTh+LN80mKe4jNeI0YNl8YWQMEErfmDnUcxc5CU4xsq+JaVoSIns3Yc3LcXNydZ1DydUE sIZp6p2mG13LyLqQewGAJgQ== X-Google-Smtp-Source: AGHT+IF9ucjW/KtwwO3q2uYVf9EFn3Mg/zyi7hUeanmOPhSmnzBBOZt2Q3XjmVtqygSPlYAgPovRow== X-Received: by 2002:a17:902:d488:b0:234:a139:11fb with SMTP id d9443c01a7336-2446d8b1f78mr16115555ad.27.1755244606499; Fri, 15 Aug 2025 00:56:46 -0700 (PDT) Received: from archie.me ([103.124.138.155]) by smtp.gmail.com with ESMTPSA id d9443c01a7336-2446d54f8b9sm8483715ad.130.2025.08.15.00.56.44 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 15 Aug 2025 00:56:45 -0700 (PDT) Received: by archie.me (Postfix, from userid 1000) id 3A2C142D95C7; Fri, 15 Aug 2025 14:56:41 +0700 (WIB) From: Bagas Sanjaya To: Linux Kernel Mailing List , Linux Documentation , Linux Device Mapper Cc: Dongsheng Yang , Zheng Gu , Alasdair Kergon , Mike Snitzer , Mikulas Patocka , Bagas Sanjaya , Stephen Rothwell Subject: [PATCH 2/3] dm-pcache: Use bullet list for data_crc constructor argument Date: Fri, 15 Aug 2025 14:56:15 +0700 Message-ID: <20250815075622.23953-4-bagasdotme@gmail.com> X-Mailer: git-send-email 2.50.1 In-Reply-To: <20250815075622.23953-2-bagasdotme@gmail.com> References: <20250815075622.23953-2-bagasdotme@gmail.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=1798; i=bagasdotme@gmail.com; h=from:subject; bh=BSdi2w3mGBfqx7vQ62yyAGKSjWZXG1QSCbm15ZVydcE=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDBnznq+fdHNXPKfJo/Se5TdDNSUC+2WSz+Q9dHljJ3fI2 t1r67ajHaUsDGJcDLJiiiyTEvmaTu8yErnQvtYRZg4rE8gQBi5OAZjID0FGhs4d39cL3bu/wzi4 Rtt8jb25+P0ktTNhU/1spt44sqC+7yQjwye7tXwp126sCzNKE+rjfPnGNjSFc8K6u2rXVz/M87/ 5jgEA X-Developer-Key: i=bagasdotme@gmail.com; a=openpgp; fpr=701B806FDCA5D3A58FFB8F7D7C276C64A5E44A1D Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Sphinx reports indentation warnings on data_crc argument description: Documentation/admin-guide/device-mapper/dm-pcache.rst:44: ERROR: Unexpected= indentation. [docutils] Documentation/admin-guide/device-mapper/dm-pcache.rst:46: WARNING: Block qu= ote ends without a blank line; unexpected unindent. [docutils] Fix the warning by using proper bullet list syntax. Fixes: 6fb8fbbaf147 ("dm-pcache: add persistent cache target in device-mapp= er") Reported-by: Stephen Rothwell Closes: https://lore.kernel.org/linux-next/20250815131115.45518c74@canb.auu= g.org.au/ Signed-off-by: Bagas Sanjaya Acked-by: Dongsheng Yang Reviewed-by: Randy Dunlap --- Documentation/admin-guide/device-mapper/dm-pcache.rst | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/Documentation/admin-guide/device-mapper/dm-pcache.rst b/Docume= ntation/admin-guide/device-mapper/dm-pcache.rst index ecd015be798243..02cea738ae131b 100644 --- a/Documentation/admin-guide/device-mapper/dm-pcache.rst +++ b/Documentation/admin-guide/device-mapper/dm-pcache.rst @@ -40,9 +40,10 @@ Constructor ``cache_mode`` Optional, Only ``writeback`` is accepted at th= e moment. =20 ``data_crc`` Optional, default to ``false`` - ``true`` =E2=80=93 store CRC32 for every cach= ed entry and - verify on reads - ``false`` =E2=80=93 skip CRC (faster) + + * ``true`` =E2=80=93 store CRC32 for every ca= ched entry and + verify on reads + * ``false`` =E2=80=93 skip CRC (faster) =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D =20 Example --=20 An old man doll... just what I always wanted! - Clara From nobody Sat Oct 4 14:33:04 2025 Received: from mail-pl1-f169.google.com (mail-pl1-f169.google.com [209.85.214.169]) (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 A6B7427C84E; Fri, 15 Aug 2025 07:56:45 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.214.169 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755244607; cv=none; b=HWfJ3As+oTrJCRVBbZE9FWcEaWfI9QUl0hJKmjOZ4gW97KfxW+V3NYtZZqc3h9rCfumBf9lRqs66HpsEwp/bEjp/DoetkVBNcTWIQjiIVcrHuf7K0AnB/NIo6ZGx/LUPJ74PxptZ0D/2qocA264gM15TM3t4MztIL9uiJWbu3C4= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755244607; c=relaxed/simple; bh=9zyrvDyjfVYyWsuS94gwRz8UnTctJ6fTZCf1KTGT0T0=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=eCw2iuilJufSrcgUGaZONrDlphMW4ouSSYIcvOgEqB8iXn3F5cC8pFXFhabLpbj3XcoePTpgwyT4v7TpNXPMa5LSGCGtkZRTwFOThyxj+dP7BKH6HfG5vlwQDOCCkCi6Y4UYvgBsHFAf1v+aJl3xmG0k43NNKPmrMcSDXPs0Ato= 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=NZ/rdNuE; arc=none smtp.client-ip=209.85.214.169 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="NZ/rdNuE" Received: by mail-pl1-f169.google.com with SMTP id d9443c01a7336-244580523a0so16246185ad.1; Fri, 15 Aug 2025 00:56:45 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1755244605; x=1755849405; darn=vger.kernel.org; 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=94HKFscQ+ugjTxu5GnpFNBaeL2IHgfjLAhQn0iZHS7E=; b=NZ/rdNuEpZFOY9AzTY5SqejCCBec0C5q2Ry7PJ4YgFSkZgjw0trTyJuNJlWqIYmUBp E0CPykjJ3Dkh/CteL0y+M+Xfg4h8487y9ZXaL/pcqTgY2X3d2m6sWacKSHGryCp+NAhU mYyKBxmLjLscAZaC7J0clDpMsj8F+NgIfehnntjFqnaahqxIseGNtE3ugmvt9ECzd00F JvhuhGeX9EowLPZqPFpt0EvfSqVs+C/VfJmxdcyYHTOOsv0vidj+ouiW+nQJIFt7SQQC 4JZIfTDIGsi/ligdKdeLbz21tDNR/gA8vJkHME3BML53NFp7njIW5zFSPN1eRcluvNtL AWmw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1755244605; x=1755849405; 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=94HKFscQ+ugjTxu5GnpFNBaeL2IHgfjLAhQn0iZHS7E=; b=pLgwG0G5DE11BMlIIVX9GzkYekVw1TtlPRu0vxQb6OeFjJ2YctCDG7hPUVZvvGiwKd Ugtsxem4sQ0lEZ94ZItZX4zY98lyOg6OlWEkzYqhxMxl+Nu0+zyr9PDzXI5rnqPg/odg bkP5tB2pQmlMLjmuEWksmJIaXJDDKe9SZQAWZ72sZ3zl+g0Cr1d/1XYBIwaQBUWwMgPQ 1SE0Zm75Bm8r4Y8M38KkJXm0VYy8OZ+UOBv6bvOxp5Ip6u/H//RMDoO62sHojl/cEsp4 7a11kQhWTXsuC26LnWePcnxqi+9bXhDSOPX4uZZ3UY1+Fee9gZJVaSkH2UxI234DQVLm oZsQ== X-Forwarded-Encrypted: i=1; AJvYcCUOOyHchfw3etpUssLqPLirvg9PtN6TLj/bAgnuhYOqmLiuTgjtPmPzyQ0A9938cHNO8ocqpHjovXc=@vger.kernel.org X-Gm-Message-State: AOJu0YxJSmVr9der3JQJc+F7wpW9XJcTUtjdEM+6axnTC0BSgiKP+bFK Zxq7Se6TDxSYvbl/oo0gyBd/JmqbYsrxRUANUyYjjZrMXDnvuRuKyRnN87nUtSRL X-Gm-Gg: ASbGncvcyvLdAx0WoKhmaTIWnWvxhdQGm+5zUI49oKAzcSimbDfNHExEw94B8iOzWOo 6kORTNgWhKQ7WU+ctnnnq/NvKfuxMG/5F+r8BG2M9glC6mxS0fP4CXSshcnnKSYJG1BZ2o1Tqlp eBlaP71/COqHme4dEmLBM3MSBjQWAWMIbCYfozvu+6bDyF0laOQ0r2EnK/K56HS15y1fVA362LQ aK1g3i1tru9aSPxBjq1hxd6Rm+xEp1c+TEcg2HD3Us95RyqqTEz7RNstwt7pOgtJq9k6mw5ikW4 BLYCYM32LlP0qai26K/XfYmmmyfWes7WW5f4Jwbw6JRYdDttskxG3hGATFqWhBTf5NYzvjHS+D+ LFnX98QxTn4xLT8OXrRisGQ== X-Google-Smtp-Source: AGHT+IENpZ3DUGjafhYrp0JjY0F8GbPlJ45vECelGvT3ZIvS7UFcIYwlqSHw/Sa5we/uG9E5ip1mjw== X-Received: by 2002:a17:903:2f92:b0:242:9bc6:6bc2 with SMTP id d9443c01a7336-2446d9fcb10mr15906305ad.57.1755244604805; Fri, 15 Aug 2025 00:56:44 -0700 (PDT) Received: from archie.me ([103.124.138.155]) by smtp.gmail.com with ESMTPSA id d9443c01a7336-2446d53eec7sm8353225ad.118.2025.08.15.00.56.43 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 15 Aug 2025 00:56:43 -0700 (PDT) Received: by archie.me (Postfix, from userid 1000) id 5148B40AB483; Fri, 15 Aug 2025 14:56:41 +0700 (WIB) From: Bagas Sanjaya To: Linux Kernel Mailing List , Linux Documentation , Linux Device Mapper Cc: Dongsheng Yang , Zheng Gu , Alasdair Kergon , Mike Snitzer , Mikulas Patocka , Bagas Sanjaya , Stephen Rothwell Subject: [PATCH 3/3] Documentation: device-mapper: Add dm-pcache docs to toctree index Date: Fri, 15 Aug 2025 14:56:16 +0700 Message-ID: <20250815075622.23953-5-bagasdotme@gmail.com> X-Mailer: git-send-email 2.50.1 In-Reply-To: <20250815075622.23953-2-bagasdotme@gmail.com> References: <20250815075622.23953-2-bagasdotme@gmail.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=1099; i=bagasdotme@gmail.com; h=from:subject; bh=9zyrvDyjfVYyWsuS94gwRz8UnTctJ6fTZCf1KTGT0T0=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDBnznq9PdTXSW1PU3DZ9WmNR9v79zHlvucNvJl1J0Ev8k vj7fqRHRykLgxgXg6yYIsukRL6m07uMRC60r3WEmcPKBDKEgYtTACayPozhn1XN6+cHdUquipzf lOt1bXaY8bzPC4Pj4zUcfzlntmu1mTIybEjYN2GSWISwyx25T40z7jVrmrslvPL47Hdi81/eteZ vWQA= X-Developer-Key: i=bagasdotme@gmail.com; a=openpgp; fpr=701B806FDCA5D3A58FFB8F7D7C276C64A5E44A1D Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Sphinx reports missing toctree entry warning: Documentation/admin-guide/device-mapper/dm-pcache.rst: WARNING: document is= n't included in any toctree [toc.not_included] Add dm-pcache docs to device-mapper toctree to fix the warning. Fixes: 6fb8fbbaf147 ("dm-pcache: add persistent cache target in device-mapp= er") Reported-by: Stephen Rothwell Closes: https://lore.kernel.org/linux-next/20250815131115.45518c74@canb.auu= g.org.au/ Signed-off-by: Bagas Sanjaya Acked-by: Dongsheng Yang Reviewed-by: Randy Dunlap --- Documentation/admin-guide/device-mapper/index.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/Documentation/admin-guide/device-mapper/index.rst b/Documentat= ion/admin-guide/device-mapper/index.rst index cc5aec8615765e..f1c1f4b824bafe 100644 --- a/Documentation/admin-guide/device-mapper/index.rst +++ b/Documentation/admin-guide/device-mapper/index.rst @@ -18,6 +18,7 @@ Device Mapper dm-integrity dm-io dm-log + dm-pcache dm-queue-length dm-raid dm-service-time --=20 An old man doll... just what I always wanted! - Clara