From nobody Thu Oct 9 04:14:06 2025 Received: from mail-pl1-f182.google.com (mail-pl1-f182.google.com [209.85.214.182]) (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 07AC828A419; Fri, 20 Jun 2025 10:57:27 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.214.182 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1750417049; cv=none; b=NySPDQByjUc1EVmbnhqMK0Bfji2OTUT7kMZ5qbiA+TyJ/LERfdOBkbk32szqyjeX2oXKUn7oesMh8UPZP7k/NHhaS7FVBOo6RCebQkMDFQvvKmLkqUgvmKqbELjjCu37QFdyk03dgCRHv77dNjqUNCcJFHeBBCyyKpLyg0PINGI= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1750417049; c=relaxed/simple; bh=hdtGy+eE91zOpoxtx7icapkbJlNjxVAS55+I6kWc/KQ=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=oZA5Vptig+5IO+sp2kzRFdIei9PEai5js4+xiMfiVKu8Oqoo1e7HSQpPRC2AZ2T6GwUPFZ4ghjNmeHQAQSEFOpRaCFccMhpqVdAHbeF2v4M/w8SItcxOXqBRNFsADGcx6whOUFjrkLxVYWdz3cOkuOyhBeMKYqA9R5V9KI1teSE= 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=fT1tNTVb; arc=none smtp.client-ip=209.85.214.182 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="fT1tNTVb" Received: by mail-pl1-f182.google.com with SMTP id d9443c01a7336-2363e973db1so11654785ad.0; Fri, 20 Jun 2025 03:57:27 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1750417047; x=1751021847; 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=TzzSaEQGD8In1MJqQue0Y7giT+CuTWR39sy5earL9WU=; b=fT1tNTVbztMS5/E6zt4QGevamwVRmqGC9bUOfodo8uQshftD6lnChnxJ/JIIgqsMVh 58YXfkv2sE/CY34xiS1BxhYcRCSx7ELPyHUrblNfy5iy6KVSsA5DDFGe80HeKdfqa41t pHZzDWJQ6H0FOdmM+bWsNsGGIbcX4Frj0WtvMG8/HMnsNB4xBcIhl8DksZ0/9lL9lFVG gVH1Dvf6pCFL6OAlE2OcPwW6JtXHXgBtmx6YXz4jS/DxlyXgGkn2omx/fKxkfJVPj5n6 LBGbUJWXqCcMnW1dPMPaR/bCTPDEjmCciIdfUjGEtyIEABE13bImWel4/DLlaWaU4iFn a/UA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1750417047; x=1751021847; 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=TzzSaEQGD8In1MJqQue0Y7giT+CuTWR39sy5earL9WU=; b=sTSZVTXVuh5S0az4RxIqBh/KyApsCa9eXgPu4dD+TYZ+z0KtCq+C3EZtySf8K6a+Me kWbCdNw0V38SooVGDjbEI7IToxnBCtrohuYEKO5JvS/4y8hlpBoKcIEiuvWuJZeuVprS K0aMSxt56Q6h3/caQSGLj7Eu7/cAlG3nXYYxMdbZQ++gw7fmDOK/kK1sTo47qimr8H9J UTpCSiXeF62qWVWlOdfp4Ym8SJtAeal8AtmZKp6BxQyMMZoXRiKmsGCQm8gMhheZTKX0 5xxAFRMKC36SZJN/t5DSWBcTbuUaqEi523qnOCXcUhvkXEMQqjO18tB3wyiy6oqFe8As wN9w== X-Forwarded-Encrypted: i=1; AJvYcCV5ig0QroYQTz0Ei12CVH5USdm/PetEuzSD0R+3luRZ/vw603EoqG2z6QpZAD0aBU5gk/rNEgJaTntipA==@vger.kernel.org, AJvYcCWOyvwbLgYd4j/BGdpgp2AcESBrrp9ffXdTncBSCxDbpdITK1SF58GHt4rMSL1wOFOKsyh2YZdN6zw=@vger.kernel.org X-Gm-Message-State: AOJu0Yz89CWGzcIIqkZzZpollmgwb7YSfjRk4HKmKRrMJk93oba4Qjo6 uOdKSemJC7TzUZ1BJJ/glMw6rRaan2Y8HOO5PYQCB+Ml2SMuW15v1Oj+ X-Gm-Gg: ASbGncsPmsPuyAtJATigzRTubCg1M+zJ+4pKCloS6KFnE+UFA2PJ9ECvOIRq5dwshxh /8w0S2EHViKBMmkCFG6a9fJRKlkl54oJGFJRm5j6tvlk7cvYnru5P5XnhWjG+L1OVxUhXunvITu ixxpTCxoVODN+MAh16OeYTJ3vk/Ki8t6WZnEn4JcWAZVMMzandxIQmSvKQPd1Y5ZWrI3Kkn5Y6n w00SWuT68rDemq+hWs3PNmHwKO3lneyk1YDtlRcXlW6eVtuyM9UDrACOSN8XfqNN8f/STvjm3iD 9O7IhHzstq0Yg5uCgexeNwyjmpwB8bdaf/XIHm+m+QrY707Kfj6VuV2s/3BwpQ== X-Google-Smtp-Source: AGHT+IGMK3jxq+z/lqKEo1x3qZ5tRJYa8c2eozM4LXNv+784rUS4wVIsgy3XLPCIQ4geHe3JgbSvtw== X-Received: by 2002:a17:903:2a8d:b0:232:59b:5923 with SMTP id d9443c01a7336-237db0ff56dmr32256975ad.23.1750417047080; Fri, 20 Jun 2025 03:57:27 -0700 (PDT) Received: from archie.me ([103.124.138.155]) by smtp.gmail.com with ESMTPSA id d9443c01a7336-237d873845esm15595775ad.243.2025.06.20.03.57.22 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 20 Jun 2025 03:57:25 -0700 (PDT) Received: by archie.me (Postfix, from userid 1000) id 319E8421D91C; Fri, 20 Jun 2025 17:57:15 +0700 (WIB) From: Bagas Sanjaya To: Linux Kernel Mailing List , Linux Documentation , Linux ext4 Cc: "Theodore Ts'o" , Andreas Dilger , Jonathan Corbet , "Ritesh Harjani (IBM)" , "Darrick J. Wong" , Bagas Sanjaya Subject: [PATCH 1/5] Documentation: ext4: Convert includes into toctrees Date: Fri, 20 Jun 2025 17:56:40 +0700 Message-ID: <20250620105643.25141-3-bagasdotme@gmail.com> X-Mailer: git-send-email 2.49.0 In-Reply-To: <20250620105643.25141-2-bagasdotme@gmail.com> References: <20250620105643.25141-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=3013; i=bagasdotme@gmail.com; h=from:subject; bh=hdtGy+eE91zOpoxtx7icapkbJlNjxVAS55+I6kWc/KQ=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDBmhtveez1j8UP1ew7SQidZOlxq87/z9WTXRXSLNdk+V3 GH+B9O5O0pZGMS4GGTFFFkmJfI1nd5lJHKhfa0jzBxWJpAhDFycAjCRtBiG/57eb5bP5mwuXdVW 4WQhu89HII/VZ/UKlrt9ojfCpm8/upGRYXfGnImyufNXfG83mfpWpvwPw4HTfwzmvnzAea2nbfu fAwwA X-Developer-Key: i=bagasdotme@gmail.com; a=openpgp; fpr=701B806FDCA5D3A58FFB8F7D7C276C64A5E44A1D Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" ext4 docs are organized in three master docs (overview.rst, globals.rst, and dynamic.rst), in which these include other docs via include:: directive. These docs sturcture is better served by toctrees instead. Convert the master docs to use toctrees. Fixes: 0bf1f51e34c4 ("ext4: Add atomic block write documentation") Signed-off-by: Bagas Sanjaya Acked-by: "Darrick J. Wong" Acked-by: Theodore Ts'o --- This actually fixes duplicate label to itself warning as tried to be fixed in another approach [1], hence the Fixes: tag. [1]: https://lore.kernel.org/linux-doc/20250610091200.54075-2-bagasdotme@gm= ail.com/ Documentation/filesystems/ext4/dynamic.rst | 10 ++++++---- Documentation/filesystems/ext4/globals.rst | 14 +++++++------ Documentation/filesystems/ext4/overview.rst | 22 +++++++++++---------- 3 files changed, 26 insertions(+), 20 deletions(-) diff --git a/Documentation/filesystems/ext4/dynamic.rst b/Documentation/fil= esystems/ext4/dynamic.rst index bb0c84333341a5..bbad439aada262 100644 --- a/Documentation/filesystems/ext4/dynamic.rst +++ b/Documentation/filesystems/ext4/dynamic.rst @@ -6,7 +6,9 @@ Dynamic Structures Dynamic metadata are created on the fly when files and blocks are allocated to files. =20 -.. include:: inodes.rst -.. include:: ifork.rst -.. include:: directory.rst -.. include:: attributes.rst +.. toctree:: + + inodes + ifork + directory + attributes diff --git a/Documentation/filesystems/ext4/globals.rst b/Documentation/fil= esystems/ext4/globals.rst index b17418974fd35e..2264b76e873cc9 100644 --- a/Documentation/filesystems/ext4/globals.rst +++ b/Documentation/filesystems/ext4/globals.rst @@ -6,9 +6,11 @@ Global Structures The filesystem is sharded into a number of block groups, each of which have static metadata at fixed locations. =20 -.. include:: super.rst -.. include:: group_descr.rst -.. include:: bitmaps.rst -.. include:: mmp.rst -.. include:: journal.rst -.. include:: orphan.rst +.. toctree:: + + super + group_descr + bitmaps + mmp + journal + orphan diff --git a/Documentation/filesystems/ext4/overview.rst b/Documentation/fi= lesystems/ext4/overview.rst index 9d4054c17ecb7b..171c3963d7f687 100644 --- a/Documentation/filesystems/ext4/overview.rst +++ b/Documentation/filesystems/ext4/overview.rst @@ -16,13 +16,15 @@ All fields in ext4 are written to disk in little-endian= order. HOWEVER, all fields in jbd2 (the journal) are written to disk in big-endian order. =20 -.. include:: blocks.rst -.. include:: blockgroup.rst -.. include:: special_inodes.rst -.. include:: allocators.rst -.. include:: checksums.rst -.. include:: bigalloc.rst -.. include:: inlinedata.rst -.. include:: eainode.rst -.. include:: verity.rst -.. include:: atomic_writes.rst +.. toctree:: + + blocks + blockgroup + special_inodes + allocators + checksums + bigalloc + inlinedata + eainode + verity + atomic_writes --=20 An old man doll... just what I always wanted! - Clara From nobody Thu Oct 9 04:14:06 2025 Received: from mail-pf1-f180.google.com (mail-pf1-f180.google.com [209.85.210.180]) (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 A4829289E23; Fri, 20 Jun 2025 10:57:26 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.210.180 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1750417048; cv=none; b=B72KIaBHoBlS1RaZWoLlNh/xgNshCVtlRyuwZugIv1v9cnSVvAGFIwJygEvbGSg6mypV2T/HkIMYD+MAYUXXtJwxdS0tooqPJMV8te0EBfFfP/q0SlwWdzRmYVOQ1YV3X4BPqlUGCQyvJdZvu2OdzrdD6SdSUlh9ydkxvC+Hytc= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1750417048; c=relaxed/simple; bh=lY/ayXOomIL1r8RZ/GRxVnbF6HVD16IJ2px9/rv4XR8=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=bh0or3BTgOqSki7SWgthhcTmhSO6C3+N6VsCxftPYPjDNs03U6zw5mglRCWO4bKLhgQnEuiJyrd6Bi0wxZ84QSnXFTMXTP+X0HmuOFCE/aLlUAvNvPrzV2besjuahwyYAuGSvBxpLjzrxw6DMH/ZCyjW5ulFNQlAX6ycz2ox64I= 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=f1B6koFJ; arc=none smtp.client-ip=209.85.210.180 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="f1B6koFJ" Received: by mail-pf1-f180.google.com with SMTP id d2e1a72fcca58-742caef5896so1244766b3a.3; Fri, 20 Jun 2025 03:57:26 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1750417046; x=1751021846; 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=vnAiS/NJ2KAGX2dC4sWVLB1kQYs6SJdUQZ+4vbLgyl0=; b=f1B6koFJ7XsnT64RNIdO/kCzaAw2qSB9/SiUD7yi0kW+qvNZ5yN/pMU7j87n7zdWCH 9kBdO4aWr108pTRqWMV40PervHr+VBjx0ue4Y7lUgSaoKjn5CGfF5ZlvwfD8t6bHfd6n Wz9nbdarRjN2uc7c0KXGumi5wCqbqU3hQoq88BJmwuiOn/DCbKAhHSCJfdnmkqhkqwbq juv1I6mUO+zuWsf38/rlmko60C1y3fE6ik5DhQAz6tFX3pNJjMh6/z5lfflhE+uf4h6s o98BSh/4yQ/A4kI2nCzhF93VHQII6JUx8xp/4SnJDAuS9TI1XHJuHThqWAr5E8gRknUo G+qg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1750417046; x=1751021846; 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=vnAiS/NJ2KAGX2dC4sWVLB1kQYs6SJdUQZ+4vbLgyl0=; b=KqXc9jiAsj0adlH9N7WFuSxsEntrNLLKYqo1owWw/0LizefDZm05B+82led/4CauQ8 +dL4DHg/57nZdG/DV7MjWflfqZYuvAbDTwR1RVXmGaXHQK/CGfvs//Jv7VXSxDRF4RRr Skh2W5cqjILPfu3qSmBJ8fzF22jbaGEyfKo+Ja9qOxb50tCyOEDvXRWOeF3IwQDJyLDN 3bJljpE6ipIMoUOLIrjmXfWUUR6sV7p8hktGaKc4YkOJfW3vOSO/dXVZbPG9XHjccZHR 0ppir5ms38YC62ASpKDRi1Ln7C8K4zwS25FnmWi8pS0pxCMAxeq7ynEpxVbOcgY6fx4s QF1g== X-Forwarded-Encrypted: i=1; AJvYcCW+u9SEQGOyD4c3iavWOunzhWh7Ef3C8Cv90VYNL+sulormHHCVB/AnygyFac3LluOnQEdAgx+ohZI=@vger.kernel.org, AJvYcCW70Pth9tSbZV3UXNmK42DrVSkxnIyCUECIfekvcxukwFgxYBDplp2H6wFh5TSib5N6DcZSgCiPKVxKPg==@vger.kernel.org X-Gm-Message-State: AOJu0Yy8yLx+tetjbE77kWKrpL2wYCxGnNR070pWkSqjHoC4xag+jJsS f+IXDrts9KMnPPg8m2Pr58ABvNyr+1FDYQ1/LAhBgerfo2fDIp2tje9U X-Gm-Gg: ASbGncua7cbn+lMzjOeAxJMHKEQCcpSEvFGF3uUoZ/MgxG3UnLkLazvgbEcGn8OK8fi PMmi3zVqr4umQZBdMtwTodtZu8LPypvG06+bIdfthVKjchlFx3fuAT3ptWa6e/9iHXrEQ8VfHNq 6Gajh2kNqeFAafZAc4nqDhnFaHCiV5Uisi/YTa3WbIOXNIOrRmxJpTtV8XyTuyfPCWVpLoJGUXA Nx3O0xH5iUFE7MnW8Cg9b2yBUQvZgsgDNnSrb4vpBDMOqQkJaBdcXMRZTTgcQP0cLRaXRAkhcox 2V5+o4YMEsURjs1ShtNjixMStS2MlE1FN+KLxPiT2ouw7iLF+/QVGZ5ItUa2PV+Udy5Lz3sy X-Google-Smtp-Source: AGHT+IH20ru9QM1iIZ5c2tDNS4ruPZWTQKdkUFIoWobyCXJuV2LB3qhZD49CwTvd57wRqyKr2htHCQ== X-Received: by 2002:a05:6a00:138e:b0:742:a77b:8c3 with SMTP id d2e1a72fcca58-7490d73edcfmr3796771b3a.4.1750417045622; Fri, 20 Jun 2025 03:57:25 -0700 (PDT) Received: from archie.me ([103.124.138.155]) by smtp.gmail.com with ESMTPSA id d2e1a72fcca58-7490a623e7bsm1741644b3a.89.2025.06.20.03.57.22 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 20 Jun 2025 03:57:25 -0700 (PDT) Received: by archie.me (Postfix, from userid 1000) id 5CBED40F1700; Fri, 20 Jun 2025 17:57:15 +0700 (WIB) From: Bagas Sanjaya To: Linux Kernel Mailing List , Linux Documentation , Linux ext4 Cc: "Theodore Ts'o" , Andreas Dilger , Jonathan Corbet , "Ritesh Harjani (IBM)" , "Darrick J. Wong" , Bagas Sanjaya Subject: [PATCH 2/5] Documentation: ext4: Reduce toctree depth Date: Fri, 20 Jun 2025 17:56:41 +0700 Message-ID: <20250620105643.25141-4-bagasdotme@gmail.com> X-Mailer: git-send-email 2.49.0 In-Reply-To: <20250620105643.25141-2-bagasdotme@gmail.com> References: <20250620105643.25141-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=777; i=bagasdotme@gmail.com; h=from:subject; bh=lY/ayXOomIL1r8RZ/GRxVnbF6HVD16IJ2px9/rv4XR8=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDBmhtveemno2aCWn/nvJV/xd64vLacdDW5bqSSrziOTun fzteSpjRykLgxgXg6yYIsukRL6m07uMRC60r3WEmcPKBDKEgYtTACYyKYPhN0s02xRnhS1bNLa1 ZrffEVb8/KX0q+8Lwa49G5RM1a6rZDAydJ52f9227uun6/vOZR0o7C39yc5y+acKf2bgy3M9IQH f+AE= X-Developer-Key: i=bagasdotme@gmail.com; a=openpgp; fpr=701B806FDCA5D3A58FFB8F7D7C276C64A5E44A1D Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Reduce toctree depth from 6 to 2 to only show individual docs titles on top-level toctree (index.rst) and to not spoil the entire hierarchy. Signed-off-by: Bagas Sanjaya Acked-by: "Darrick J. Wong" Acked-by: Theodore Ts'o --- Documentation/filesystems/ext4/index.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Documentation/filesystems/ext4/index.rst b/Documentation/files= ystems/ext4/index.rst index 705d813d558f0e..1ff8150c50e927 100644 --- a/Documentation/filesystems/ext4/index.rst +++ b/Documentation/filesystems/ext4/index.rst @@ -5,7 +5,7 @@ ext4 Data Structures and Algorithms =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 .. toctree:: - :maxdepth: 6 + :maxdepth: 2 :numbered: =20 about --=20 An old man doll... just what I always wanted! - Clara From nobody Thu Oct 9 04:14:06 2025 Received: from mail-pl1-f174.google.com (mail-pl1-f174.google.com [209.85.214.174]) (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 8ED722853EF; Fri, 20 Jun 2025 10:57:25 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.214.174 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1750417047; cv=none; b=kDHi6p0AYcWlgkMKzMrBYS4B0eJKAwyJGAnCTnOFuKskVPW/jCH3O//ragaELTqSGKIfLnGeKkvQ0mqFb1QaCEk43q/u9IE3sR9/e8gfLPCPvhlYiNr/dysPBwfgCSTs1uAFlaW2eEjgKNDBlWjKWkpAH+qM8MV8We3TUt7Rpc8= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1750417047; c=relaxed/simple; bh=++7Yml9JsmL3GZk3oycWGg4YVpXZATaK+KA1ZT02l/o=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=LctyS17VK0PXQv7qBldBumwk2oxBLAbI2a27b398c1n6XyGUQWb4q9OONjBoPhVuLh2j3URxj4YaiRf19YrTbL218UYE3c3n6KlZQ8EPsm6Zyq/aUHeOSqzTn/EP2WZpqB9noaLTFvlbs5J5Tw2JYmQSZ6XGvp6l/rIlpdtHVfI= 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=bKqT6DS0; arc=none smtp.client-ip=209.85.214.174 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="bKqT6DS0" Received: by mail-pl1-f174.google.com with SMTP id d9443c01a7336-23508d30142so22961975ad.0; Fri, 20 Jun 2025 03:57:25 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1750417045; x=1751021845; 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=7I8lZqQE+SoK80AKgdvUGtRJHMKihQjX5aQWXaxRPDw=; b=bKqT6DS0TnwTgO6eV9j2CMAD/kb7qJwoz+qhHFymNciNUYlDMn2KQW05i4cccUW7Nm d8xjEjPJ4ukEQWPN+EqgJdsuY5eyXOjK3OTPmXhE+kn335kDgmvn+KOEbUz6dWLw1sAj IRx7AXtl9kVmB6Vi+uHypTtEB5IgYQFU8+3rjJbCgW8imumAbM3v66f/GS8WSIrfhqYR zJ2ppbCux4kZBJ12tZ3Ww3RAimGJ6RJVO0lHMoAAn3/5nRhKdXFAc/24EMLoCauC3t2V QqgOPaYdT0ncgiCw43hXcubG3W7adbgBOQ+k8qhi8imkBPBsubibRUzlH8sPoNzIDbI6 eJOg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1750417045; x=1751021845; 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=7I8lZqQE+SoK80AKgdvUGtRJHMKihQjX5aQWXaxRPDw=; b=XHs/txi0O8rkaX6/xsD3x5WtIVDwP+gu99Ae7pPp3KL//BdtrOIIe3AjL/s95oKCR3 /E6JK0Qtuw5VGDyh5n0Da3KhN+KUVbSCwQx/h6apUaMBxj1KJjOAJO0QavtK5Rq98Jeh I7ODN/Mzz7wVGdNMmOhzo7xSVbRdqP6jDcgN/8pVUDGsLEVAqYNR/GI2hO9HYS2xfp9B Zhf2N94uplXe9HoKhB5GCWCW5drCR6U6azD7MorGRmRNzpsvu8SaZ9NbwEHBokwNVDUp Z8Eg/5QJ3zJNK1VIXgsgKDvN1Ruc2Sacc7SWwynTVvNgRDdypqhFTVk7XIDo8Y3shfTI oO5A== X-Forwarded-Encrypted: i=1; AJvYcCUkiJ0nJYSz5knRFyj4nJzsPncPPTVjZz1H48VxDWEuKr1m3f1x6RVLIVlo0exOeWsLQ5G8WybngxiI+Q==@vger.kernel.org, AJvYcCXwx4hImFYWh8gFJh/TOf67otVqQ6lP0Re9yUgJx/0mVUoSJxxVZndzvfJZYno04LoOG8Pkl7Sm/Ow=@vger.kernel.org X-Gm-Message-State: AOJu0YyE0qQuWh6D5avfc7XWMMqRAdLHEyKTlsGYPIsrLjvDWoJAG795 UxYFvnYeE+nKGW3vhVf5KCs/qtWYPLN6d5epIxS22t+wyONAN81EMv9G X-Gm-Gg: ASbGncv8hJW1wViBvYRiDDWJb+XFfD47EuEt9K0dDKzqOzp50jnkMhVsUQmZNLi6pdX 7G7fMeyMznqsZkoH6fNzzalJAYropVBxPEYgXrxaPBF+IEcerCmdMDELPzd6hR01fT5PwNdhZLY 9K/vzFr+t34dm011qh1fu3H1+Mz7NgtFTfEPo7l9Cxbc8gy05WqmB2aLW0br68kYVtovGQxclfq RXg1DEO+fIQ6W1X0MADLSG9JuFAEsDMbGeUig5V5uFe4JdpDBltGb3+ZTuvD/Chip52okiGauhR UfFJXRLOpMcabji65L5X9Y1Om780OUXtEOTpBLyZRAlFKyapvUW4zTmDxkVwOcgliFGSHpgk X-Google-Smtp-Source: AGHT+IFnnpcerGp2wXOFmxQ6vBkym6Su9/uEj+sOvsLI0n891gdnwbda7YqfqA3PKfARBkBGEIQ90w== X-Received: by 2002:a17:902:c94a:b0:235:ef67:b595 with SMTP id d9443c01a7336-237d9acc6e7mr39575965ad.35.1750417044822; Fri, 20 Jun 2025 03:57:24 -0700 (PDT) Received: from archie.me ([103.124.138.155]) by smtp.gmail.com with ESMTPSA id d9443c01a7336-237d8393565sm15578765ad.46.2025.06.20.03.57.21 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 20 Jun 2025 03:57:22 -0700 (PDT) Received: by archie.me (Postfix, from userid 1000) id 8A8D940ED457; Fri, 20 Jun 2025 17:57:16 +0700 (WIB) From: Bagas Sanjaya To: Linux Kernel Mailing List , Linux Documentation , Linux ext4 Cc: "Theodore Ts'o" , Andreas Dilger , Jonathan Corbet , "Ritesh Harjani (IBM)" , "Darrick J. Wong" , Bagas Sanjaya Subject: [PATCH 3/5] Documentation: ext4: atomic_writes: Demote last three sections Date: Fri, 20 Jun 2025 17:56:42 +0700 Message-ID: <20250620105643.25141-5-bagasdotme@gmail.com> X-Mailer: git-send-email 2.49.0 In-Reply-To: <20250620105643.25141-2-bagasdotme@gmail.com> References: <20250620105643.25141-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=2050; i=bagasdotme@gmail.com; h=from:subject; bh=++7Yml9JsmL3GZk3oycWGg4YVpXZATaK+KA1ZT02l/o=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDBmhtvdUOC3V/59/9cBKRWDroy/rtW1i7BzyroX2eH2IY nnwXCu1o5SFQYyLQVZMkWVSIl/T6V1GIhfa1zrCzGFlAhnCwMUpABNJjWL4K+H0U8edrVrgIPMf pu6zt2TE4vM7e+TN3q46Jf3Fdda3QkaGRwo+e8LXX01X6/3OK7l5X1tqYEDx1w1OAbcK5L47a7v xAwA= X-Developer-Key: i=bagasdotme@gmail.com; a=openpgp; fpr=701B806FDCA5D3A58FFB8F7D7C276C64A5E44A1D Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Last three sections of atomic block writes documentation are adorned as first-level title headings, which erroneously increase toctree entries in overview.rst. Demote them. Fixes: 0bf1f51e34c4 ("ext4: Add atomic block write documentation") Signed-off-by: Bagas Sanjaya Acked-by: "Darrick J. Wong" Acked-by: Theodore Ts'o --- Documentation/filesystems/ext4/atomic_writes.rst | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/Documentation/filesystems/ext4/atomic_writes.rst b/Documentati= on/filesystems/ext4/atomic_writes.rst index f65767df3620d5..aeb47ace738dfa 100644 --- a/Documentation/filesystems/ext4/atomic_writes.rst +++ b/Documentation/filesystems/ext4/atomic_writes.rst @@ -148,10 +148,10 @@ reserved during: only required to handle a split extent across leaf blocks. =20 How to ------- +~~~~~~ =20 Creating Filesystems with Atomic Write Support -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ =20 First check the atomic write units supported by block device. See :ref:`atomic_write_bdev_support` for more details. @@ -176,7 +176,7 @@ Where ``-b`` specifies the block size, ``-C`` specifies= the cluster size in byte and ``-O bigalloc`` enables the bigalloc feature. =20 Application Interface -~~~~~~~~~~~~~~~~~~~~~ +^^^^^^^^^^^^^^^^^^^^^ =20 Applications can use the ``pwritev2()`` system call with the ``RWF_ATOMIC`= ` flag to perform atomic writes: @@ -204,7 +204,7 @@ writes are supported. .. _atomic_write_bdev_support: =20 Hardware Support ----------------- +~~~~~~~~~~~~~~~~ =20 The underlying storage device must support atomic write operations. Modern NVMe and SCSI devices often provide this capability. @@ -217,7 +217,7 @@ Nonzero values for these attributes indicate that the d= evice supports atomic writes. =20 See Also --------- +~~~~~~~~ =20 * :doc:`bigalloc` - Documentation on the bigalloc feature * :doc:`allocators` - Documentation on block allocation in ext4 --=20 An old man doll... just what I always wanted! - Clara From nobody Thu Oct 9 04:14:06 2025 Received: from mail-pg1-f180.google.com (mail-pg1-f180.google.com [209.85.215.180]) (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 0D72C277C85; Fri, 20 Jun 2025 10:57:23 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.215.180 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1750417045; cv=none; b=TYC3RwELOHfI/ZGR57raNPiKI8rFbe2+L5ofIqmwjnawojJPjFdWD8cW5SnnqqoGj0XRJzyKdw4sgN10TSpGkw1HuykLxHnQGHDzns/mpMaKNmd8ogn8GQBHXLjQvFxPy39GbJSa8yNt6RRUHaCpC0r2WCsUoEnFs7fhoiqF+4Y= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1750417045; c=relaxed/simple; bh=DTwiJYQnNc9AGZWZW0Dv+ePYGitT+lzesJK1X8jUrTs=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=Mc9JcYgITHVHovDj7pHyOsqMtoYBBHs3KAtJtWRsUiL02Vbgbo+TDRAUZyzZYAJl+V2TxsyNH8ry3C7mNpPyl8YEZT/OLNMaCIrRXdBP2gdVttEZaM5h4mXMQzX0bi6a6wFAISFJAoI1aAsnNTNdsqXrBf7y/MSnABuYs8KlQwA= 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=I9rnaYnP; arc=none smtp.client-ip=209.85.215.180 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="I9rnaYnP" Received: by mail-pg1-f180.google.com with SMTP id 41be03b00d2f7-b31fc7c27abso143050a12.3; Fri, 20 Jun 2025 03:57:23 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1750417043; x=1751021843; 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=Xm1ygtMFp1yHzj86PnisCVORI9v1g6VWyrI+P42tpdU=; b=I9rnaYnP+VWh87+tYtOVG42VLvt5aHzPkxwy84Uj6d7sAxWFYm6eILmmY0LjXRG8GQ tXHgxpJ/vSY4SgcYL9Qi1pqoSQ3Ux6yaNN0Hib6itEA74HHoMOJAsZv2PSzu5gfywPKX bpERo/s4FgBwtRHtOjv3cuNnIwwj9fd0tH8lG7xFIx9FaY/jVYzPrJlOpZiN3u77Y8/A vEnT48MKA6No3ERttjG8ZUWcpSsJF78OF6+fIuGIppPhFysl20vzILTKRju9wr3qIqAy z60+BZVXAEFvBCn3KgLy9jqg5H02+qGziFCCII00UZ1VRxrGRdV2O4uwcwg+Z6ND8qbN /Vfg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1750417043; x=1751021843; 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=Xm1ygtMFp1yHzj86PnisCVORI9v1g6VWyrI+P42tpdU=; b=XTIA0e9qhzBmaXC+NRFclxhOl1wILZryBnLRvqgAWv+lzjHmSlIsaoHvGcK/Bs7hXJ eOfQvCzm9kKRjNdMyZjt0cdNpxXH3gh/u0XmxmbHDQqZp1IrdwNiYRTQU3tI8ISYQp/X uw/+KL8RHdi0FLeZQZWRuCQcUbrsDkm+mktLBzZgfYJGmTBcMraimbifjeKVI1cCDq+L t4tanM1+7qZyWj8eReVzsqKR/0XiL4QNXihP3ioCcejGMJA9ZGUILSl00k9Ida88Jr1K gPTiLE/scYJ0l5g0LYYC/VaaCzL4R02n0riVMD9b02JtPRqYYS13PnvI2N3Twdf6IT0i Xiog== X-Forwarded-Encrypted: i=1; AJvYcCUeXUnNXRkKpOht3jhE9FwRB8pO3+SPpjc8OX9n0AoU7ftNJQ6Ig98t3uCXmi8HISQk89zMhrhdyCLSCA==@vger.kernel.org, AJvYcCVGPdFso6BvAih1s6nbH+vvo6j4PIbUkq9KI36Q/R9U6TiT8n29FWNG0JkMW7sXKdKGRK0/eNX5O4Y=@vger.kernel.org X-Gm-Message-State: AOJu0Yy1Bn6H+9ddzmsqoiFCILSvC+AZ19/7i8JseU5TDcdFxh2N6aYo Ds1YCyXsaSCobXMj2rnQRqjP82qoeNviTJv6vyGvKWdpWHq/DEp9Rdes X-Gm-Gg: ASbGnctlH5OiEr/YKnen3ToGdxYDWS/nra9YBshuGOpiYqm/xy1dln9MUXhiGULVnyj pQofgHn4Ba7blKvY4z7X/mGsDNX3AmHJcUp/AKHnBZhpkZ15m5FP+xOXgYem/ejYG5FwHw0wsgO Si8iHsu+GO37gH5MRJOpuGC+3oewI2G7WGU+XtLvci25RswvGMe9rv3366n7Q/3mpqPCxXUV/hd wRl+kO/QkHoipWG/jsvOdmNpm9NnZ8uVJ8cCuhnKS7GwbfjvbcICSWIxNMHF4Bvr/1+MdPQFs54 z1QVhDhKA+nb6rjKRqP1pSlTpnoKtGwcYB/ht9JRUiexiCeQHLcp3fq3c1kzgQ== X-Google-Smtp-Source: AGHT+IEeMzChr5YpXkQSb38TF9ejN+susjUsEzMrX/9I3MOi93qmoL1h4M5wrlhRz4hWEYKylxGcbQ== X-Received: by 2002:a17:90b:2687:b0:311:a4d6:30f8 with SMTP id 98e67ed59e1d1-3159d641124mr4292834a91.13.1750417043111; Fri, 20 Jun 2025 03:57:23 -0700 (PDT) Received: from archie.me ([103.124.138.155]) by smtp.gmail.com with ESMTPSA id 98e67ed59e1d1-3159df71c4bsm1407546a91.2.2025.06.20.03.57.21 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 20 Jun 2025 03:57:22 -0700 (PDT) Received: by archie.me (Postfix, from userid 1000) id 9B85740AD723; Fri, 20 Jun 2025 17:57:16 +0700 (WIB) From: Bagas Sanjaya To: Linux Kernel Mailing List , Linux Documentation , Linux ext4 Cc: "Theodore Ts'o" , Andreas Dilger , Jonathan Corbet , "Ritesh Harjani (IBM)" , "Darrick J. Wong" , Bagas Sanjaya Subject: [PATCH 4/5] Documentation: ext4: blockgroup: Add explicit title heading Date: Fri, 20 Jun 2025 17:56:43 +0700 Message-ID: <20250620105643.25141-6-bagasdotme@gmail.com> X-Mailer: git-send-email 2.49.0 In-Reply-To: <20250620105643.25141-2-bagasdotme@gmail.com> References: <20250620105643.25141-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=2105; i=bagasdotme@gmail.com; h=from:subject; bh=DTwiJYQnNc9AGZWZW0Dv+ePYGitT+lzesJK1X8jUrTs=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDBmhtvcenrJIXrfZce2uhRKtGfENEV4WET1y1x+6RClOr 6hef2N+RykLgxgXg6yYIsukRL6m07uMRC60r3WEmcPKBDKEgYtTACbStYnhF1OxVwZ/7NPvG2WV P39Pd+jijNaZ9vyYoJ/y4YucD61uWzIyLHl4gCsjZWpt/atf2ya+UHDL21YavrrHqzBCoLIj7+U DDgA= X-Developer-Key: i=bagasdotme@gmail.com; a=openpgp; fpr=701B806FDCA5D3A58FFB8F7D7C276C64A5E44A1D Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Block groups documentation has three, first-level section headings. These headings' text become toctree entries and the first one "Layout" becomes docs title in the output, which isn't conveying the docs contents. Add explicit title heading and demote the rest. Signed-off-by: Bagas Sanjaya Acked-by: "Darrick J. Wong" Acked-by: Theodore Ts'o --- Documentation/filesystems/ext4/blockgroup.rst | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-) diff --git a/Documentation/filesystems/ext4/blockgroup.rst b/Documentation/= filesystems/ext4/blockgroup.rst index ed5a5cac6d40e1..7cbf0b2b778eab 100644 --- a/Documentation/filesystems/ext4/blockgroup.rst +++ b/Documentation/filesystems/ext4/blockgroup.rst @@ -1,7 +1,10 @@ .. SPDX-License-Identifier: GPL-2.0 =20 +Block Groups +------------ + Layout ------- +~~~~~~ =20 The layout of a standard block group is approximately as follows (each of these fields is discussed in a separate section below): @@ -60,7 +63,7 @@ groups (flex_bg). Leftover space is used for file data bl= ocks, indirect block maps, extent tree blocks, and extended attributes. =20 Flexible Block Groups ---------------------- +~~~~~~~~~~~~~~~~~~~~~ =20 Starting in ext4, there is a new feature called flexible block groups (flex_bg). In a flex_bg, several block groups are tied together as one @@ -78,7 +81,7 @@ if flex_bg is enabled. The number of block groups that ma= ke up a flex_bg is given by 2 ^ ``sb.s_log_groups_per_flex``. =20 Meta Block Groups ------------------ +~~~~~~~~~~~~~~~~~ =20 Without the option META_BG, for safety concerns, all block group descriptors copies are kept in the first block group. Given the default @@ -117,7 +120,7 @@ Please see an important note about ``BLOCK_UNINIT`` in = the section about block and inode bitmaps. =20 Lazy Block Group Initialization -------------------------------- +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ =20 A new feature for ext4 are three block group descriptor flags that enable mkfs to skip initializing other parts of the block group --=20 An old man doll... just what I always wanted! - Clara From nobody Thu Oct 9 04:14:06 2025 Received: from mail-pl1-f170.google.com (mail-pl1-f170.google.com [209.85.214.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 9BBFE28A726; Fri, 20 Jun 2025 10:57:28 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.214.170 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1750417050; cv=none; b=OJd5Zsi2qUEeCD7N+R4nU0sYRMkge2yYdNDNXaAG5UAqL8DNXhlmhvjz43cyhL6Q/F5bAtjJvHch0Hdjjn3AT7/0KpFgRqLa/HmMfLvSkL0bDfN3f7AGpDUhdKYPXPe1yQd1FVppopBHQbiaugrAIfjzsNMqJraP55gROvG75+Q= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1750417050; c=relaxed/simple; bh=+T4MKSWdsIjPwq7v/X3d5MxVaQFBiaCAUlHggc0nYyU=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=WLKt4f41xt8cygKh2sKLnayxZtuZLwJGFWXQu+8tD0DSQPSk+E0B4Nm1EBFaQm/QVjbOp1PsW/ERvwMPgVSxhrZHOoZHBNMGwRYTiPzNIK2SQG3g4kbebPElh7KDt83Zshzapg2f546MCnFKiOe8RfYLg5eE+egDSTCi75hUI0k= 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=PsXgRs8O; arc=none smtp.client-ip=209.85.214.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="PsXgRs8O" Received: by mail-pl1-f170.google.com with SMTP id d9443c01a7336-2352400344aso16750975ad.2; Fri, 20 Jun 2025 03:57:28 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1750417048; x=1751021848; 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=E/SSTeD5INnDMSlbYCrgdkKOcD8aKffVGoAdYJgE0hM=; b=PsXgRs8OH/nWnrhGuEnhkEyh1t7XOTmKsaxrJuomSXjE93MqWBzYhsNAOxLtI2SYvF 0eGxMJ8nFkhKYpJKFX5Q4ug78fvGeQ4Vg4kejz77RFN7ybUxeTpeEQ9ejHR0b2QyOH4c 4YycDGuSLWNdOa/f6uDOL9r6y73VnEL/l1eCrPkSOjgnrUtS7AzwfIpUAKvJjeUcKPu4 V6iEORF/SykiZU1mZFT4uE0ovz3AB/IzvZTglvBtU5Y+mC6xhCBXdFCVnh7yRzbo1nNc 93y42snCr21KbvxLD3sG9or8IfRwOM9hupzxRvsBcs+6db6G6CgFAblb9J1j7Ax2C776 x4aA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1750417048; x=1751021848; 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=E/SSTeD5INnDMSlbYCrgdkKOcD8aKffVGoAdYJgE0hM=; b=MMvwkt1CmCnIHq2iOBQGZwD9r7xcI70vmjeBuitDvCbSD1VEA9MGlHGfmOS9sZQ8+s jzrOkr3qqAzxIVJgOL6n9rW2ypUR1wGVzxbctX/a+LuvU0F2vDFPGeProJJDp0sHS06M biAyNqDyKukQH80vHpVdHZM4etlS8aYkOhYvVLc7AX8th0NTjS9xzwfnSf30C50rNdQ3 SoJDZrMja/u+cnQFKWsf9tMJJcjzDRI2WXlfDFTq3h76QcItCdOCe09GaLeLTu1e5s2f p+evkYTIco8iveggjKFOl+grhJw6tAoQ5Z2DNWdrVFc5PvWgdIyMgh6gg8Ce/A9OKq4D xVSw== X-Forwarded-Encrypted: i=1; AJvYcCURY3HCkUULL8Va4NXQtFVg3LmaFtA11D8UugJBfyooEELtlb/Gf1EtCTqYIc5f6uyVOOm84TV/hBo=@vger.kernel.org, AJvYcCX51H62zuitKwZF54jVoTfS6+1XRMvtID8VzOTqZZv2rq166FlvzarqFB2nfVYAy04gAwCy2BeqcNorlg==@vger.kernel.org X-Gm-Message-State: AOJu0Yw2VQcdGI172W1siN6NjM9ip6xlTiepJyf3LTWZ88rUdDKIg1if 80rYaESp2qC78dJYfJI38hP2q7NXwlpnIus0eVLklHSBCSxVg6lGln63 X-Gm-Gg: ASbGncvuxV8tX+wlZ+JaSZUyeIrd1gTetU/nOYPPiWTlskTVXKiwfxaJS5WlPJ0ntpZ /BpSdy0N43WHFVYbP+OPNy4IP3oLnM8oaz6qs3GttWXInhH2ND/bkT1qdVpPUpu10Nm0C40Mtxd bVN259wNfWJsACV+NOVyjVIOZwhLa/wUgDWR7BmG6j+hUIixCJmPS0FPawlNRaKcaWSt98wh+BA 6zr/Ih+mISLNpLfD2CIw/Yng4JhCT0HszcnRMyFdkGE1PqZsj2vD17RzRrBJGZzwKqjfxHTfxp/ aHne/JshC6e03vxw6U3zbq2/oB8B5xZjLqP0DAUS+F12pv4M1D0xtCkSazAjVg== X-Google-Smtp-Source: AGHT+IFjIS/UxczrAh5+l+DmG908FynEuQ5swZHGAIC6iYmHhIM2uJPssMw5jdXnzg1z8IgfH34JZA== X-Received: by 2002:a17:903:196b:b0:234:1163:ff99 with SMTP id d9443c01a7336-237d9af3066mr36120745ad.43.1750417047818; Fri, 20 Jun 2025 03:57:27 -0700 (PDT) Received: from archie.me ([103.124.138.155]) by smtp.gmail.com with ESMTPSA id d9443c01a7336-237d86f8261sm15269165ad.221.2025.06.20.03.57.26 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 20 Jun 2025 03:57:27 -0700 (PDT) Received: by archie.me (Postfix, from userid 1000) id B9BDE40AD72B; Fri, 20 Jun 2025 17:57:16 +0700 (WIB) From: Bagas Sanjaya To: Linux Kernel Mailing List , Linux Documentation , Linux ext4 Cc: "Theodore Ts'o" , Andreas Dilger , Jonathan Corbet , "Ritesh Harjani (IBM)" , "Darrick J. Wong" , Bagas Sanjaya Subject: [PATCH 5/5] Documentation: ext4: Move inode table short docs into its own file Date: Fri, 20 Jun 2025 17:56:44 +0700 Message-ID: <20250620105643.25141-7-bagasdotme@gmail.com> X-Mailer: git-send-email 2.49.0 In-Reply-To: <20250620105643.25141-2-bagasdotme@gmail.com> References: <20250620105643.25141-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=2511; i=bagasdotme@gmail.com; h=from:subject; bh=+T4MKSWdsIjPwq7v/X3d5MxVaQFBiaCAUlHggc0nYyU=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDBmhtvc282jEmvgXfItR2COryLd4bvPahwEFeze9/bl+k TrDLbXQjlIWBjEuBlkxRZZJiXxNp3cZiVxoX+sIM4eVCWQIAxenAEwk3Y6RYffye48u3f4vv/tu wDSNWYs2l8nUud0MOShyzyPYyuHY/j+MDFMVf3Kl8FQFiv6beOXxc2NxP5bA17MmR2ZkZT6+Fxk YxgIA X-Developer-Key: i=bagasdotme@gmail.com; a=openpgp; fpr=701B806FDCA5D3A58FFB8F7D7C276C64A5E44A1D Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" The short description of inode table is in bitmaps.rst alongside the proper bitmpas documentation. The docs file is short enough that it fits whole browser screen on desktop, which implies that when readers click "Inode Table", they will essentially see bitmaps docs. Move inode table short description. Signed-off-by: Bagas Sanjaya Acked-by: "Darrick J. Wong" Acked-by: Theodore Ts'o --- Documentation/filesystems/ext4/bitmaps.rst | 7 ------- Documentation/filesystems/ext4/globals.rst | 1 + Documentation/filesystems/ext4/inode_table.rst | 9 +++++++++ 3 files changed, 10 insertions(+), 7 deletions(-) create mode 100644 Documentation/filesystems/ext4/inode_table.rst diff --git a/Documentation/filesystems/ext4/bitmaps.rst b/Documentation/fil= esystems/ext4/bitmaps.rst index 91c45d86e9bb56..9d7d7b083a258c 100644 --- a/Documentation/filesystems/ext4/bitmaps.rst +++ b/Documentation/filesystems/ext4/bitmaps.rst @@ -19,10 +19,3 @@ necessarily the case that no blocks are in use -- if ``m= eta_bg`` is set, the bitmaps and group descriptor live inside the group. Unfortunately, ext2fs_test_block_bitmap2() will return '0' for those locations, which produces confusing debugfs output. - -Inode Table ------------ -Inode tables are statically allocated at mkfs time. Each block group -descriptor points to the start of the table, and the superblock records -the number of inodes per group. See the section on inodes for more -information. diff --git a/Documentation/filesystems/ext4/globals.rst b/Documentation/fil= esystems/ext4/globals.rst index 2264b76e873cc9..c6a6abce818a17 100644 --- a/Documentation/filesystems/ext4/globals.rst +++ b/Documentation/filesystems/ext4/globals.rst @@ -11,6 +11,7 @@ have static metadata at fixed locations. super group_descr bitmaps + inode_table mmp journal orphan diff --git a/Documentation/filesystems/ext4/inode_table.rst b/Documentation= /filesystems/ext4/inode_table.rst new file mode 100644 index 00000000000000..f7900a52c0d5da --- /dev/null +++ b/Documentation/filesystems/ext4/inode_table.rst @@ -0,0 +1,9 @@ +.. SPDX-License-Identifier: GPL-2.0 + +Inode Table +----------- + +Inode tables are statically allocated at mkfs time. Each block group +descriptor points to the start of the table, and the superblock records +the number of inodes per group. See :doc:`inode documentation ` +for more information on inode table layout. --=20 An old man doll... just what I always wanted! - Clara