Changelog

8.0.0 — unreleased

Note

psutil 8.0 introduces breaking API changes. See the migration guide if upgrading from 7.x.

New APIs

Reorganization of process memory APIs (#2731, #2736, #2733, #2988).

Type hints and enums

Other API changes

Dropped support

  • #2872, breaking: Python 3.6 and 3.7 (minimum is now 3.8).

  • #2893, [Windows], breaking: Windows Vista, 7, 8, 8.1 and their server counterparts (minimum is now Windows 10 / Server 2016).

  • #2936, [Windows], breaking: PyPy older than 7.3.14.

  • #2987, [macOS], breaking: macOS 10.7 and 10.8 (minimum is now 10.9).

Performance

Build and packaging

  • #2788, breaking: git tags renamed from release-X.Y.Z to vX.Y.Z (old tags are kept). See migration guide.

  • #2914, [macOS], breaking: Intel wheels now require macOS 10.15 or higher, up from 10.9. arm64 wheels are unaffected.

  • #2915, breaking: stop publishing wheels for free-threaded CPython 3.13 (cp313t), which was experimental. Only cp314t wheels are published.

  • #2976, [Linux]: publish ppc64le and s390x wheels.

  • #2576: the C extension modules now use PEP 489 multi-phase initialization.

  • #2844: removed docs/ from the tarball (from 586K to 396K).

  • #2883: the platform-specific C extension modules are now built as a single private _psutil module.

  • #2909: setup.py no longer uses distutils (removed in Python 3.12).

  • #2925: the C sources are now compiled in parallel, making builds 2x to 3.6x faster. This mostly helps platforms with no wheels (*BSD, Solaris, AIX). Use PSUTIL_BUILD_JOBS to cap the number of jobs.

Documentation

Internals

  • #2765: add a PR bot that uses Claude to update changelog.rst and credits.rst when commenting with /changelog.

  • #2927: Python dependencies are now installed with uv when available, saving ~10 secs per CI run.

  • #3066: the C extension is now compiled with -Wall -Wextra (/W4 on Windows), with warnings as errors in CI.

Bug fixes: cross-platform

  • #2857, [Linux], [SunOS], memleak: disk_partitions() (Linux) and Process.environ() (SunOS) leaked a reference when argument parsing failed. On SunOS Process.environ() also checked the wrong variable for NULL.

  • #2793: process_iter() silently skipped zombie processes.

  • #2830, [Linux], [macOS], [BSD]: Process.terminal() returned None for terminals opened after the first call (e.g. a new /dev/pts/N).

  • #2895: Process methods could wrongly raise NoSuchProcess (“PID has been reused”) when the process creation time could not be determined (e.g. zombies on NetBSD / OpenBSD, AccessDenied on Windows).

  • #2899: two Process instances for the same process could compare unequal if the creation time could not be determined. hash(Process) is now based on the PID alone.

Bug fixes: Linux

Bug fixes: Windows

Bug fixes: macOS

Bug fixes: BSD

Bug fixes: POSIX

7.2.2 — 2026-01-28

Performance

  • #2705, [Linux], [macOS], [BSD]: Process.wait() no longer uses a busy loop. It now uses pidfd_open() + poll() on Linux (requires Linux >= 5.3 and Python >= 3.9), and kqueue() on macOS and BSD.

Bug fixes

7.2.1 — 2025-12-29

Bug fixes

  • #2699, [FreeBSD], [NetBSD]: heap_info() does not detect small allocations (<= 1K). In order to fix that, we now flush internal jemalloc cache before fetching the metrics.

7.2.0 — 2025-12-23

New APIs

  • #1275: new heap_info() and heap_trim() functions, providing direct access to the platform’s native C heap allocator (glibc, mimalloc, libmalloc). Useful to create tools to detect memory leaks.

Build and packaging

  • #2680, breaking: unit tests are no longer installed / part of the distribution. They now live under tests/ instead of psutil/tests, so import psutil.tests no longer works (it was never documented to begin with).

  • #2403, [Linux]: publish wheels for Linux musl.

Bug fixes

  • #2684, [FreeBSD], build-fail: compilation fails on FreeBSD 14 due to missing include.

  • #2691, [Windows], memleak: fix memory leak in net_if_stats() due to missing Py_CLEAR.

7.1.3 — 2025-11-02

Internals

  • #2667: enforce clang-format on all C and header files. It is now the mandatory formatting style for all C sources.

  • #2676, #2678: replace unsafe sprintf / snprintf / sprintf_s with str_format, and strlcat / strlcpy with str_copy / str_append. Unifies string handling across platforms.

Bug fixes

  • #2677, [Windows], critical: fix MAC address string construction in net_if_addrs() (buffer overflow / misformat risk).

  • #2679, [OpenBSD], [NetBSD], build-fail: can’t build due to C syntax error.

  • #2672, [macOS], [BSD]: increase the chances to recognize zombie processes and raise the appropriate exception (ZombieProcess).

  • #2674, [Windows]: disk_usage() could truncate values on 32-bit platforms, potentially reporting incorrect total, free, used space for drives larger than 4GB.

  • #2675, [macOS]: Process.status() incorrectly returns STATUS_RUNNING for 99% of the processes.

7.1.2 — 2025-10-25

Build and packaging

  • #2657, breaking: stop publishing prebuilt Linux and Windows wheels for 32-bit Python. 32-bit CPython is still supported, but psutil must now be built from source.

  • #2565: produce wheels for free-threaded CPython 3.13 and 3.14.

Bug fixes

7.1.1 — 2025-10-19

Dropped support

  • #2645, [SunOS], breaking: SunOS 10.

Internals

  • #2646, [SunOS]: add CI test runner for SunOS.

Bug fixes

  • #2641, [SunOS], build-fail: cannot compile psutil from sources due to missing C include.

  • #2357, [SunOS]: Process.cmdline() does not handle spaces properly.

7.1.0 — 2025-09-17

Dropped support

  • #2571, [FreeBSD], breaking: FreeBSD 8 and earlier. FreeBSD 8 was maintained from 2009 to 2013.

Build and packaging

  • #2581, [Windows]: publish ARM64 wheels.

Internals

  • #2575: introduced dprint CLI tool to format .yml and .md files.

Bug fixes

7.0.0 — 2025-02-13

New APIs

API changes

Dropped support

  • #2480, breaking: Python 2.7. Latest version supporting it is psutil 6.1.X (pip2 install psutil==6.1.*).

Bug fixes

6.1.1 — 2024-12-19

Internals

  • #2471: use Vulture CLI tool to detect dead code.

Bug fixes

6.1.0 — 2024-10-17

Performance

Internals

  • #2446: use pytest instead of unittest.

  • #2448: add make install-sysdeps target to install the necessary system dependencies (python-dev, gcc, etc.) on all supported UNIX flavors.

  • #2449: add make install-pydeps-test and make install-pydeps-dev targets. They can be used to install dependencies meant for running tests and for local development. They can also be installed via pip install .[test] and pip install .[dev].

  • #2456: allow running tests via python3 -m psutil.tests even if pytest is not installed.

Bug fixes

6.0.0 — 2024-06-18

New APIs

  • #2396: a new process_iter.cache_clear() API can be used to clear process_iter() internal cache.

API changes

Performance

  • #2396, breaking: process_iter() no longer preemptively checks whether PIDs have been reused, making it around 20x faster. Use Process.is_running() on yielded instances instead (it also removes reused PIDs from the internal cache).

Build and packaging

  • #2369, [Windows], build-fail: wheels failed to build. Fixed by upgrading cibuildwheel.

  • #2375, [macOS]: provide arm64 wheels.

  • #2401: support building with free-threaded CPython 3.13.

  • #2425, [Linux]: provide aarch64 wheels.

Internals

  • #2366, [Windows]: log debug message when using slower process APIs.

Bug fixes

  • #2360, [macOS], build-fail: can’t compile on macOS < 10.13.

  • #2362, [macOS], build-fail: can’t compile on macOS 10.11.

  • #2365, [macOS], build-fail: can’t compile on macOS < 10.9.

  • #2412, [macOS], build-fail: can’t compile on macOS 10.4 PowerPC due to missing MNT_ constants.

  • #2250, [NetBSD]: Process.cmdline() sometimes fails with EBUSY for long cmdlines. Now retries up to 50 times, returning an empty list as last resort.

  • #2254, [Linux]: offline CPUs raise NotImplementedError in cpu_freq().

  • #2272: add pickle support to psutil exceptions.

  • #2359, [Windows]: pid_exists() disagrees with Process on whether a pid exists when ERROR_ACCESS_DENIED.

  • #2395, [OpenBSD]: pid_exists() erroneously returns True if the argument is a thread ID (TID) instead of a PID (process ID).

5.9.8 — 2024-01-19

Performance

  • #2343, [FreeBSD]: filter net_connections() in C instead of Python, ~4x faster. Only requested connection types are now retrieved.

  • #2342, [NetBSD]: same as above (#2343) but for NetBSD.

Internals

  • #2349: adopted black formatting style.

Bug fixes

5.9.7 — 2023-12-17

Internals

  • #2324: enforce Ruff rule raw-string-in-exception, which helps provide clearer tracebacks when exceptions are raised by psutil.

Bug fixes

  • #2321, [Linux], [SunOS], build-fail: missing #include <unistd.h> causes an implicit declaration of close() and syscall().

  • #2325, [PyPy], build-fail: psutil did not compile on PyPy due to missing PyErr_SetExcFromWindowsErrWithFilenameObject CPython API.

5.9.6 — 2023-10-15

API changes

Dropped support

  • #2246, breaking: Python 3.4 and 3.5.

Internals

  • #2312: use ruff linter instead of flake8 + isort.

Bug fixes

5.9.5 — 2023-04-17

API changes

Internals

  • #2196: in case of exception, display a cleaner error traceback by hiding the KeyError bit deriving from a missed cache hit.

  • #2217: print the full traceback when a DeprecationWarning or UserWarning is raised.

  • #2240, [NetBSD], [OpenBSD]: add CI testing on every commit for NetBSD and OpenBSD platforms (Python 3 only).

Bug fixes

5.9.4 — 2022-11-07

Build and packaging

  • #2102: use Limited API when building wheels with CPython 3.6+ on Linux, macOS and Windows.

Bug fixes

  • #2156, [Linux], build-fail: compilation may fail on very old gcc compilers due to missing SPEED_UNKNOWN definition.

  • #2010, [macOS], build-fail: on macOS, arm64 IFM_1000_TX and IFM_1000_T are the same value, causing a build failure.

  • #2077, [Windows]: use system-level values for virtual_memory().

  • #2160, [Windows]: get swap_memory() percent usage from performance counters.

5.9.3 — 2022-10-18

Build and packaging

  • #2040, [macOS]: provide wheels for arm64 architecture.

Internals

  • #2153, [macOS]: fix race condition in test_posix.TestProcess.test_cmdline.

Bug fixes

5.9.2 — 2022-09-04

Bug fixes

  • #2093, [FreeBSD]: pids() may fail with ENOMEM. Dynamically increase the malloc() buffer size until it’s big enough.

  • #2095, [Linux]: net_if_stats() returns incorrect interface speed for 100GbE network cards.

  • #2113, [FreeBSD]: virtual_memory() may raise ENOMEM due to missing #include <sys/param.h> directive.

  • #2128, [NetBSD]: swap_memory() was miscalculated.

5.9.1 — 2022-05-20

New APIs

Dropped support

  • #1053, breaking: Python 2.6 (minimum is now 2.7).

Performance

Bug fixes

5.9.0 — 2021-12-29

New platforms

  • #1996, [BSD]: MidnightBSD.

API changes

  • #1992: NoSuchProcess message now specifies if the PID has been reused. Error classes now have improved __repr__ and __str__.

  • #1999, [Linux]: disk_partitions(): convert /dev/root device (an alias used on some Linux distros) to real root device path.

Performance

Documentation

  • #2042: rewrite HISTORY.rst to use hyperlinks pointing to psutil API doc.

Internals

  • #2005: PSUTIL_DEBUG mode now prints file name and line number of the debug messages coming from C extension modules.

Bug fixes

5.8.0 — 2020-12-19

New platforms

  • #1872, [Windows]: PyPy 2.7.

New APIs

  • #1863: disk_partitions() exposes 2 extra fields: maxfile and maxpath, which are the maximum file name and path name length.

Build and packaging

  • #1879: provide pre-compiled wheels for Linux and macOS (yay!).

Internals

  • #1880: switch CI from Travis/Cirrus to GitHub Actions (Linux, macOS, FreeBSD). AppVeyor still used for Windows.

Bug fixes

5.7.3 — 2020-10-24

New APIs

API changes

  • #1830, [POSIX]: net_if_stats() isup also checks whether the NIC is running (meaning Wi-Fi or ethernet cable is connected).

  • #1837, [Linux]: improved battery detection and charge secsleft calculation.

Bug fixes

  • #1823, [Windows], critical: Process.open_files() may cause a segfault due to a NULL pointer.

  • #1791, [macOS], build-fail: fix missing include for getpagesize().

  • #1620, [Linux]: cpu_count() with logical=False result is incorrect on systems with more than one CPU socket.

  • #1738, [macOS]: Process.exe() may raise FileNotFoundError if process is still alive but the exe file which launched it got deleted.

  • #1838, [Linux]: sensors_battery(): if percent can be determined but not the remaining values, still return a result instead of None.

5.7.2 — 2020-07-15

Bug fixes

  • wheels for 2.7 were inadvertently deleted.

5.7.1 — 2020-07-15

New platforms

  • #1768, [Windows]: Windows Nano Server.

API changes

  • #1747: Process.wait() return value is cached so that the exit code can be retrieved on the next call.

  • #1747, [POSIX]: Process.wait() on POSIX now returns an enum, showing the negative signal which was used to terminate the process. It returns something like <Negsignal.SIGTERM: -15>.

  • #1747: Process class provides more info about the process on str() and repr() (status and exit code).

Performance

  • #1741, [POSIX]: make build now runs in parallel on Python >= 3.6 and it’s about 15% faster.

Internals

  • #1709: parallel tests on POSIX (make test-parallel). They’re twice as fast!

  • #1757: memory leak tests are now stable.

Bug fixes

5.7.0 — 2020-02-18

New platforms

  • #1637, [SunOS]: old SunOS 5.10 Update 0 to 3 (partial support).

  • #1686, [Windows]: PyPy on Windows.

API changes

Dropped support

  • #1652, [Windows], breaking: Windows XP and Windows Server 2003 (minimum is now Windows Vista).

Performance

Internals

  • #1671, [FreeBSD]: add CI testing/service for FreeBSD (Cirrus CI).

  • #1682, [PyPy]: added CI / test integration for PyPy via Travis.

Bug fixes

5.6.7 — 2019-11-26

Bug fixes

  • #1630, [Windows], build-fail: can’t compile source distribution due to C syntax error.

5.6.6 — 2019-11-25

Bug fixes

  • #1616, critical: use of Py_DECREF instead of Py_CLEAR will result in double free() and segfault (CVE-2019-18874).

  • #1619, [OpenBSD], build-fail: compilation fails due to C syntax error.

  • #1179, [Linux]: Process.cmdline() now handles processes that use inappropriate chars to separate args.

5.6.5 — 2019-11-06

Bug fixes

  • #1615, build-fail: remove pyproject.toml as it was causing installation issues.

5.6.4 — 2019-11-04

New APIs

  • #1527, [Linux]: added Process.cpu_times() iowait counter, which is the time spent waiting for blocking I/O to complete.

Build and packaging

  • #1565: add PEP 517/8 build backend and requirements specification for better pip integration.

Bug fixes

5.6.3 — 2019-06-11

New APIs

Bug fixes

5.6.2 — 2019-04-26

New APIs

API changes

  • #1404, [Linux]: cpu_count() with logical=False falls back to reading /sys/devices/system/cpu/*/topology/core_id if /proc/cpuinfo doesn’t provide the info.

Documentation

  • #1464: various docfixes (always point to Python 3 doc, fix links, etc.).

Internals

  • #1458: provide coloured test output. Also show failures on KeyboardInterrupt.

  • #1478: add make command to re-run tests failed on last run.

  • #1462, [Linux]: (tests) make tests invariant to LANG setting.

  • #1463: scripts/cpu_distribution.py was broken.

Bug fixes

5.6.1 — 2019-03-11

Bug fixes

  • #1448, [Windows], critical: crash on import due to rtlIpv6AddressToStringA not available on Wine.

  • #1451, [Windows], critical: Process.memory_full_info() segfaults. NtQueryVirtualMemory is now used instead of QueryWorkingSet to calculate USS memory.

  • #1329, [AIX], build-fail: psutil doesn’t compile on AIX 6.1.

5.6.0 — 2019-03-05

New APIs

API changes

Performance

  • #1379, [Windows]: Process.suspend() and Process.resume() now use NtSuspendProcess / NtResumeProcess instead of stopping / resuming all threads. Faster and more reliable.

  • #1422, [Windows]: DLL-loaded Windows APIs are now loaded once on startup instead of per function call, significantly faster.

  • #1426, [Windows]: PAGESIZE and number of processors is now calculated on startup.

Internals

  • #1428: in case of error, the traceback message now shows the underlying C function called which failed.

  • #1442: Python 3 is now the default interpreter used by Makefile.

Bug fixes

5.5.1 — 2019-02-15

API changes

  • #1384, [Windows]: on Windows >= 8.1, Process.cmdline() falls back to NtQueryInformationProcess on ERROR_ACCESS_DENIED.

Bug fixes

  • #1408, [AIX], build-fail: psutil won’t compile on AIX 7.1 due to missing header.

  • #1394, [Windows]: Process.exe() returns “[Error 0] The operation completed successfully” when Python process runs in “Virtual Secure Mode”.

  • #1402: psutil exceptions’ repr() show the internal private module path.

5.5.0 — 2019-01-23

New APIs

Bug fixes

5.4.8 — 2018-10-30

API changes

Build and packaging

  • #1320, [POSIX]: better compilation support when using g++ instead of GCC.

Bug fixes

5.4.7 — 2018-08-14

New APIs

API changes

Bug fixes

5.4.6 — 2018-06-07

API changes

Bug fixes

5.4.5 — 2018-04-13

Bug fixes

  • #1268: setup.py’s extra_require parameter requires latest setuptools version, breaking quite a lot of installations.

5.4.4 — 2018-04-13

New APIs

API changes

  • #771, [Windows], breaking: cpu_count() with logical=False on Windows XP and Vista is no longer supported and returns None.

Bug fixes

  • #1194, [SunOS], critical: fix double free() in Process.cpu_num(). Also return nice value from psinfo as getpriority() doesn’t support real-time processes, and fix undefined behavior related to strict-aliasing rules and warnings.

  • #694, [SunOS]: Process.cmdline() could be truncated at the 15th character when reading it from /proc. An extra effort is made by reading it from process address space first.

  • #771, [Windows]: on systems using process groups (> 64 cores), cpu_count() (both logical and cores) returns a wrong (smaller) number, cpu_times() with percpu=True returns fewer CPUs, and cpu_stats() and cpu_freq() may return incorrect results.

  • #1193, [SunOS]: return uid/gid from /proc/pid/psinfo if there aren’t enough permissions for /proc/pid/cred.

  • #1210, [Linux]: cpu_percent() steal time may remain stuck at 100% due to Linux erroneously reporting a decreased steal time between calls.

  • #1216, [Windows]: fix compatibility with Python 2.6.

  • #1222, [Linux]: Process.memory_full_info() was erroneously summing “Swap:” and “SwapPss:”. Same for “Pss:” and “SwapPss”. Not anymore.

  • #1224, [Windows]: Process.wait() may erroneously raise TimeoutExpired.

  • #1238, [Linux]: sensors_battery() may return None in case battery is not listed as “BAT0” under /sys/class/power_supply.

  • #1240, [Windows]: cpu_times() float loses accuracy in a long running system.

  • #1245, [Linux]: sensors_temperatures() may fail with IOError “no such file”.

  • #1255, [FreeBSD]: swap_memory() stats were erroneously represented in KB.

5.4.3 — 2018-01-01

API changes

Bug fixes

5.4.2 — 2017-12-07

New APIs

API changes

Performance

Internals

  • #1172, [Windows]: make test does not work.

Bug fixes

5.4.1 — 2017-11-08

New APIs

Dropped support

  • #1053, breaking: Python 3.3 (psutil still works but it’s no longer tested).

Internals

  • #1151: python -m psutil.tests fails.

Bug fixes

  • #1154, [AIX], build-fail: psutil won’t compile on AIX 6.1.0.

  • #1150, [Windows]: when a process is terminated now the exit code is set to SIGTERM instead of 0.

  • #1167, [Windows]: net_io_counters() packets count now also includes non-unicast packets.

5.4.0 — 2017-10-12

New platforms

Bug fixes

5.3.1 — 2017-09-10

Build and packaging

  • #1120, [Windows], breaking: .exe files are no longer uploaded on PyPI as per PEP-527. Only wheels are provided.

Documentation

Bug fixes

5.3.0 — 2017-09-01

New APIs

API changes

Build and packaging

  • #1060: source distribution now only includes relevant files.

Internals

  • #1058: test suite now enables all warnings by default.

Bug fixes

5.2.2 — 2017-04-10

Bug fixes

5.2.1 — 2017-03-24

Bug fixes

5.2.0 — 2017-03-05

New APIs

Bug fixes

5.1.3 — 2017-02-07

Bug fixes

5.1.2 — 2017-02-03

Bug fixes

5.1.1 — 2017-02-03

API changes

Bug fixes

5.1.0 — 2017-02-01

New APIs

Bug fixes

  • #948, build-fail: cannot install psutil with PYTHONOPTIMIZE=2.

  • #687, [Linux]: pid_exists() no longer returns True if passed a process thread ID.

  • #950, [Windows]: Process.cpu_percent() was calculated incorrectly and showed higher number than real usage.

  • #951, [Windows]: the uploaded wheels for Python 3.6 64 bit didn’t work.

  • #959: psutil exception objects could not be pickled.

  • #960: Popen wait() did not return the correct negative exit status if process is killed by a signal.

  • #961, [Windows]: WindowsService.description() method may fail with ERROR_MUI_FILE_NOT_FOUND.

5.0.1 — 2016-12-21

Build and packaging

  • #939: tar.gz distribution went from 1.8M to 258K.

Bug fixes

  • #609, [SunOS], build-fail: psutil does not compile on Solaris 10.

  • #936, [Windows], build-fail: fix compilation error on VS 2013.

  • #811, [Windows]: provide a more meaningful error message if trying to use psutil on unsupported Windows XP.

  • #940, [Linux]: cpu_percent() and cpu_times_percent() were calculated incorrectly as iowait, guest and guest_nice times were not properly taken into account.

  • #944, [OpenBSD]: pids() was omitting PID 0.

5.0.0 — 2016-11-06

New APIs

Bug fixes

4.4.2 — 2016-10-26

Bug fixes

  • #931, [SunOS], build-fail: psutil no longer compiles on Solaris.

4.4.1 — 2016-10-25

Bug fixes

  • #927: Popen __del__ may cause maximum recursion depth error.

4.4.0 — 2016-10-23

New APIs

API changes

  • #887, [Linux]: virtual_memory() available and used are more precise and match free utility. Also handles LXC containers.

Internals

Bug fixes

4.3.1 — 2016-09-01

Build and packaging

  • #881: make install now works also when using a virtual env.

Bug fixes

4.3.0 — 2016-06-18

Bug fixes

  • #812, [NetBSD], build-fail: fix compilation on NetBSD-5.x.

  • #810, [Windows]: Windows wheels are incompatible with pip 7.1.2.

  • #823, [NetBSD]: virtual_memory() raises TypeError on Python 3.

  • #829, [POSIX]: disk_usage() percent field takes root reserved space into account.

  • #816, [Windows]: fixed net_io_counters() values wrapping after 4.3GB in Windows Vista (NT 6.0) and above using 64bit values from newer win APIs.

4.2.0 — 2016-05-14

New APIs

Performance

Bug fixes

4.1.0 — 2016-03-12

New APIs

Bug fixes

4.0.0 — 2016-02-17

New APIs

Build and packaging

  • #660, [Windows]: make.bat is smarter in finding alternative VS install locations.

Internals

Bug fixes

3.4.2 — 2016-01-20

New APIs

  • #728, [SunOS]: exposed PROCFS_PATH constant to change the default location of /proc filesystem.

Bug fixes

3.4.1 — 2016-01-15

New platforms

  • #557, [NetBSD]: NetBSD.

API changes

Performance

Bug fixes

3.3.0 — 2015-11-25

New platforms

  • #615, [OpenBSD]: OpenBSD.

New APIs

  • #558, [Linux]: exposed PROCFS_PATH constant to change the default location of /proc filesystem.

Bug fixes

3.2.2 — 2015-10-04

Bug fixes

  • #610, [SunOS], build-fail: fix build and tests on Solaris 10.

  • #678, [Linux], build-fail: can’t install psutil due to bug in setup.py.

  • #688, [Windows], build-fail: compilation fails with MSVC 2015, Python 3.5.

  • #690, [Windows], build-fail: can’t compile with MSVC 2015, which enforces the C++11 rule forbidding duplicate values in an unscoped enum.

  • #517, [SunOS]: net_io_counters() failed to detect network interfaces correctly on Solaris 10.

  • #541, [FreeBSD]: disk_io_counters() r/w times were expressed in seconds instead of milliseconds.

  • #623, [Linux]: process or system connections raise ValueError if IPv6 is not supported by the system.

3.2.1 — 2015-09-03

Bug fixes

  • #677, [Linux], build-fail: can’t install psutil due to bug in setup.py.

3.2.0 — 2015-09-02

New APIs

API changes

Internals

  • #648, [macOS]: CI test integration.

Bug fixes

3.1.1 — 2015-07-15

Bug fixes

3.1.0 — 2015-07-15

API changes

Documentation

Internals

Bug fixes

3.0.1 — 2015-06-18

Bug fixes

  • #635, [POSIX], critical: crash on module import if enum package is installed on Python < 3.4.

  • #632, [Linux]: better error message if cannot parse process UNIX connections.

  • #634, [Linux]: Process.cmdline() does not include empty string arguments.

3.0.0 — 2015-06-13

New APIs

API changes

Build and packaging

  • #587: move native extension into the package.

Internals

  • #581: add .gitignore.

  • #602: pre-commit GIT hook.

  • #629: enhanced support for pytest and nose test runners.

  • #616, [Windows]: add inet_ntop() function for Windows XP.

Bug fixes

2.2.1 — 2015-02-02

Bug fixes

2.2.0 — 2015-01-06

New APIs

Dropped support

  • #521, breaking: Python 2.4 and 2.5.

Internals

Bug fixes

2.1.3 — 2014-09-26

Bug fixes

  • #536, [Linux], build-fail: fix “undefined symbol: CPU_ALLOC” compilation error.

2.1.2 — 2014-09-21

Build and packaging

  • #505, [Windows]: distribution as wheel packages.

Internals

  • #407: project moved from Google Code to Github; code moved from Mercurial to Git.

  • #492: use tox to run tests on multiple Python versions.

  • #511: add scripts/ps.py.

Bug fixes

2.1.1 — 2014-04-30

Bug fixes

2.1.0 — 2014-04-08

New APIs

Bug fixes

2.0.0 — 2014-03-10

New APIs

API changes

For the sake of consistency a lot of psutil APIs have been renamed. In most cases accessing the old names will work but it will cause a DeprecationWarning.

  • psutil.* module level constants have been replaced by functions:

    Old name

    Replacement

    psutil.NUM_CPUS

    psutil.cpu_count()

    psutil.BOOT_TIME

    psutil.boot_time()

    psutil.TOTAL_PHYMEM

    virtual_memory.total

  • Renamed psutil.* functions:

    Old name

    Replacement

    psutil.get_pid_list()

    psutil.pids()

    psutil.get_users()

    psutil.users()

    psutil.get_boot_time()

    psutil.boot_time()

  • All Process get_* methods lost the get_ prefix. E.g. get_ext_memory_info() was renamed to memory_info_ex(). Assuming p = psutil.Process():

    Old name

    Replacement

    p.get_children()

    p.children()

    p.get_connections()

    p.connections()

    p.get_cpu_affinity()

    p.cpu_affinity()

    p.get_cpu_percent()

    p.cpu_percent()

    p.get_cpu_times()

    p.cpu_times()

    p.get_ext_memory_info()

    p.memory_info_ex()

    p.get_io_counters()

    p.io_counters()

    p.get_ionice()

    p.ionice()

    p.get_memory_info()

    p.memory_info()

    p.get_memory_maps()

    p.memory_maps()

    p.get_memory_percent()

    p.memory_percent()

    p.get_nice()

    p.nice()

    p.get_num_ctx_switches()

    p.num_ctx_switches()

    p.get_num_fds()

    p.num_fds()

    p.get_num_threads()

    p.num_threads()

    p.get_open_files()

    p.open_files()

    p.get_rlimit()

    p.rlimit()

    p.get_threads()

    p.threads()

    p.getcwd()

    p.cwd()

  • All Process set_* methods lost the set_ prefix. Assuming p = psutil.Process():

    Old name

    Replacement

    p.set_nice()

    p.nice(value)

    p.set_ionice()

    p.ionice(ioclass, value=None)

    p.set_cpu_affinity()

    p.cpu_affinity(cpus)

    p.set_rlimit()

    p.rlimit(resource, limits=None)

  • Except for pid, all Process class properties have been turned into methods. This is the only case in which there are no aliases. Assuming p = psutil.Process():

    Old name

    Replacement

    p.name

    p.name()

    p.parent

    p.parent()

    p.ppid

    p.ppid()

    p.exe

    p.exe()

    p.cmdline

    p.cmdline()

    p.status

    p.status()

    p.uids

    p.uids()

    p.gids

    p.gids()

    p.username

    p.username()

    p.create_time

    p.create_time()

  • #479, breaking: long deprecated psutil.error module is gone; exception classes now live in “psutil” namespace only.

  • #463: timeout parameter of cpu_percent* functions defaults to 0.0 instead of 0.1, avoiding a common source of accidental slowdowns.

  • Process instances’ retcode attribute returned by wait_procs() has been renamed to returncode for consistency with subprocess.Popen.

Performance

Build and packaging

  • #424, [Windows]: installer for Python 3.X 64 bit.

Documentation

  • #468: move documentation to readthedocs.com.

Internals

  • #453: tests on Python < 2.7 require unittest2 module.

  • #459: add a Makefile for running tests and other repetitive tasks (also on Windows).

Bug fixes

1.2.1 — 2013-11-25

Bug fixes

  • #348, [Windows], critical: fixed “ImportError: DLL load failed” occurring on module import on Windows XP.

  • #425, [SunOS], critical: crash on import due to failure at determining BOOT_TIME.

  • #443, [Linux]: Process.cpu_affinity() can’t set affinity on systems with more than 64 cores.

1.2.0 — 2013-11-20

New APIs

  • #440: new wait_procs() utility function which waits for multiple processes to terminate.

API changes

Bug fixes

  • #348, [Windows], critical: fix “ImportError: DLL load failed” occurring on module import on Windows XP / Vista.

1.1.3 — 2013-11-07

Bug fixes

  • #442, [Linux], build-fail: psutil won’t compile on certain versions of Linux because of missing prlimit(2) syscall.

1.1.2 — 2013-10-22

Bug fixes

  • #442, [Linux], build-fail: psutil won’t compile on Debian 6.0 because of missing prlimit(2) syscall.

1.1.1 — 2013-10-08

Bug fixes

  • #442, [Linux], build-fail: psutil won’t compile on kernels < 2.6.36 due to missing prlimit(2) syscall.

1.1.0 — 2013-09-28

New APIs

API changes

  • #408: turn STATUS_* and CONN_* constants into plain Python strings.

Performance

Build and packaging

  • #410: host tar.gz and Windows binary files are on PyPI.

Bug fixes

1.0.1 — 2013-07-12

Bug fixes

1.0.0 — 2013-07-10

New platforms

  • #18, [SunOS]: Solaris (yay!) (thanks Justin Venus).

API changes

Internals

  • #380: test suite exits with non-zero on failure.

  • #391: introduce unittest2 facilities and provide workarounds if unittest2 is not installed (Python < 2.7).

Bug fixes

0.7.1 — 2013-05-03

Bug fixes

0.7.0 — 2013-04-12

New APIs

API changes

  • #246: psutil.error module is deprecated and scheduled for removal.

Internals

  • #233: code migrated to Mercurial (yay!)

Bug fixes

0.6.1 — 2012-08-16

API changes

Bug fixes

0.6.0 — 2012-08-13

New APIs

API changes

Performance

Internals

Bug fixes

  • #303, [Windows], critical: potential heap corruption in Process.num_threads() and Process.status() methods.

  • #306, critical: at C level, errors are not checked when invoking Py* functions which create or manipulate Python objects leading to potential memory related errors and/or segmentation faults.

  • #305, [FreeBSD], build-fail: can’t compile on FreeBSD 9 due to removal of utmp.h.

  • #298, [macOS], [BSD], memleak: memory leak in Process.num_fds().

  • #299, memleak: potential memory leak every time PyList_New(0) is used.

  • #307, [FreeBSD]: values returned by net_io_counters() are wrong.

  • #308, [BSD], [Windows]: psutil.virtmem_usage() wasn’t actually returning information about swap memory usage as it was supposed to do. It does now.

  • #310: Process.open_files() might not return files which can not be accessed due to limited permissions. AccessDenied is now raised instead.

0.5.1 — 2012-06-29

API changes

Bug fixes

0.5.0 — 2012-06-27

New APIs

API changes

Dropped support

  • #257, [Windows], breaking: Windows 2000.

Performance

Build and packaging

  • #274: psutil no longer requires 2to3 at installation time in order to work with Python 3.

Bug fixes

0.4.1 — 2011-12-14

Bug fixes

0.4.0 — 2011-10-29

New APIs

API changes

  • #198: Process.wait() with timeout=0 can now be used to make the function return immediately.

Performance

Build and packaging

  • #157, [Windows]: provide installer for Python 3.2 64-bit.

Internals

Bug fixes

  • #188, [Linux], critical: psutil import error on Linux ARM architectures.

  • #200, [Linux], critical: psutil.NUM_CPUS not working on armel and sparc architectures and causing crash on module import.

  • #218, [Linux], critical: crash at import time on Debian 64-bit because of a missing line in /proc/meminfo.

  • #226, [FreeBSD], critical: crash at import time on FreeBSD 7 and minor.

  • #135, [macOS]: psutil cannot create Process object.

  • #144, [Linux]: no longer support 0 special PID.

  • #194, [POSIX]: Process.cpu_percent() now reports a percentage over 100 on multi core processors.

  • #197, [Linux]: Process.connections() is broken on platforms not supporting IPv6.

  • #201, [Linux]: Process.connections() is broken on big-endian architectures.

  • #211: Process instance can unexpectedly raise NoSuchProcess if tested for equality with another object.

0.3.0 — 2011-07-08

New APIs

Build and packaging

  • #179: setuptools is now used in setup.py.

Bug fixes

0.2.1 — 2011-03-20

New APIs

API changes

  • #136, [FreeBSD]: Process.exe() path is now determined by asking the kernel instead of guessing it from cmdline[0].

  • Process uid and gid properties are deprecated in favor of uids and gids properties.

Performance

Bug fixes

0.2.0 — 2010-11-13

New platforms

  • #107, [Windows]: Windows 64 bit.

  • #117, [Windows]: Windows 2000.

New APIs

API changes

Performance

  • #114, [Windows]: Process.username() rewritten in C (no longer uses WMI, much faster, pywin32 no longer required).

Bug fixes

0.1.3 — 2010-03-02

New platforms

  • #61, [FreeBSD]: FreeBSD 64 bit.

  • #75: Python 3.

New APIs

Performance

Bug fixes

0.1.2 — 2009-05-06

New APIs

Bug fixes

0.1.1 — 2009-03-06

New platforms

  • #4, [FreeBSD]: support for all functions of psutil.

New APIs

API changes

  • #12, #15: NoSuchProcess exception now raised when creating an object for a nonexistent process, or when retrieving information about a process that has gone away.

  • Process objects can now also be compared with == operator for equality (PID, name, command line are compared).

Bug fixes

  • #16, [Windows]: special case for “System Idle Process” (PID 0) which otherwise would return an “invalid parameter” exception.

  • #17: get_process_list() ignores NoSuchProcess and AccessDenied exceptions during building of the list.

  • #22, [Windows]: Process.kill() for PID 0 was failing with an unset exception.

  • #23, [Linux], [macOS]: create special case for pid_exists() with PID 0.

  • #24, [Windows]: Process.kill() for PID 0 now raises AccessDenied exception instead of WindowsError.

  • #30: psutil.get_pid_list() was returning two 0 PIDs.

0.1.0 — 2009-01-27

Initial release. Supports Linux, Windows, and macOS via per-platform backends (_pslinux, _psmswindows, _psosx) with C extensions for Windows and macOS.

New APIs

  • Process class exposing pid, name, path, and cmdline, with a kill() method.

  • get_process_list() returning all running processes.

  • ProcessInfo value object passed between the public API and the platform backends.