Skip to content

Latest commit

 

History

History
4270 lines (3790 loc) · 192 KB

HISTORY.rst

File metadata and controls

4270 lines (3790 loc) · 192 KB

Bug tracker at https://github.com/giampaolo/psutil/issues

5.8.1 (IN DEVELOPMENT)

XXXX-XX-XX

Enhancements

  • 1851: [Linux] cpu_freq() is slow on systems with many CPUs. Read current frequency values for all CPUs from /proc/cpuinfo instead of opening many files in /sys fs. (patch by marxin)

Bug fixes

  • 1456: [macOS] psutil.cpu_freq()'s min and max are set to 0 if can't be determined (instead of crashing).
  • 1512: [macOS] sometimes Process.connections() will crash with EOPNOTSUPP for one connection; this is now ignored.
  • 1892: [macOS] psutil.cpu_freq() broken on Apple M1.
  • 1904: [Windows] OpenProcess fails with ERROR_SUCCESS due to GetLastError() called after sprintf(). (patch by alxchk)
  • 1874: [Solaris] swap output error due to incorrect range.
  • 1913: [Linux] wait_procs seemingly ignoring timeout, TimeoutExpired thrown
  • 1921: [Windows] psutil.swap_memory() shows committed memory instead of swap

5.8.0

2020-12-19

Enhancements

  • 1863: disk_partitions() exposes 2 extra fields: maxfile and maxpath, which are the maximum file name and path name length.
  • 1872: [Windows] added support for PyPy 2.7.
  • 1879: provide pre-compiled wheels for Linux and macOS (yey!).
  • 1880: get rid of Travis and Cirrus CI services (they are no longer free). CI testing is now done by GitHub Actions on Linux, macOS and FreeBSD (yes). AppVeyor is still being used for Windows CI.

Bug fixes

  • 1708: [Linux] get rid of sensors_temperatures() duplicates. (patch by Tim Schlueter).
  • 1839: [Windows] always raise AccessDenied when failing to query 64 processes from 32 bit ones (NtWoW64 APIs).
  • 1866: [Windows] process exe(), cmdline(), environ() may raise "invalid access to memory location" on Python 3.9.
  • 1874: [Solaris] wrong swap output given when encrypted column is present.
  • 1875: [Windows] process username() may raise ERROR_NONE_MAPPED if the SID has no corresponding account name. In this case AccessDenied is now raised.
  • 1877: [Windows] OpenProcess may fail with ERROR_SUCCESS. Turn it into AccessDenied or NoSuchProcess depending on whether the PID is alive.
  • 1886: [macOS] EIO error may be raised on cmdline() and environment(). Now it gets translated into AccessDenied.
  • 1891: [macOS] get rid of deprecated getpagesize().

5.7.3

2020-10-23

Enhancements

  • 809: [FreeBSD] add support for Process.rlimit().
  • 893: [BSD] add support for Process.environ() (patch by Armin Gruner)
  • 1830: [UNIX] net_if_stats()'s isup also checks whether the NIC is running (meaning Wi-Fi or ethernet cable is connected). (patch by Chris Burger)
  • 1837: [Linux] improved battery detection and charge "secsleft" calculation (patch by aristocratos)

Bug fixes

  • 1620: [Linux] cpu_count(logical=False) result is incorrect on systems with more than one CPU socket. (patch by Vincent A. Arcila)
  • 1738: [macOS] Process.exe() may raise FileNotFoundError if process is still alive but the exe file which launched it got deleted.
  • 1791: [macOS] fix missing include for getpagesize().
  • 1823: [Windows] Process.open_files() may cause a segfault due to a NULL pointer.
  • 1838: [Linux] sensors_battery(): if percent can be determined but not the remaining values, still return a result instead of None. (patch by aristocratos)

5.7.2

2020-07-15

Bug fixes

  • wheels for 2.7 were inadvertently deleted.

5.7.1

2020-07-15

Enhancements

  • 1729: parallel tests on UNIX (make test-parallel). They're twice as fast!

  • 1741: "make build/install" is now run in parallel and it's about 15% faster on UNIX.

  • 1747: Process.wait() on POSIX returns an enum, showing the negative signal which was used to terminate the process:

    >>> import psutil
    >>> p = psutil.Process(9891)
    >>> p.terminate()
    >>> p.wait()
    <Negsignal.SIGTERM: -15>
    
  • 1747: Process.wait() return value is cached so that the exit code can be retrieved on then next call.

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

    >>> proc
    psutil.Process(pid=12739, name='python3', status='terminated',
                   exitcode=<Negsigs.SIGTERM: -15>, started='15:08:20')
    
  • 1757: memory leak tests are now stable.

  • 1768: [Windows] added support for Windows Nano Server. (contributed by Julien Lebot)

Bug fixes

  • 1726: [Linux] cpu_freq() parsing should use spaces instead of tabs on ia64. (patch by Michał Górny)
  • 1760: [Linux] Process.rlimit() does not handle long long type properly.
  • 1766: [macOS] NoSuchProcess may be raised instead of ZombieProcess.
  • 1781: fix signature of callback function for getloadavg(). (patch by Ammar Askar)

5.7.0

2020-02-18

Enhancements

  • 1637: [SunOS] add partial support for old SunOS 5.10 Update 0 to 3.
  • 1648: [Linux] sensors_temperatures() looks into an additional /sys/device/ directory for additional data. (patch by Javad Karabi)
  • 1652: [Windows] dropped support for Windows XP and Windows Server 2003. Minimum supported Windows version now is Windows Vista.
  • 1671: [FreeBSD] add CI testing/service for FreeBSD (Cirrus CI).
  • 1677: [Windows] process exe() will succeed for all process PIDs (instead of raising AccessDenied).
  • 1679: [Windows] net_connections() and Process.connections() are 10% faster.
  • 1682: [PyPy] added CI / test integration for PyPy via Travis.
  • 1686: [Windows] added support for PyPy on Windows.
  • 1693: [Windows] boot_time(), Process.create_time() and users()'s login time now have 1 micro second precision (before the precision was of 1 second).

Bug fixes

  • 1538: [NetBSD] process cwd() may return ENOENT instead of NoSuchProcess.
  • 1627: [Linux] Process.memory_maps() can raise KeyError.
  • 1642: [SunOS] querying basic info for PID 0 results in FileNotFoundError.
  • 1646: [FreeBSD] many Process methods may cause a segfault on FreeBSD 12.0 due to a backward incompatible change in a C type introduced in 12.0.
  • 1656: [Windows] Process.memory_full_info() raises AccessDenied even for the current user and os.getpid().
  • 1660: [Windows] Process.open_files() complete rewrite + check of errors.
  • 1662: [Windows] process exe() may raise WinError 0.
  • 1665: [Linux] disk_io_counters() does not take into account extra fields added to recent kernels. (patch by Mike Hommey)
  • 1672: use the right C type when dealing with PIDs (int or long). Thus far (long) was almost always assumed, which is wrong on most platforms.
  • 1673: [OpenBSD] Process connections(), num_fds() and threads() returned improper exception if process is gone.
  • 1674: [SunOS] disk_partitions() may raise OSError.
  • 1684: [Linux] disk_io_counters() may raise ValueError on systems not having /proc/diskstats.
  • 1695: [Linux] could not compile on kernels <= 2.6.13 due to PSUTIL_HAVE_IOPRIO not being defined. (patch by Anselm Kruis)

5.6.7

2019-11-26

Bug fixes

  • 1630: [Windows] can't compile source distribution due to C syntax error.

5.6.6

2019-11-25

Bug fixes

  • 1179: [Linux] Process cmdline() now takes into account misbehaving processes renaming the command line and using inappropriate chars to separate args.
  • 1616: use of Py_DECREF instead of Py_CLEAR will result in double free and segfault (CVE-2019-18874). (patch by Riccardo Schirone)
  • 1619: [OpenBSD] compilation fails due to C syntax error. (patch by Nathan Houghton)

5.6.5

2019-11-06

Bug fixes

  • 1615: remove pyproject.toml as it was causing installation issues.

5.6.4

2019-11-04

Enhancements

  • 1527: [Linux] added Process.cpu_times().iowait counter, which is the time spent waiting for blocking I/O to complete.
  • 1565: add PEP 517/8 build backend and requirements specification for better pip integration. (patch by Bernát Gábor)

Bug fixes

  • 875: [Windows] Process' cmdline(), environ() or cwd() may occasionally fail with ERROR_PARTIAL_COPY which now gets translated to AccessDenied.
  • 1126: [Linux] cpu_affinity() segfaults on CentOS 5 / manylinux. cpu_affinity() support for CentOS 5 was removed.
  • 1528: [AIX] compilation error on AIX 7.2 due to 32 vs 64 bit differences. (patch by Arnon Yaari)
  • 1535: 'type' and 'family' fields returned by net_connections() are not always turned into enums.
  • 1536: [NetBSD] process cmdline() erroneously raise ZombieProcess error if cmdline has non encodable chars.
  • 1546: usage percent may be rounded to 0 on Python 2.
  • 1552: [Windows] getloadavg() math for calculating 5 and 15 mins values is incorrect.
  • 1568: [Linux] use CC compiler env var if defined.
  • 1570: [Windows] NtWow64* syscalls fail to raise the proper error code
  • 1585: [OSX] calling close() (in C) on possible negative integers. (patch by Athos Ribeiro)
  • 1606: [SunOS] compilation fails on SunOS 5.10. (patch by vser1)

5.6.3

2019-06-11

Enhancements

  • 1494: [AIX] added support for Process.environ(). (patch by Arnon Yaari)

Bug fixes

  • 1276: [AIX] can't get whole cmdline(). (patch by Arnon Yaari)
  • 1501: [Windows] Process cmdline() and exe() raise unhandled "WinError 1168 element not found" exceptions for "Registry" and "Memory Compression" psuedo processes on Windows 10.
  • 1526: [NetBSD] process cmdline() could raise MemoryError. (patch by Kamil Rytarowski)

5.6.2

2019-04-26

Enhancements

  • 604: [Windows, Windows] add new psutil.getloadavg(), returning system load average calculation, including on Windows (emulated). (patch by Ammar Askar)
  • 1404: [Linux] cpu_count(logical=False) uses a second method (read from /sys/devices/system/cpu/cpu[0-9]/topology/core_id) in order to determine the number of CPU cores in case /proc/cpuinfo does not provide this info.
  • 1458: provide coloured test output. Also show failures on KeyboardInterrupt.
  • 1464: various docfixes (always point to python3 doc, fix links, etc.).
  • 1476: [Windows] it is now possible to set process high I/O priority (ionice()).Also, I/O priority values are now exposed as 4 new constants: IOPRIO_VERYLOW, IOPRIO_LOW, IOPRIO_NORMAL, IOPRIO_HIGH.
  • 1478: add make command to re-run tests failed on last run.

Bug fixes

  • 1223: [Windows] boot_time() may return value on Windows XP.
  • 1456: [Linux] cpu_freq() returns None instead of 0.0 when min/max not available (patch by Alex Manuskin)
  • 1462: [Linux] (tests) make tests invariant to LANG setting (patch by Benjamin Drung)
  • 1463: cpu_distribution.py script was broken.
  • 1470: [Linux] disk_partitions(): fix corner case when /etc/mtab doesn't exist. (patch by Cedric Lamoriniere)
  • 1471: [SunOS] Process name() and cmdline() can return SystemError. (patch by Daniel Beer)
  • 1472: [Linux] cpu_freq() does not return all CPUs on Rasbperry-pi 3.
  • 1474: fix formatting of psutil.tests() which mimicks 'ps aux' output.
  • 1475: [Windows] OSError.winerror attribute wasn't properly checked resuling in WindowsError being raised instead of AccessDenied.
  • 1477: [Windows] wrong or absent error handling for private NTSTATUS Windows APIs. Different process methods were affected by this.
  • 1480: [Windows] psutil.cpu_count(logical=False) could cause a crash due to fixed read violation. (patch by Samer Masterson)
  • 1486: [AIX, SunOS] AttributeError when interacting with Process methods involved into oneshot() context.
  • 1491: [SunOS] net_if_addrs(): free() ifap struct on error. (patch by Agnewee)
  • 1493: [Linux] cpu_freq(): handle the case where /sys/devices/system/cpu/cpufreq/ exists but is empty.

5.6.1

2019-03-11

Bug fixes

  • 1329: [AIX] psutil doesn't compile on AIX 6.1. (patch by Arnon Yaari)
  • 1448: [Windows] crash on import due to rtlIpv6AddressToStringA not available on Wine.
  • 1451: [Windows] Process.memory_full_info() segfaults. NtQueryVirtualMemory is now used instead of QueryWorkingSet to calculate USS memory.

5.6.0

2019-03-05

Enhancements

  • 1379: [Windows] Process suspend() and resume() now use NtSuspendProcess and NtResumeProcess instead of stopping/resuming all threads of a process. This is faster and more reliable (aka this is what ProcessHacker does).
  • 1420: [Windows] in case of exception disk_usage() now also shows the path name.
  • 1422: [Windows] Windows APIs requiring to be dynamically loaded from DLL libraries are now loaded only once on startup (instead of on per function call) significantly speeding up different functions and methods.
  • 1426: [Windows] PAGESIZE and number of processors is now calculated on startup.
  • 1428: in case of error, the traceback message now shows the underlying C function called which failed.
  • 1433: new Process.parents() method. (idea by Ghislain Le Meur)
  • 1437: pids() are returned in sorted order.
  • 1442: python3 is now the default interpreter used by Makefile.

Bug fixes

  • 1353: process_iter() is now thread safe (it rarely raised TypeError).
  • 1394: [Windows] Process name() and exe() may erroneously return "Registry". QueryFullProcessImageNameW is now used instead of GetProcessImageFileNameW in order to prevent that.
  • 1411: [BSD] lack of Py_DECREF could cause segmentation fault on process instantiation.
  • 1419: [Windows] Process.environ() raises NotImplementedError when querying a 64-bit process in 32-bit-WoW mode. Now it raises AccessDenied.
  • 1427: [OSX] Process cmdline() and environ() may erroneously raise OSError on failed malloc().
  • 1429: [Windows] SE DEBUG was not properly set for current process. It is now, and it should result in less AccessDenied exceptions for low-pid processes.
  • 1432: [Windows] Process.memory_info_ex()'s USS memory is miscalculated because we're not using the actual system PAGESIZE.
  • 1439: [NetBSD] Process.connections() may return incomplete results if using oneshot().
  • 1447: original exception wasn't turned into NSP/AD exceptions when using Process.oneshot() ctx manager.

Incompatible API changes

  • 1291: [OSX] Process.memory_maps() was removed because inherently broken (segfault) for years.

5.5.1

2019-02-15

Enhancements

  • 1348: [Windows] on Windows >= 8.1 if Process.cmdline() fails due to ERROR_ACCESS_DENIED attempt using NtQueryInformationProcess + ProcessCommandLineInformation. (patch by EccoTheFlintstone)

Bug fixes

  • 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.
  • 1408: [AIX] psutil won't compile on AIX 7.1 due to missing header. (patch by Arnon Yaari)

5.5.0

2019-01-23

Enhancements

  • 1350: [FreeBSD] added support for sensors_temperatures(). (patch by Alex Manuskin)
  • 1352: [FreeBSD] added support for CPU frequency. (patch by Alex Manuskin)

Bug fixes

  • 1111: Process.oneshot() is now thread safe.
  • 1354: [Linux] disk_io_counters() fails on Linux kernel 4.18+.
  • 1357: [Linux] Process' memory_maps() and io_counters() method are no longer exposed if not supported by the kernel.
  • 1368: [Windows] fix psutil.Process().ionice(...) mismatch. (patch by EccoTheFlintstone)
  • 1370: [Windows] improper usage of CloseHandle() may lead to override the original error code when raising an exception.
  • 1373: incorrect handling of cache in Process.oneshot() context causes Process instances to return incorrect results.
  • 1376: [Windows] OpenProcess() now uses PROCESS_QUERY_LIMITED_INFORMATION access rights wherever possible, resulting in less AccessDenied exceptions being thrown for system processes.
  • 1376: [Windows] check if variable is NULL before free()ing it. (patch by EccoTheFlintstone)

5.4.8

2018-10-30

Enhancements

  • 1197: [Linux] cpu_freq() is now implemented by parsing /proc/cpuinfo in case /sys/devices/system/cpu/* filesystem is not available.
  • 1310: [Linux] psutil.sensors_temperatures() now parses /sys/class/thermal in case /sys/class/hwmon fs is not available (e.g. Raspberry Pi). (patch by Alex Manuskin)
  • 1320: [Posix] better compilation support when using g++ instead of gcc. (patch by Jaime Fullaondo)

Bug fixes

  • 715: do not print exception on import time in case cpu_times() fails.
  • 1004: [Linux] Process.io_counters() may raise ValueError.
  • 1277: [OSX] available and used memory (psutil.virtual_memory()) metrics are not accurate.
  • 1294: [Windows] psutil.Process().connections() may sometimes fail with intermittent 0xC0000001. (patch by Sylvain Duchesne)
  • 1307: [Linux] disk_partitions() does not honour PROCFS_PATH.
  • 1320: [AIX] system CPU times (psutil.cpu_times()) were being reported with ticks unit as opposed to seconds. (patch by Jaime Fullaondo)
  • 1332: [OSX] psutil debug messages are erroneously printed all the time. (patch by Ilya Yanok)
  • 1346: [SunOS] net_connections() returns an empty list. (patch by Oleksii Shevchuk)

5.4.7

2018-08-14

Enhancements

  • 1286: [macOS] psutil.OSX constant is now deprecated in favor of new psutil.MACOS.
  • 1309: [Linux] added psutil.STATUS_PARKED constant for Process.status().
  • 1321: [Linux] add disk_io_counters() dual implementation relying on /sys/block filesystem in case /proc/diskstats is not available. (patch by Lawrence Ye)

Bug fixes

  • 1209: [macOS] Process.memory_maps() may fail with EINVAL due to poor task_for_pid() syscall. AccessDenied is now raised instead.
  • 1278: [macOS] Process.threads() incorrectly return microseconds instead of seconds. (patch by Nikhil Marathe)
  • 1279: [Linux, macOS, BSD] net_if_stats() may return ENODEV.
  • 1294: [Windows] psutil.Process().connections() may sometime fail with MemoryError. (patch by sylvainduchesne)
  • 1305: [Linux] disk_io_stats() may report inflated r/w bytes values.
  • 1309: [Linux] Process.status() is unable to recognize "idle" and "parked" statuses (returns '?').
  • 1313: [Linux] disk_io_counters() can report inflated IO counters due to erroneously counting base disk device and its partition(s) twice.
  • 1323: [Linux] sensors_temperatures() may fail with ValueError.

5.4.6

2018-06-07

Bug fixes

  • 1258: [Windows] Process.username() may cause a segfault (Python interpreter crash). (patch by Jean-Luc Migot)
  • 1273: net_if_addr() namedtuple's name has been renamed from "snic" to "snicaddr".
  • 1274: [Linux] there was a small chance Process.children() may swallow AccessDenied exceptions.

5.4.5

2018-04-14

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

Enhancements

  • 1239: [Linux] expose kernel "slab" memory for psutil.virtual_memory(). (patch by Maxime Mouial)

Bug fixes

  • 694: [SunOS] 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. (patch by Georg Sauthoff)
  • 771: [Windows] cpu_count() (both logical and cores) return a wrong (smaller) number on systems using process groups (> 64 cores).
  • 771: [Windows] cpu_times(percpu=True) return fewer CPUs on systems using process groups (> 64 cores).
  • 771: [Windows] cpu_stats() and cpu_freq() may return incorrect results on systems using process groups (> 64 cores).
  • 1193: [SunOS] Return uid/gid from /proc/pid/psinfo if there aren't enough permissions for /proc/pid/cred. (patch by Georg Sauthoff)
  • 1194: [SunOS] Return nice value from psinfo as getpriority() doesn't support real-time processes. (patch by Georg Sauthoff)
  • 1194: [SunOS] Fix double free in psutil_proc_cpu_num(). (patch by Georg Sauthoff)
  • 1194: [SunOS] Fix undefined behavior related to strict-aliasing rules and warnings. (patch by Georg Sauthoff)
  • 1210: [Linux] cpu_percent() steal time may remain stuck at 100% due to Linux erroneously reporting a decreased steal time between calls. (patch by Arnon Yaari)
  • 1216: fix compatibility with python 2.6 on Windows (patch by Dan Vinakovsky)
  • 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. (patch by stswandering)
  • 1245: [Linux] sensors_temperatures() may fail with IOError "no such file".
  • 1255: [FreeBSD] swap_memory() stats were erroneously represented in KB. (patch by Denis Krienbühl)

Backward compatibility

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

5.4.3

2018-01-01

Enhancements

  • 775: disk_partitions() on Windows return mount points.

Bug fixes

  • 1193: pids() may return False on macOS.

5.4.2

2017-12-07

Enhancements

  • 1173: introduced PSUTIL_DEBUG environment variable which can be set in order to print useful debug messages on stderr (useful in case of nasty errors).
  • 1177: added support for sensors_battery() on macOS. (patch by Arnon Yaari)
  • 1183: Process.children() is 2x faster on UNIX and 2.4x faster on Linux.
  • 1188: deprecated method Process.memory_info_ex() now warns by using FutureWarning instead of DeprecationWarning.

Bug fixes

  • 1152: [Windows] disk_io_counters() may return an empty dict.
  • 1169: [Linux] users() "hostname" returns username instead. (patch by janderbrain)
  • 1172: [Windows] make test does not work.
  • 1179: [Linux] Process.cmdline() is now able to splits cmdline args for misbehaving processes which overwrite /proc/pid/cmdline and use spaces instead of null bytes as args separator.
  • 1181: [macOS] Process.memory_maps() may raise ENOENT.
  • 1187: [macOS] pids() does not return PID 0 on recent macOS versions.

5.4.1

2017-11-08

Enhancements

  • 1164: [AIX] add support for Process.num_ctx_switches(). (patch by Arnon Yaari)
  • 1053: abandon Python 3.3 support (psutil still works but it's no longer tested).

Bug fixes

  • 1150: [Windows] when a process is terminate()d now the exit code is set to SIGTERM instead of 0. (patch by Akos Kiss)
  • 1151: python -m psutil.tests fail
  • 1154: [AIX] psutil won't compile on AIX 6.1.0. (patch by Arnon Yaari)
  • 1167: [Windows] net_io_counter() packets count now include also non-unicast packets. (patch by Matthew Long)

5.4.0

2017-10-12

Enhancements

  • 1123: [AIX] added support for AIX platform. (patch by Arnon Yaari)

Bug fixes

  • 1009: [Linux] sensors_temperatures() may crash with IOError.
  • 1012: [Windows] disk_io_counters()'s read_time and write_time were expressed in tens of micro seconds instead of milliseconds.
  • 1127: [macOS] invalid reference counting in Process.open_files() may lead to segfault. (patch by Jakub Bacic)
  • 1129: [Linux] sensors_fans() may crash with IOError. (patch by Sebastian Saip)
  • 1131: [SunOS] fix compilation warnings. (patch by Arnon Yaari)
  • 1133: [Windows] can't compile on newer versions of Visual Studio 2017 15.4. (patch by Max Bélanger)
  • 1138: [Linux] can't compile on CentOS 5.0 and RedHat 5.0. (patch by Prodesire)

5.3.1

2017-09-10

Enhancements

Bug fixes

  • 1105: [FreeBSD] psutil does not compile on FreeBSD 12.
  • 1125: [BSD] net_connections() raises TypeError.

Compatibility notes

  • 1120: .exe files for Windows are no longer uploaded on PyPI as per PEP-527; only wheels are provided.

5.3.0

2017-09-01

Enhancements

  • 802: disk_io_counters() and net_io_counters() numbers no longer wrap (restart from 0). Introduced a new "nowrap" argument.
  • 928: psutil.net_connections() and psutil.Process.connections() "laddr" and "raddr" are now named tuples.
  • 1015: swap_memory() now relies on /proc/meminfo instead of sysinfo() syscall so that it can be used in conjunction with PROCFS_PATH in order to retrieve memory info about Linux containers such as Docker and Heroku.
  • 1022: psutil.users() provides a new "pid" field.
  • 1025: process_iter() accepts two new parameters in order to invoke Process.as_dict(): "attrs" and "ad_value". With this you can iterate over all processes in one shot without needing to catch NoSuchProcess and do list/dict comprehensions.
  • 1040: implemented full unicode support.
  • 1051: disk_usage() on Python 3 is now able to accept bytes.
  • 1058: test suite now enables all warnings by default.
  • 1060: source distribution is dynamically generated so that it only includes relevant files.
  • 1079: [FreeBSD] net_connections()'s fd number is now being set for real (instead of -1). (patch by Gleb Smirnoff)
  • 1091: [SunOS] implemented Process.environ(). (patch by Oleksii Shevchuk)

Bug fixes

  • 989: [Windows] boot_time() may return a negative value.
  • 1007: [Windows] boot_time() can have a 1 sec fluctuation between calls; the value of the first call is now cached so that boot_time() always returns the same value if fluctuation is <= 1 second.
  • 1013: [FreeBSD] psutil.net_connections() may return incorrect PID. (patch by Gleb Smirnoff)
  • 1014: [Linux] Process class can mask legitimate ENOENT exceptions as NoSuchProcess.
  • 1016: disk_io_counters() raises RuntimeError on a system with no disks.
  • 1017: net_io_counters() raises RuntimeError on a system with no network cards installed.
  • 1021: [Linux] open_files() may erroneously raise NoSuchProcess instead of skipping a file which gets deleted while open files are retrieved.
  • 1029: [macOS, FreeBSD] Process.connections('unix') on Python 3 doesn't properly handle unicode paths and may raise UnicodeDecodeError.
  • 1033: [macOS, FreeBSD] memory leak for net_connections() and Process.connections() when retrieving UNIX sockets (kind='unix').
  • 1040: fixed many unicode related issues such as UnicodeDecodeError on Python 3 + UNIX and invalid encoded data on Windows.
  • 1042: [FreeBSD] psutil won't compile on FreeBSD 12.
  • 1044: [macOS] different Process methods incorrectly raise AccessDenied for zombie processes.
  • 1046: [Windows] disk_partitions() on Windows overrides user's SetErrorMode.
  • 1047: [Windows] Process username(): memory leak in case exception is thrown.
  • 1048: [Windows] users()'s host field report an invalid IP address.
  • 1050: [Windows] Process.memory_maps memory() leaks memory.
  • 1055: cpu_count() is no longer cached; this is useful on systems such as Linux where CPUs can be disabled at runtime. This also reflects on Process.cpu_percent() which no longer uses the cache.
  • 1058: fixed Python warnings.
  • 1062: disk_io_counters() and net_io_counters() raise TypeError if no disks or NICs are installed on the system.
  • 1063: [NetBSD] net_connections() may list incorrect sockets.
  • 1064: [NetBSD] swap_memory() may segfault in case of error.
  • 1065: [OpenBSD] Process.cmdline() may raise SystemError.
  • 1067: [NetBSD] Process.cmdline() leaks memory if process has terminated.
  • 1069: [FreeBSD] Process.cpu_num() may return 255 for certain kernel processes.
  • 1071: [Linux] cpu_freq() may raise IOError on old RedHat distros.
  • 1074: [FreeBSD] sensors_battery() raises OSError in case of no battery.
  • 1075: [Windows] net_if_addrs(): inet_ntop() return value is not checked.
  • 1077: [SunOS] net_if_addrs() shows garbage addresses on SunOS 5.10. (patch by Oleksii Shevchuk)
  • 1077: [SunOS] net_connections() does not work on SunOS 5.10. (patch by Oleksii Shevchuk)
  • 1079: [FreeBSD] net_connections() didn't list locally connected sockets. (patch by Gleb Smirnoff)
  • 1085: cpu_count() return value is now checked and forced to None if <= 1.
  • 1087: Process.cpu_percent() guard against cpu_count() returning None and assumes 1 instead.
  • 1093: [SunOS] memory_maps() shows wrong 64 bit addresses.
  • 1094: [Windows] psutil.pid_exists() may lie. Also, all process APIs relying on OpenProcess Windows API now check whether the PID is actually running.
  • 1098: [Windows] Process.wait() may erroneously return sooner, when the PID is still alive.
  • 1099: [Windows] Process.terminate() may raise AccessDenied even if the process already died.
  • 1101: [Linux] sensors_temperatures() may raise ENODEV.

Porting notes

  • 1039: returned types consolidation: - Windows / Process.cpu_times(): fields #3 and #4 were int instead of float - Linux / FreeBSD: connections('unix'): raddr is now set to "" instead of

    None

    • OpenBSD: connections('unix'): laddr and raddr are now set to "" instead of None
  • 1040: all strings are encoded by using OS fs encoding.

  • 1040: the following Windows APIs on Python 2 now return a string instead of unicode: - Process.memory_maps().path - WindowsService.bin_path() - WindowsService.description() - WindowsService.display_name() - WindowsService.username()

5.2.2

2017-04-10

Bug fixes

  • 1000: fixed some setup.py warnings.
  • 1002: [SunOS] remove C macro which will not be available on new Solaris versions. (patch by Danek Duvall)
  • 1004: [Linux] Process.io_counters() may raise ValueError.
  • 1006: [Linux] cpu_freq() may return None on some Linux versions does not support the function; now the function is not declared instead.
  • 1009: [Linux] sensors_temperatures() may raise OSError.
  • 1010: [Linux] virtual_memory() may raise ValueError on Ubuntu 14.04.

5.2.1

2017-03-24

Bug fixes

  • 981: [Linux] cpu_freq() may return an empty list.
  • 993: [Windows] Process.memory_maps() on Python 3 may raise UnicodeDecodeError.
  • 996: [Linux] sensors_temperatures() may not show all temperatures.
  • 997: [FreeBSD] virtual_memory() may fail due to missing sysctl parameter on FreeBSD 12.

5.2.0

2017-03-05

Enhancements

  • 971: [Linux] Add psutil.sensors_fans() function. (patch by Nicolas Hennion)
  • 976: [Windows] Process.io_counters() has 2 new fields: other_count and other_bytes.
  • 976: [Linux] Process.io_counters() has 2 new fields: read_chars and write_chars.

Bug fixes

  • 872: [Linux] can now compile on Linux by using MUSL C library.
  • 985: [Windows] Fix a crash in Process.open_files when the worker thread for NtQueryObject times out.
  • 986: [Linux] Process.cwd() may raise NoSuchProcess instead of ZombieProcess.

5.1.3

Bug fixes

  • 971: [Linux] sensors_temperatures() didn't work on CentOS 7.
  • 973: cpu_percent() may raise ZeroDivisionError.

5.1.2

2017-02-03

Bug fixes

  • 966: [Linux] sensors_battery().power_plugged may erroneously return None on Python 3.
  • 968: [Linux] disk_io_counters() raises TypeError on python 3.
  • 970: [Linux] sensors_battery()'s name and label fields on Python 3 are bytes instead of str.

5.1.1

2017-02-03

Enhancements

  • 966: [Linux] sensors_battery().percent is a float and is more precise.

Bug fixes

  • 964: [Windows] Process.username() and psutil.users() may return badly decoding character on Python 3.
  • 965: [Linux] disk_io_counters() may miscalculate sector size and report the wrong number of bytes read and written.
  • 966: [Linux] sensors_battery() may fail with "no such file error".
  • 966: [Linux] sensors_battery().power_plugged may lie.

5.1.0

2017-02-01

Enhancements

  • 357: added psutil.Process.cpu_num() (what CPU a process is on).
  • 371: added psutil.sensors_temperatures() (Linux only).
  • 941: added psutil.cpu_freq() (CPU frequency).
  • 955: added psutil.sensors_battery() (Linux, Windows, only).
  • 956: cpu_affinity([]) can now be used as an alias to set affinity against all eligible CPUs.

Bug fixes

  • 687: [Linux] pid_exists() no longer returns True if passed a process thread ID.
  • 948: cannot install psutil with PYTHONOPTIMIZE=2.
  • 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 ``kill()``ed by a signal.
  • 961: [Windows] WindowsService.description() may fail with ERROR_MUI_FILE_NOT_FOUND.

5.0.1

2016-12-21

Enhancements

  • 939: tar.gz distribution went from 1.8M to 258K.
  • 811: [Windows] provide a more meaningful error message if trying to use psutil on unsupported Windows XP.

Bug fixes

  • 609: [SunOS] psutil does not compile on Solaris 10.
  • 936: [Windows] fix compilation error on VS 2013 (patch by Max Bélanger).
  • 940: [Linux] cpu_percent() and cpu_times_percent() was calculated incorrectly as "iowait", "guest" and "guest_nice" times were not properly taken into account.
  • 944: [OpenBSD] psutil.pids() was omitting PID 0.

5.0.0

2016-11-06

Enhncements

  • 799: new Process.oneshot() context manager making Process methods around +2x faster in general and from +2x to +6x faster on Windows.
  • 943: better error message in case of version conflict on import.

Bug fixes

  • 932: [NetBSD] net_connections() and Process.connections() may fail without raising an exception.
  • 933: [Windows] memory leak in cpu_stats() and WindowsService.description().

4.4.2

2016-10-26

Bug fixes

  • 931: 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

Enhancements

  • 874: [Windows] net_if_addrs() returns also the netmask.
  • 887: [Linux] virtual_memory()'s 'available' and 'used' values are more precise and match "free" cmdline utility. "available" also takes into account LCX containers preventing "available" to overflow "total".
  • 891: procinfo.py script has been updated and provides a lot more info.

Bug fixes

  • 514: [macOS] possibly fix Process.memory_maps() segfault (critical!).
  • 783: [macOS] Process.status() may erroneously return "running" for zombie processes.
  • 798: [Windows] Process.open_files() returns and empty list on Windows 10.
  • 825: [Linux] cpu_affinity; fix possible double close and use of unopened socket.
  • 880: [Windows] Handle race condition inside psutil_net_connections.
  • 885: ValueError is raised if a negative integer is passed to cpu_percent() functions.
  • 892: [Linux] Process.cpu_affinity([-1]) raise SystemError with no error set; now ValueError is raised.
  • 906: [BSD] disk_partitions(all=False) returned an empty list. Now the argument is ignored and all partitions are always returned.
  • 907: [FreeBSD] Process.exe() may fail with OSError(ENOENT).
  • 908: [macOS, BSD] different process methods could errounesuly mask the real error for high-privileged PIDs and raise NoSuchProcess and AccessDenied instead of OSError and RuntimeError.
  • 909: [macOS] Process open_files() and connections() methods may raise OSError with no exception set if process is gone.
  • 916: [macOS] fix many compilation warnings.

4.3.1

2016-09-01

Enhancements

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

Bug fixes

  • 854: Process.as_dict() raises ValueError if passed an erroneous attrs name.
  • 857: [SunOS] Process cpu_times(), cpu_percent(), threads() amd memory_maps() may raise RuntimeError if attempting to query a 64bit process with a 32bit python. "Null" values are returned as a fallback.
  • 858: Process.as_dict() should not return memory_info_ex() because it's deprecated.
  • 863: [Windows] memory_map truncates addresses above 32 bits
  • 866: [Windows] win_service_iter() and services in general are not able to handle unicode service names / descriptions.
  • 869: [Windows] Process.wait() may raise TimeoutExpired with wrong timeout unit (ms instead of sec).
  • 870: [Windows] Handle leak inside psutil_get_process_data.

4.3.0

2016-06-18

Enhancements

  • 819: [Linux] different speedup improvements: Process.ppid() is 20% faster Process.status() is 28% faster Process.name() is 25% faster Process.num_threads is 20% faster on Python 3

Bug fixes

  • 810: [Windows] Windows wheels are incompatible with pip 7.1.2.
  • 812: [NetBSD] fix compilation on NetBSD-5.x.
  • 823: [NetBSD] virtual_memory() raises TypeError on Python 3.
  • 829: [UNIX] psutil.disk_usage() percent field takes root reserved space into account.
  • 816: [Windows] fixed net_io_counter() 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

Enhancements

  • 795: [Windows] new APIs to deal with Windows services: win_service_iter() and win_service_get().
  • 800: [Linux] psutil.virtual_memory() returns a new "shared" memory field.
  • 819: [Linux] speedup /proc parsing: - Process.ppid() is 20% faster - Process.status() is 28% faster - Process.name() is 25% faster - Process.num_threads is 20% faster on Python 3

Bug fixes

  • 797: [Linux] net_if_stats() may raise OSError for certain NIC cards.
  • 813: Process.as_dict() should ignore extraneous attribute names which gets attached to the Process instance.

4.1.0

2016-03-12

Enhancements

  • 777: [Linux] Process.open_files() on Linux return 3 new fields: position, mode and flags.
  • 779: Process.cpu_times() returns two new fields, 'children_user' and 'children_system' (always set to 0 on macOS and Windows).
  • 789: [Windows] psutil.cpu_times() return two new fields: "interrupt" and "dpc". Same for psutil.cpu_times_percent().
  • 792: new psutil.cpu_stats() function returning number of CPU ctx switches interrupts, soft interrupts and syscalls.

Bug fixes

  • 774: [FreeBSD] net_io_counters() dropout is no longer set to 0 if the kernel provides it.
  • 776: [Linux] Process.cpu_affinity() may erroneously raise NoSuchProcess. (patch by wxwright)
  • 780: [macOS] psutil does not compile with some gcc versions.
  • 786: net_if_addrs() may report incomplete MAC addresses.
  • 788: [NetBSD] virtual_memory()'s buffers and shared values were set to 0.
  • 790: [macOS] psutil won't compile on macOS 10.4.

4.0.0

2016-02-17

Enhancements

  • 523: [Linux, FreeBSD] disk_io_counters() return a new "busy_time" field.
  • 660: [Windows] make.bat is smarter in finding alternative VS install locations. (patch by mpderbec)
  • 732: Process.environ(). (patch by Frank Benkstein)
  • 753: [Linux, macOS, Windows] Process USS and PSS (Linux) "real" memory stats. (patch by Eric Rahm)
  • 755: Process.memory_percent() "memtype" parameter.
  • 758: tests now live in psutil namespace.
  • 760: expose OS constants (psutil.LINUX, psutil.macOS, etc.)
  • 756: [Linux] disk_io_counters() return 2 new fields: read_merged_count and write_merged_count.
  • 762: new scripts/procsmem.py script.

Bug fixes

  • 685: [Linux] virtual_memory() provides wrong results on systems with a lot of physical memory.
  • 704: [Solaris] psutil does not compile on Solaris sparc.
  • 734: on Python 3 invalid UTF-8 data is not correctly handled for process name(), cwd(), exe(), cmdline() and open_files() methods resulting in UnicodeDecodeError exceptions. 'surrogateescape' error handler is now used as a workaround for replacing the corrupted data.
  • 737: [Windows] when the bitness of psutil and the target process was different cmdline() and cwd() could return a wrong result or incorrectly report an AccessDenied error.
  • 741: [OpenBSD] psutil does not compile on mips64.
  • 751: [Linux] fixed call to Py_DECREF on possible Null object.
  • 754: [Linux] cmdline() can be wrong in case of zombie process.
  • 759: [Linux] Process.memory_maps() may return paths ending with " (deleted)"
  • 761: [Windows] psutil.boot_time() wraps to 0 after 49 days.
  • 764: [NetBSD] fix compilation on NetBSD-6.x.
  • 766: [Linux] net_connections() can't handle malformed /proc/net/unix file.
  • 767: [Linux] disk_io_counters() may raise ValueError on 2.6 kernels and it's broken on 2.4 kernels.
  • 770: [NetBSD] disk_io_counters() metrics didn't update.

3.4.2

2016-01-20

Enhancements

  • 728: [Solaris] exposed psutil.PROCFS_PATH constant to change the default location of /proc filesystem.

Bug fixes

  • 724: [FreeBSD] psutil.virtual_memory().total is incorrect.
  • 730: [FreeBSD] psutil.virtual_memory() crashes.

3.4.1

2016-01-15

Enhancements

  • 557: [NetBSD] added NetBSD support. (contributed by Ryo Onodera and Thomas Klausner)
  • 708: [Linux] psutil.net_connections() and Process.connections() on Python 2 can be up to 3x faster in case of many connections. Also psutil.Process.memory_maps() is slightly faster.
  • 718: process_iter() is now thread safe.

Bug fixes

  • 714: [OpenBSD] virtual_memory().cached value was always set to 0.
  • 715: don't crash at import time if cpu_times() fail for some reason.
  • 717: [Linux] Process.open_files fails if deleted files still visible.
  • 722: [Linux] swap_memory() no longer crashes if sin/sout can't be determined due to missing /proc/vmstat.
  • 724: [FreeBSD] virtual_memory().total is slightly incorrect.

3.3.0

2015-11-25

Enhancements

  • 558: [Linux] exposed psutil.PROCFS_PATH constant to change the default location of /proc filesystem.
  • 615: [OpenBSD] added OpenBSD support. (contributed by Landry Breuil)

Bug fixes

  • 692: [UNIX] Process.name() is no longer cached as it may change.

3.2.2

2015-10-04

Bug fixes

  • 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. (patch by dasumin)
  • 610: [SunOS] fix build and tests on Solaris 10
  • 623: [Linux] process or system connections raises ValueError if IPv6 is not supported by the system.
  • 678: [Linux] can't install psutil due to bug in setup.py.
  • 688: [Windows] compilation fails with MSVC 2015, Python 3.5. (patch by Mike Sarahan)

3.2.1

2015-09-03

Bug fixes

  • 677: [Linux] can't install psutil due to bug in setup.py.

3.2.0

2015-09-02

Enhancements

  • 644: [Windows] added support for CTRL_C_EVENT and CTRL_BREAK_EVENT signals to use with Process.send_signal().
  • 648: CI test integration for macOS. (patch by Jeff Tang)
  • 663: [UNIX] net_if_addrs() now returns point-to-point (VPNs) addresses.
  • 655: [Windows] different issues regarding unicode handling were fixed. On Python 2 all APIs returning a string will now return an encoded version of it by using sys.getfilesystemencoding() codec. The APIs involved are: - psutil.net_if_addrs() - psutil.net_if_stats() - psutil.net_io_counters() - psutil.Process.cmdline() - psutil.Process.name() - psutil.Process.username() - psutil.users()

Bug fixes

  • 513: [Linux] fixed integer overflow for RLIM_INFINITY.
  • 641: [Windows] fixed many compilation warnings. (patch by Jeff Tang)
  • 652: [Windows] net_if_addrs() UnicodeDecodeError in case of non-ASCII NIC names.
  • 655: [Windows] net_if_stats() UnicodeDecodeError in case of non-ASCII NIC names.
  • 659: [Linux] compilation error on Suse 10. (patch by maozguttman)
  • 664: [Linux] compilation error on Alpine Linux. (patch by Bart van Kleef)
  • 670: [Windows] segfgault of net_if_addrs() in case of non-ASCII NIC names. (patch by sk6249)
  • 672: [Windows] compilation fails if using Windows SDK v8.0. (patch by Steven Winfield)
  • 675: [Linux] net_connections(); UnicodeDecodeError may occur when listing UNIX sockets.

3.1.1

2015-07-15

Bug fixes

  • 603: [Linux] ionice_set value range is incorrect. (patch by spacewander)
  • 645: [Linux] psutil.cpu_times_percent() may produce negative results.
  • 656: 'from psutil import *' does not work.

3.1.0

2015-07-15

Enhancements

Bug fixes

  • 340: [Windows] Process.open_files() no longer hangs. Instead it uses a thred which times out and skips the file handle in case it's taking too long to be retrieved. (patch by Jeff Tang, PR #597)
  • 627: [Windows] Process.name() no longer raises AccessDenied for pids owned by another user.
  • 636: [Windows] Process.memory_info() raise AccessDenied.
  • 637: [UNIX] raise exception if trying to send signal to Process PID 0 as it will affect os.getpid()'s process group instead of PID 0.
  • 639: [Linux] Process.cmdline() can be truncated.
  • 640: [Linux] *connections functions may swallow errors and return an incomplete list of connnections.
  • 642: repr() of exceptions is incorrect.
  • 653: [Windows] Add inet_ntop function for Windows XP to support IPv6.
  • 641: [Windows] Replace deprecated string functions with safe equivalents.

3.0.1

2015-06-18

Bug fixes

  • 632: [Linux] better error message if cannot parse process UNIX connections.
  • 634: [Linux] Proces.cmdline() does not include empty string arguments.
  • 635: [UNIX] crash on module import if 'enum' package is installed on python < 3.4.

3.0.0

2015-06-13

Enhancements

  • 250: new psutil.net_if_stats() returning NIC statistics (isup, duplex, speed, MTU).
  • 376: new psutil.net_if_addrs() returning all NIC addresses a-la ifconfig.
  • 469: on Python >= 3.4 IOPRIO_CLASS_* and *_PRIORITY_CLASS constants returned by psutil.Process' ionice() and nice() methods are enums instead of plain integers.
  • 581: add .gitignore. (patch by Gabi Davar)
  • 582: connection constants returned by psutil.net_connections() and psutil.Process.connections() were turned from int to enums on Python > 3.4.
  • 587: Move native extension into the package.
  • 589: Process.cpu_affinity() accepts any kind of iterable (set, tuple, ...), not only lists.
  • 594: all deprecated APIs were removed.
  • 599: [Windows] process name() can now be determined for all processes even when running as a limited user.
  • 602: pre-commit GIT hook.
  • 629: enhanced support for py.test and nose test discovery and tests run.
  • 616: [Windows] Add inet_ntop function for Windows XP.

Bug fixes

  • 428: [all UNIXes except Linux] correct handling of zombie processes; introduced new ZombieProcess exception class.
  • 512: [BSD] fix segfault in net_connections().
  • 555: [Linux] psutil.users() correctly handles ":0" as an alias for "localhost"
  • 579: [Windows] Fixed open_files() for PID>64K.
  • 579: [Windows] fixed many compiler warnings.
  • 585: [FreeBSD] net_connections() may raise KeyError.
  • 586: [FreeBSD] cpu_affinity() segfaults on set in case an invalid CPU number is provided.
  • 593: [FreeBSD] Process().memory_maps() segfaults.
  • 606: Process.parent() may swallow NoSuchProcess exceptions.
  • 611: [SunOS] net_io_counters has send and received swapped
  • 614: [Linux]: cpu_count(logical=False) return the number of sockets instead of cores.
  • 618: [SunOS] swap tests fail on Solaris when run as normal user
  • 628: [Linux] Process.name() truncates process name in case it contains spaces or parentheses.

2.2.1

2015-02-02

Bug fixes

  • 496: [Linux] fix "ValueError: ambiguos inode with multiple PIDs references" (patch by Bruno Binet)

2.2.0

2015-01-06

Enhancements

  • 521: drop support for Python 2.4 and 2.5.
  • 553: new examples/pstree.py script.
  • 564: C extension version mismatch in case the user messed up with psutil installation or with sys.path is now detected at import time.
  • 568: New examples/pidof.py script.
  • 569: [FreeBSD] add support for process CPU affinity.

Bug fixes

  • 496: [Solaris] can't import psutil.
  • 547: [UNIX] Process.username() may raise KeyError if UID can't be resolved.
  • 551: [Windows] get rid of the unicode hack for net_io_counters() NIC names.
  • 556: [Linux] lots of file handles were left open.
  • 561: [Linux] net_connections() might skip some legitimate UNIX sockets. (patch by spacewander)
  • 565: [Windows] use proper encoding for psutil.Process.username() and psutil.users(). (patch by Sylvain Mouquet)
  • 567: [Linux] in the alternative implementation of CPU affinity PyList_Append and Py_BuildValue return values are not checked.
  • 569: [FreeBSD] fix memory leak in psutil.cpu_count(logical=False).
  • 571: [Linux] Process.open_files() might swallow AccessDenied exceptions and return an incomplete list of open files.

2.1.3

2014-09-26

  • 536: [Linux]: fix "undefined symbol: CPU_ALLOC" compilation error.

2.1.2

2014-09-21

Enhancements

  • 407: project moved from Google Code to Github; code moved from Mercurial to Git.
  • 492: use tox to run tests on multiple python versions. (patch by msabramo)
  • 505: [Windows] distribution as wheel packages.
  • 511: new examples/ps.py sample code.

Bug fixes

  • 340: [Windows] Process.get_open_files() no longer hangs. (patch by Jeff Tang)
  • 501: [Windows] disk_io_counters() may return negative values.
  • 503: [Linux] in rare conditions Process exe(), open_files() and connections() methods can raise OSError(ESRCH) instead of NoSuchProcess.
  • 504: [Linux] can't build RPM packages via setup.py
  • 506: [Linux] python 2.4 support was broken.
  • 522: [Linux] Process.cpu_affinity() might return EINVAL. (patch by David Daeschler)
  • 529: [Windows] Process.exe() may raise unhandled WindowsError exception for PIDs 0 and 4. (patch by Jeff Tang)
  • 530: [Linux] psutil.disk_io_counters() may crash on old Linux distros (< 2.6.5) (patch by Yaolong Huang)
  • 533: [Linux] Process.memory_maps() may raise TypeError on old Linux distros.

2.1.1

2014-04-30

Bug fixes

  • 446: [Windows] fix encoding error when using net_io_counters() on Python 3. (patch by Szigeti Gabor Niif)
  • 460: [Windows] net_io_counters() wraps after 4G.
  • 491: [Linux] psutil.net_connections() exceptions. (patch by Alexander Grothe)

2.1.0

2014-04-08

Enhancements

  • 387: system-wide open connections a-la netstat.

Bug fixes

  • 421: [Solaris] psutil does not compile on SunOS 5.10 (patch by Naveed Roudsari)
  • 489: [Linux] psutil.disk_partitions() return an empty list.

2.0.0

2014-03-10

Enhancements

  • 424: [Windows] installer for Python 3.X 64 bit.
  • 427: number of logical CPUs and physical cores (psutil.cpu_count()).
  • 447: psutil.wait_procs() timeout parameter is now optional.
  • 452: make Process instances hashable and usable with set()s.
  • 453: tests on Python < 2.7 require unittest2 module.
  • 459: add a make file for running tests and other repetitive tasks (also on Windows).
  • 463: make timeout parameter of cpu_percent* functions default to 0.0 'cause it's a common trap to introduce slowdowns.
  • 468: move documentation to readthedocs.com.
  • 477: process cpu_percent() is about 30% faster. (suggested by crusaderky)
  • 478: [Linux] almost all APIs are about 30% faster on Python 3.X.
  • 479: long deprecated psutil.error module is gone; exception classes now live in "psutil" namespace only.

Bug fixes

  • 193: psutil.Popen constructor can throw an exception if the spawned process terminates quickly.
  • 340: [Windows] process get_open_files() no longer hangs. (patch by [email protected])
  • 443: [Linux] fix a potential overflow issue for Process.set_cpu_affinity() on systems with more than 64 CPUs.
  • 448: [Windows] get_children() and ppid() memory leak (patch by Ulrich Klank).
  • 457: [POSIX] pid_exists() always returns True for PID 0.
  • 461: namedtuples are not pickle-able.
  • 466: [Linux] process exe improper null bytes handling. (patch by Gautam Singh)
  • 470: wait_procs() might not wait. (patch by crusaderky)
  • 471: [Windows] process exe improper unicode handling. (patch by [email protected])
  • 473: psutil.Popen.wait() does not set returncode attribute.
  • 474: [Windows] Process.cpu_percent() is no longer capped at 100%.
  • 476: [Linux] encoding error for process name and cmdline.

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 being replaced by functions:

    Old name

    Replacement

    psutil.NUM_CPUS

    psutil.cpu_cpunt()

    psutil.BOOT_TIME

    psutil.boot_time()

    psutil.TOTAL_PHYMEM

    psutil.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 psutil.Process get_* methods lost the get_ prefix. get_ext_memory_info() 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 psutil.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 psutil.Process class properties have been turned into methods. This is the only case 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()

  • timeout parameter of cpu_percent* functions defaults to 0.0 instead of 0.1.

  • long deprecated psutil.error module is gone; exception classes now live in "psutil" namespace only.

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

1.2.1

2013-11-25

Bug fixes

  • 348: [Windows XP] fixed "ImportError: DLL load failed" occurring on module import.
  • 425: [Solaris] crash on import due to failure at determining BOOT_TIME.
  • 443: [Linux] can't set CPU affinity on systems with more than 64 cores.

1.2.0

2013-11-20

Enhancements

  • 439: assume os.getpid() if no argument is passed to psutil.Process constructor.
  • 440: new psutil.wait_procs() utility function which waits for multiple processes to terminate.

Bug fixes

  • 348: [Windows XP/Vista] fix "ImportError: DLL load failed" occurring on module import.

1.1.3

2013-11-07

Bug fixes

  • 442: [Linux] psutil won't compile on certain version of Linux because of missing prlimit(2) syscall.

1.1.2

2013-10-22

Bug fixes

  • 442: [Linux] psutil won't compile on Debian 6.0 because of missing prlimit(2) syscall.

1.1.1

2013-10-08

Bug fixes

  • 442: [Linux] psutil won't compile on kernels < 2.6.36 due to missing prlimit(2) syscall.

1.1.0

2013-09-28

Enhancements

  • 410: host tar.gz and windows binary files are on PyPI.
  • 412: [Linux] get/set process resource limits.
  • 415: [Windows] Process.get_children() is an order of magnitude faster.
  • 426: [Windows] Process.name is an order of magnitude faster.
  • 431: [UNIX] Process.name is slightly faster because it unnecessarily retrieved also process cmdline.

Bug fixes

  • 391: [Windows] psutil.cpu_times_percent() returns negative percentages.
  • 408: STATUS_* and CONN_* constants don't properly serialize on JSON.
  • 411: [Windows] examples/disk_usage.py may pop-up a GUI error.
  • 413: [Windows] Process.get_memory_info() leaks memory.
  • 414: [Windows] Process.exe on Windows XP may raise ERROR_INVALID_PARAMETER.
  • 416: psutil.disk_usage() doesn't work well with unicode path names.
  • 430: [Linux] process IO counters report wrong number of r/w syscalls.
  • 435: [Linux] psutil.net_io_counters() might report erreneous NIC names.
  • 436: [Linux] psutil.net_io_counters() reports a wrong 'dropin' value.

API changes

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

1.0.1

2013-07-12

Bug fixes

  • 405: network_io_counters(pernic=True) no longer works as intended in 1.0.0.

1.0.0

2013-07-10

Enhancements

  • 18: Solaris support (yay!) (thanks Justin Venus)
  • 367: Process.get_connections() 'status' strings are now constants.
  • 380: test suite exits with non-zero on failure. (patch by floppymaster)
  • 391: introduce unittest2 facilities and provide workarounds if unittest2 is not installed (python < 2.7).

Bug fixes

  • 374: [Windows] negative memory usage reported if process uses a lot of memory.
  • 379: [Linux] Process.get_memory_maps() may raise ValueError.
  • 394: [macOS] Mapped memory regions report incorrect file name.
  • 404: [Linux] sched_*affinity() are implicitly declared. (patch by Arfrever)

API changes

  • Process.get_connections() 'status' field is no longer a string but a constant object (psutil.CONN_*).
  • Process.get_connections() 'local_address' and 'remote_address' fields renamed to 'laddr' and 'raddr'.
  • psutil.network_io_counters() renamed to psutil.net_io_counters().

0.7.1

2013-05-03

Bug fixes

  • 325: [BSD] psutil.virtual_memory() can raise SystemError. (patch by Jan Beich)
  • 370: [BSD] Process.get_connections() requires root. (patch by John Baldwin)
  • 372: [BSD] different process methods raise NoSuchProcess instead of AccessDenied.

0.7.0

2013-04-12

Enhancements

  • 233: code migrated to Mercurial (yay!)
  • 246: psutil.error module is deprecated and scheduled for removal.
  • 328: [Windows] process IO nice/priority support.
  • 359: psutil.get_boot_time()
  • 361: [Linux] psutil.cpu_times() now includes new 'steal', 'guest' and 'guest_nice' fields available on recent Linux kernels. Also, psutil.cpu_percent() is more accurate.
  • 362: cpu_times_percent() (per-CPU-time utilization as a percentage)

Bug fixes

  • 234: [Windows] disk_io_counters() fails to list certain disks.
  • 264: [Windows] use of psutil.disk_partitions() may cause a message box to appear.
  • 313: [Linux] psutil.virtual_memory() and psutil.swap_memory() can crash on certain exotic Linux flavors having an incomplete /proc interface. If that's the case we now set the unretrievable stats to 0 and raise a RuntimeWarning.
  • 315: [macOS] fix some compilation warnings.
  • 317: [Windows] cannot set process CPU affinity above 31 cores.
  • 319: [Linux] process get_memory_maps() raises KeyError 'Anonymous' on Debian squeeze.
  • 321: [UNIX] Process.ppid property is no longer cached as the kernel may set the ppid to 1 in case of a zombie process.
  • 323: [macOS] disk_io_counters()'s read_time and write_time parameters were reporting microseconds not milliseconds. (patch by Gregory Szorc)
  • 331: Process cmdline is no longer cached after first acces as it may change.
  • 333: [macOS] Leak of Mach ports on macOS (patch by [email protected])
  • 337: [Linux] process methods not working because of a poor /proc implementation will raise NotImplementedError rather than RuntimeError and Process.as_dict() will not blow up. (patch by Curtin1060)
  • 338: [Linux] disk_io_counters() fails to find some disks.
  • 339: [FreeBSD] get_pid_list() can allocate all the memory on system.
  • 341: [Linux] psutil might crash on import due to error in retrieving system terminals map.
  • 344: [FreeBSD] swap_memory() might return incorrect results due to kvm_open(3) not being called. (patch by Jean Sebastien)
  • 338: [Linux] disk_io_counters() fails to find some disks.
  • 351: [Windows] if psutil is compiled with mingw32 (provided installers for py2.4 and py2.5 are) disk_io_counters() will fail. (Patch by m.malycha)
  • 353: [macOS] get_users() returns an empty list on macOS 10.8.
  • 356: Process.parent now checks whether parent PID has been reused in which case returns None.
  • 365: Process.set_nice() should check PID has not been reused by another process.
  • 366: [FreeBSD] get_memory_maps(), get_num_fds(), get_open_files() and getcwd() Process methods raise RuntimeError instead of AccessDenied.

API changes

  • Process.cmdline property is no longer cached after first access.
  • Process.ppid property is no longer cached after first access.
  • [Linux] Process methods not working because of a poor /proc implementation will raise NotImplementedError instead of RuntimeError.
  • psutil.error module is deprecated and scheduled for removal.

0.6.1

2012-08-16

Enhancements

  • 316: process cmdline property now makes a better job at guessing the process executable from the cmdline.

Bug fixes

  • 316: process exe was resolved in case it was a symlink.
  • 318: python 2.4 compatibility was broken.

API changes

  • process exe can now return an empty string instead of raising AccessDenied.
  • process exe is no longer resolved in case it's a symlink.

0.6.0

2012-08-13

Enhancements

  • 216: [POSIX] get_connections() UNIX sockets support.
  • 220: [FreeBSD] get_connections() has been rewritten in C and no longer requires lsof.
  • 222: [macOS] add support for process cwd.
  • 261: process extended memory info.
  • 295: [macOS] process executable path is now determined by asking the OS instead of being guessed from process cmdline.
  • 297: [macOS] the Process methods below were always raising AccessDenied for any process except the current one. Now this is no longer true. Also they are 2.5x faster. - name - get_memory_info() - get_memory_percent() - get_cpu_times() - get_cpu_percent() - get_num_threads()
  • 300: examples/pmap.py script.
  • 301: process_iter() now yields processes sorted by their PIDs.
  • 302: process number of voluntary and involuntary context switches.
  • 303: [Windows] the Process methods below were always raising AccessDenied for any process not owned by current user. Now this is no longer true: - create_time - get_cpu_times() - get_cpu_percent() - get_memory_info() - get_memory_percent() - get_num_handles() - get_io_counters()
  • 305: add examples/netstat.py script.
  • 311: system memory functions has been refactorized and rewritten and now provide a more detailed and consistent representation of the system memory. New psutil.virtual_memory() function provides the following memory amounts: - total - available - percent - used - active [POSIX] - inactive [POSIX] - buffers (BSD, Linux) - cached (BSD, macOS) - wired (macOS, BSD) - shared [FreeBSD] New psutil.swap_memory() provides: - total - used - free - percent - sin (no. of bytes the system has swapped in from disk (cumulative)) - sout (no. of bytes the system has swapped out from disk (cumulative)) All old memory-related functions are deprecated. Also two new example scripts were added: free.py and meminfo.py.
  • 312: psutil.network_io_counters() namedtuple includes 4 new fields: errin, errout dropin and dropout, reflecting the number of packets dropped and with errors.

Bug fixes

  • 298: [macOS and BSD] memory leak in get_num_fds().
  • 299: potential memory leak every time PyList_New(0) is used.
  • 303: [Windows] potential heap corruption in get_num_threads() and get_status() Process methods.
  • 305: [FreeBSD] psutil can't compile on FreeBSD 9 due to removal of utmp.h.
  • 306: 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.
  • 307: [FreeBSD] values returned by psutil.network_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.
  • 309: get_open_files() might not return files which can not be accessed due to limited permissions. AccessDenied is now raised instead.

API changes

  • psutil.phymem_usage() is deprecated (use psutil.virtual_memory())
  • psutil.virtmem_usage() is deprecated (use psutil.swap_memory())
  • psutil.phymem_buffers() on Linux is deprecated (use psutil.virtual_memory())
  • psutil.cached_phymem() on Linux is deprecated (use psutil.virtual_memory())
  • [Windows and BSD] psutil.virtmem_usage() now returns information about swap memory instead of virtual memory.

0.5.1

2012-06-29

Enhancements

  • 293: [Windows] process executable path is now determined by asking the OS instead of being guessed from process cmdline.

Bug fixes

  • 292: [Linux] race condition in process files/threads/connections.
  • 294: [Windows] Process CPU affinity is only able to set CPU #0.

0.5.0

2012-06-27

Enhancements

  • 195: [Windows] number of handles opened by process.
  • 209: psutil.disk_partitions() now provides also mount options.
  • 229: list users currently connected on the system (psutil.get_users()).
  • 238: [Linux, Windows] process CPU affinity (get and set).
  • 242: Process.get_children(recursive=True): return all process descendants.
  • 245: [POSIX] Process.wait() incrementally consumes less CPU cycles.
  • 257: [Windows] removed Windows 2000 support.
  • 258: [Linux] Process.get_memory_info() is now 0.5x faster.
  • 260: process's mapped memory regions. (Windows patch by wj32.64, macOS patch by Jeremy Whitlock)
  • 262: [Windows] psutil.disk_partitions() was slow due to inspecting the floppy disk drive also when "all" argument was False.
  • 273: psutil.get_process_list() is deprecated.
  • 274: psutil no longer requires 2to3 at installation time in order to work with Python 3.
  • 278: new Process.as_dict() method.
  • 281: ppid, name, exe, cmdline and create_time properties of Process class are now cached after being accessed.
  • 282: psutil.STATUS_* constants can now be compared by using their string representation.
  • 283: speedup Process.is_running() by caching its return value in case the process is terminated.
  • 284: [POSIX] per-process number of opened file descriptors.
  • 287: psutil.process_iter() now caches Process instances between calls.
  • 290: Process.nice property is deprecated in favor of new get_nice() and set_nice() methods.

Bug fixes

  • 193: psutil.Popen constructor can throw an exception if the spawned process terminates quickly.
  • 240: [macOS] incorrect use of free() for Process.get_connections().
  • 244: [POSIX] Process.wait() can hog CPU resources if called against a process which is not our children.
  • 248: [Linux] psutil.network_io_counters() might return erroneous NIC names.
  • 252: [Windows] process getcwd() erroneously raise NoSuchProcess for processes owned by another user. It now raises AccessDenied instead.
  • 266: [Windows] psutil.get_pid_list() only shows 1024 processes. (patch by Amoser)
  • 267: [macOS] Process.get_connections() - an erroneous remote address was returned. (Patch by Amoser)
  • 272: [Linux] Porcess.get_open_files() - potential race condition can lead to unexpected NoSuchProcess exception. Also, we can get incorrect reports of not absolutized path names.
  • 275: [Linux] Process.get_io_counters() erroneously raise NoSuchProcess on old Linux versions. Where not available it now raises NotImplementedError.
  • 286: Process.is_running() doesn't actually check whether PID has been reused.
  • 314: Process.get_children() can sometimes return non-children.

API changes

  • Process.nice property is deprecated in favor of new get_nice() and set_nice() methods.
  • psutil.get_process_list() is deprecated.
  • ppid, name, exe, cmdline and create_time properties of Process class are now cached after being accessed, meaning NoSuchProcess will no longer be raised in case the process is gone in the meantime.
  • psutil.STATUS_* constants can now be compared by using their string representation.

0.4.1

2011-12-14

Bug fixes

  • 228: some example scripts were not working with python 3.
  • 230: [Windows / macOS] memory leak in Process.get_connections().
  • 232: [Linux] psutil.phymem_usage() can report erroneous values which are different than "free" command.
  • 236: [Windows] memory/handle leak in Process's get_memory_info(), suspend() and resume() methods.

0.4.0

2011-10-29

Enhancements

  • 150: network I/O counters. (macOS and Windows patch by Jeremy Whitlock)
  • 154: [FreeBSD] add support for process getcwd()
  • 157: [Windows] provide installer for Python 3.2 64-bit.
  • 198: Process.wait(timeout=0) can now be used to make wait() return immediately.
  • 206: disk I/O counters. (macOS and Windows patch by Jeremy Whitlock)
  • 213: examples/iotop.py script.
  • 217: Process.get_connections() now has a "kind" argument to filter for connections with different criteria.
  • 221: [FreeBSD] Process.get_open_files has been rewritten in C and no longer relies on lsof.
  • 223: examples/top.py script.
  • 227: examples/nettop.py script.

Bug fixes

  • 135: [macOS] psutil cannot create Process object.
  • 144: [Linux] no longer support 0 special PID.
  • 188: [Linux] psutil import error on Linux ARM architectures.
  • 194: [POSIX] psutil.Process.get_cpu_percent() now reports a percentage over 100 on multicore processors.
  • 197: [Linux] Process.get_connections() is broken on platforms not supporting IPv6.
  • 200: [Linux] psutil.NUM_CPUS not working on armel and sparc architectures and causing crash on module import.
  • 201: [Linux] Process.get_connections() is broken on big-endian architectures.
  • 211: Process instance can unexpectedly raise NoSuchProcess if tested for equality with another object.
  • 218: [Linux] crash at import time on Debian 64-bit because of a missing line in /proc/meminfo.
  • 226: [FreeBSD] crash at import time on FreeBSD 7 and minor.

0.3.0

2011-07-08

Enhancements

  • 125: system per-cpu percentage utilization and times.
  • 163: per-process associated terminal (TTY).
  • 171: added get_phymem() and get_virtmem() functions returning system memory information (total, used, free) and memory percent usage. total_* avail_* and used_* memory functions are deprecated.
  • 172: disk usage statistics.
  • 174: mounted disk partitions.
  • 179: setuptools is now used in setup.py

Bug fixes

  • 159: SetSeDebug() does not close handles or unset impersonation on return.
  • 164: [Windows] wait function raises a TimeoutException when a process returns -1 .
  • 165: process.status raises an unhandled exception.
  • 166: get_memory_info() leaks handles hogging system resources.
  • 168: psutil.cpu_percent() returns erroneous results when used in non-blocking mode. (patch by Philip Roberts)
  • 178: macOS - Process.get_threads() leaks memory
  • 180: [Windows] Process's get_num_threads() and get_threads() methods can raise NoSuchProcess exception while process still exists.

0.2.1

2011-03-20

Enhancements

  • 64: per-process I/O counters.
  • 116: per-process wait() (wait for process to terminate and return its exit code).
  • 134: per-process get_threads() returning information (id, user and kernel times) about threads opened by process.
  • 136: process executable path on FreeBSD is now determined by asking the kernel instead of guessing it from cmdline[0].
  • 137: per-process real, effective and saved user and group ids.
  • 140: system boot time.
  • 142: per-process get and set niceness (priority).
  • 143: per-process status.
  • 147: per-process I/O nice (priority) - Linux only.
  • 148: psutil.Popen class which tidies up subprocess.Popen and psutil.Process in a unique interface.
  • 152: [macOS] get_process_open_files() implementation has been rewritten in C and no longer relies on lsof resulting in a 3x speedup.
  • 153: [macOS] get_process_connection() implementation has been rewritten in C and no longer relies on lsof resulting in a 3x speedup.

Bug fixes

  • 83: process cmdline is empty on macOS 64-bit.
  • 130: a race condition can cause IOError exception be raised on Linux if process disappears between open() and subsequent read() calls.
  • 145: WindowsError was raised instead of psutil.AccessDenied when using process resume() or suspend() on Windows.
  • 146: 'exe' property on Linux can raise TypeError if path contains NULL bytes.
  • 151: exe and getcwd() for PID 0 on Linux return inconsistent data.

API changes

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

0.2.0

2010-11-13

Enhancements

  • 79: per-process open files.
  • 88: total system physical cached memory.
  • 88: total system physical memory buffers used by the kernel.
  • 91: per-process send_signal() and terminate() methods.
  • 95: NoSuchProcess and AccessDenied exception classes now provide "pid", "name" and "msg" attributes.
  • 97: per-process children.
  • 98: Process.get_cpu_times() and Process.get_memory_info now return a namedtuple instead of a tuple.
  • 103: per-process opened TCP and UDP connections.
  • 107: add support for Windows 64 bit. (patch by cjgohlke)
  • 111: per-process executable name.
  • 113: exception messages now include process name and pid.
  • 114: process username Windows implementation has been rewritten in pure C and no longer uses WMI resulting in a big speedup. Also, pywin32 is no longer required as a third-party dependancy. (patch by wj32)
  • 117: added support for Windows 2000.
  • 123: psutil.cpu_percent() and psutil.Process.cpu_percent() accept a new 'interval' parameter.
  • 129: per-process number of threads.

Bug fixes

  • 80: fixed warnings when installing psutil with easy_install.
  • 81: psutil fails to compile with Visual Studio.
  • 94: suspend() raises OSError instead of AccessDenied.
  • 86: psutil didn't compile against FreeBSD 6.x.
  • 102: orphaned process handles obtained by using OpenProcess in C were left behind every time Process class was instantiated.
  • 111: path and name Process properties report truncated or erroneous values on UNIX.
  • 120: cpu_percent() always returning 100% on macOS.
  • 112: uid and gid properties don't change if process changes effective user/group id at some point.
  • 126: ppid, uid, gid, name, exe, cmdline and create_time properties are no longer cached and correctly raise NoSuchProcess exception if the process disappears.

API changes

  • psutil.Process.path property is deprecated and works as an alias for "exe" property.
  • psutil.Process.kill(): signal argument was removed - to send a signal to the process use send_signal(signal) method instead.
  • psutil.Process.get_memory_info() returns a nametuple instead of a tuple.
  • psutil.cpu_times() returns a nametuple instead of a tuple.
  • New psutil.Process methods: get_open_files(), get_connections(), send_signal() and terminate().
  • ppid, uid, gid, name, exe, cmdline and create_time properties are no longer cached and raise NoSuchProcess exception if process disappears.
  • psutil.cpu_percent() no longer returns immediately (see issue 123).
  • psutil.Process.get_cpu_percent() and psutil.cpu_percent() no longer returns immediately by default (see issue 123).

0.1.3

2010-03-02

Enhancements

  • 14: per-process username
  • 51: per-process current working directory (Windows and Linux only)
  • 59: Process.is_running() is now 10 times faster
  • 61: added supoprt for FreeBSD 64 bit
  • 71: implemented suspend/resume process
  • 75: python 3 support

Bug fixes

  • 36: process cpu_times() and memory_info() functions succeeded also for dead processes while a NoSuchProcess exception is supposed to be raised.
  • 48: incorrect size for mib array defined in getcmdargs for BSD
  • 49: possible memory leak due to missing free() on error condition on
  • 50: fixed getcmdargs() memory fragmentation on BSD
  • 55: test_pid_4 was failing on Windows Vista
  • 57: some unit tests were failing on systems where no swap memory is available
  • 58: is_running() is now called before kill() to make sure we are going to kill the correct process.
  • 73: virtual memory size reported on macOS includes shared library size
  • 77: NoSuchProcess wasn't raised on Process.create_time if kill() was used first.

0.1.2

2009-05-06

Enhancements

  • 32: Per-process CPU user/kernel times
  • 33: Process create time
  • 34: Per-process CPU utilization percentage
  • 38: Per-process memory usage (bytes)
  • 41: Per-process memory utilization (percent)
  • 39: System uptime
  • 43: Total system virtual memory
  • 46: Total system physical memory
  • 44: Total system used/free virtual and physical memory

Bug fixes

  • 36: [Windows] NoSuchProcess not raised when accessing timing methods.
  • 40: test_get_cpu_times() failing on FreeBSD and macOS.
  • 42: [Windows] get_memory_percent() raises AccessDenied.

0.1.1

2009-03-06

Enhancements

  • 4: FreeBSD support for all functions of psutil
  • 9: Process.uid and Process.gid now retrieve process UID and GID.
  • 11: Support for parent/ppid - Process.parent property returns a Process object representing the parent process, and Process.ppid returns the parent PID.
  • 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.
  • 21: AccessDenied exception created for raising access denied errors from OSError or WindowsError on individual platforms.
  • 26: psutil.process_iter() function to iterate over processes as Process objects with a generator.
  • 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(0).kill() was failing with an unset exception.
  • 23: Special case for pid_exists(0)
  • 24: [Windows] Process(0).kill() now raises AccessDenied exception instead of WindowsError.
  • 30: psutil.get_pid_list() was returning two ins