[PATCH v2] docs: hugetlbpage.rst: clarify HugePages_Total in hugetlbpage.rst

[PATCH v2] docs: hugetlbpage.rst: clarify HugePages_Total in hugetlbpage.rst

[Enze Li]

"the size of the pool of huge pages" confused me, since it sounds like
a size in bytes.  It's actually the number of huge pages of the default
size in the pool, surplus pages included.  Reword it and point to
/sys/kernel/mm/hugepages for the other huge page sizes.

Suggested-by: Daniel Pereira <danielmaraboo@gmail.com>
Signed-off-by: Enze Li <lienze@kylinos.cn>
---
Changes in v2:
- Drop "persistent" from the description
- Reward the note on other sizes.

 Documentation/admin-guide/mm/hugetlbpage.rst | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/Documentation/admin-guide/mm/hugetlbpage.rst b/Documentation/admin-guide/mm/hugetlbpage.rst
index 2075f1f14a42..282bc420d97b 100644
--- a/Documentation/admin-guide/mm/hugetlbpage.rst
+++ b/Documentation/admin-guide/mm/hugetlbpage.rst
@@ -43,7 +43,10 @@ The output of ``cat /proc/meminfo`` will include lines like::
 where:
 
 HugePages_Total
-	is the size of the pool of huge pages.
+	is the number of huge pages of the default size in the pool,
+	both persistent and surplus.  Counts for the other huge page
+	sizes are available in ``/sys/kernel/mm/hugepages`` (described
+	below).
 HugePages_Free
 	is the number of huge pages in the pool that are not yet
         allocated.

base-commit: 3fdcce698abd9193752ee89fb1a440cdceb1b74a
-- 
2.56.0

Re: [PATCH v2] docs: hugetlbpage.rst: clarify HugePages_Total in hugetlbpage.rst

[David Hildenbrand (Arm)]

On 10/26/26 09:08, Enze Li wrote:
> "the size of the pool of huge pages" confused me, since it sounds like
> a size in bytes.  It's actually the number of huge pages of the default
> size in the pool, surplus pages included.  Reword it and point to
> /sys/kernel/mm/hugepages for the other huge page sizes.
> 
> Suggested-by: Daniel Pereira <danielmaraboo@gmail.com>
> Signed-off-by: Enze Li <lienze@kylinos.cn>
> ---
> Changes in v2:
> - Drop "persistent" from the description
> - Reward the note on other sizes.
> 
>  Documentation/admin-guide/mm/hugetlbpage.rst | 5 ++++-
>  1 file changed, 4 insertions(+), 1 deletion(-)
> 
> diff --git a/Documentation/admin-guide/mm/hugetlbpage.rst b/Documentation/admin-guide/mm/hugetlbpage.rst
> index 2075f1f14a42..282bc420d97b 100644
> --- a/Documentation/admin-guide/mm/hugetlbpage.rst
> +++ b/Documentation/admin-guide/mm/hugetlbpage.rst
> @@ -43,7 +43,10 @@ The output of ``cat /proc/meminfo`` will include lines like::
>  where:
>  
>  HugePages_Total
> -	is the size of the pool of huge pages.
> +	is the number of huge pages of the default size in the pool,
> +	both persistent and surplus.  Counts for the other huge page
> +	sizes are available in ``/sys/kernel/mm/hugepages`` (described
> +	below).

Reviewed-by: David Hildenbrand (Arm) <david@kernel.org>

-- 
Cheers,

David

Re: [PATCH v2] docs: hugetlbpage.rst: clarify HugePages_Total in hugetlbpage.rst

[Muchun Song]

> On Oct 26, 2026, at 16:08, Enze Li <lienze@kylinos.cn> wrote:
> 
> "the size of the pool of huge pages" confused me, since it sounds like
> a size in bytes.  It's actually the number of huge pages of the default
> size in the pool, surplus pages included.  Reword it and point to
> /sys/kernel/mm/hugepages for the other huge page sizes.
> 
> Suggested-by: Daniel Pereira <danielmaraboo@gmail.com>
> Signed-off-by: Enze Li <lienze@kylinos.cn>

Reviewed-by: Muchun Song <muchun.song@linux.dev>

Thanks