Linux: remove hugetlb mem metric. On 2nd though it's too niche.

Author: giampaolo

docs/api-overview.rst

@@ -405,7 +405,7 @@ Memory
                 rss_file=897433,
                 rss_shmem=0,
                 swap_anon=0,
-                hugetlb=0)
+                locked=0)
     >>>
     >>> p.memory_percent()
     0.78

docs/api.rst

@@ -1699,8 +1699,6 @@ Process class
     +-------------+----------------+--------------------+
     | swap_anon   |                | peak_nonpaged_pool |
     +-------------+----------------+--------------------+
-    | hugetlb     |                |                    |
-    +-------------+----------------+--------------------+
     | locked      |                |                    |
     +-------------+----------------+--------------------+
 
@@ -1721,8 +1719,6 @@ Process class
       :field:`swap` (it reads :proc:`/proc/pid/status` instead of smaps) but
       does not count shmem swap (see :ref:`faq_memory_swap`). Set to 0 on Linux
       < 2.6.34.
-    - :field:`hugetlb`: resident memory backed by huge pages. Set to 0 on Linux
-      < 4.4.
     - :field:`locked`: locked memory that cannot be
       :term:`swapped out <swap-out>`. Typically locked via :manpage:`mlock(2)`.
 

docs/changelog.rst

@@ -55,8 +55,8 @@ Changelog
   :meth:`Process.memory_footprint` returns a new :field:`shared` field:
   resident memory shared with other processes.
 
-Reorganization of process memory APIs (:gh:`2731`, :gh:`2736`, :gh:`2723`,
-:gh:`2733`, :gh:`2988`).
+Reorganization of process memory APIs (:gh:`2731`, :gh:`2736`, :gh:`2733`,
+:gh:`2988`).
 
 - New :meth:`Process.memory_extras` method, returning extra platform-specific
   memory metrics on Linux, macOS and Windows. See

docs/migration.rst

@@ -167,8 +167,7 @@ New memory_extras() method
 platform-specific memory metrics which complement :meth:`Process.memory_info`:
 
 - Linux: :field:`peak_rss`, :field:`peak_vms`, :field:`rss_anon`,
-  :field:`rss_file`, :field:`rss_shmem`, :field:`swap_anon`, :field:`hugetlb`,
-  :field:`locked`.
+  :field:`rss_file`, :field:`rss_shmem`, :field:`swap_anon`, :field:`locked`.
 - macOS: :field:`phys_footprint`, :field:`peak_footprint`.
 - Windows: :field:`virtual`, :field:`peak_virtual`, :field:`paged_pool`,
   :field:`nonpaged_pool`, :field:`peak_paged_pool`,

psutil/_ntuples.py

@@ -419,7 +419,6 @@ class pmem_extras(NamedTuple):
         rss_file: int
         rss_shmem: int
         swap_anon: int
-        hugetlb: int
         locked: int
 
     # psutil.Process().memory_full_info()

psutil/_pslinux.py

@@ -1914,12 +1914,11 @@ def memory_extras(
         _rssfile_re=re.compile(br"RssFile:\s+(\d+)"),
         _rssshmem_re=re.compile(br"RssShmem:\s+(\d+)"),
         _vmswap_re=re.compile(br"VmSwap:\s+(\d+)"),
-        _hugetlb_re=re.compile(br"HugetlbPages:\s+(\d+)"),
         _vmlck_re=re.compile(br"VmLck:\s+(\d+)"),
     ):
         # Read /proc/{pid}/status.
         # RssAnon/RssFile/RssShmem were added in Linux 4.5;
-        # VmSwap in 2.6.34; HugetlbPages in 4.4.
+        # VmSwap in 2.6.34.
         data = self._read_status_file()
 
         def parse(regex):
@@ -1933,7 +1932,6 @@ def parse(regex):
             rss_file=parse(_rssfile_re),
             rss_shmem=parse(_rssshmem_re),
             swap_anon=parse(_vmswap_re),
-            hugetlb=parse(_hugetlb_re),
             locked=parse(_vmlck_re),
         )
 

tests/test_process.py

@@ -504,7 +504,6 @@ def test_memory_extras_fields_order(self):
                 "rss_file",
                 "rss_shmem",
                 "swap_anon",
-                "hugetlb",
                 "locked",
             )
         elif MACOS: