psutil

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.OSX, etc.)

• 756_, [Linux]: `disk_io_counters()`_ return 2 new fields: read_merged_count and write_merged_count.

• 762_: new `procsmem.py`_ script.

Bug fixes

• 685_, [Linux]: `virtual_memory()`_ provides wrong results on systems with a lot of physical memory.

• 704_, [SunOS]: psutil does not compile on Solaris sparc.

• 734_: on Python 3 invalid UTF-8 data is not correctly handled for `Process.name()`_, `Process.cwd()`_, `Process.exe()`_, `Process.cmdline()`_ and `Process.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, `Process.cmdline()`_ and `Process.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]: `Process.cmdline()`_ can be wrong in case of zombie process.

• 759_, [Linux]: `Process.memory_maps()`_ may return paths ending with " (deleted)".

• 761_, [Windows]: `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.

2016-01-20

Enhancements

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

Bug fixes

• 724_, [FreeBSD]: `virtual_memory()`_ total is incorrect.

• 730_, [FreeBSD], [critical]: `virtual_memory()`_ crashes with "OSError: [Errno 12] Cannot allocate memory".

2016-01-15

Enhancements

• 557_, [NetBSD]: added NetBSD support. (contributed by Ryo Onodera and Thomas Klausner)

• 708_, [Linux]: `net_connections()`_ and `Process.connections()`_ on Python 2 can be up to 3x faster in case of many connections. Also `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_, [critical]: 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.

2015-11-25

Enhancements

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

• 615_, [OpenBSD]: added OpenBSD support. (contributed by Landry Breuil)

Bug fixes

• 692_, [POSIX]: `Process.name()`_ is no longer cached as it may change.

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], [critical]: can't install psutil due to bug in setup.py.

• 688_, [Windows]: compilation fails with MSVC 2015, Python 3.5. (patch by Mike Sarahan)

2015-09-03

Bug fixes

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

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_, [POSIX]: `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: `net_if_addrs()`_, `net_if_stats()`_, `net_io_counters()`_, `Process.cmdline()`_, `Process.name()`_, `Process.username()`_, `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.

2015-07-15

Enhancements

• 534_, [Linux]: `disk_partitions()`_ added support for ZFS filesystems.

• 646_, [Windows]: continuous tests integration for Windows with https://ci.appveyor.com/project/giampaolo/psutil.

• 647_: new dev guide: https://github.com/giampaolo/psutil/blob/master/docs/DEVGUIDE.rst

• 651_: continuous code quality test integration with scrutinizer-ci.com

Bug fixes

• 340_, [Windows], [critical]: `Process.open_files()`_ no longer hangs. Instead it uses a thread which times out and skips the file handle in case it's taking too long to be retrieved. (patch by Jeff Tang)

• 627_, [Windows]: `Process.name()`_ no longer raises `AccessDenied`_ for pids owned by another user.

• 636_, [Windows]: `Process.memory_info()`_ raise `AccessDenied`_.

• 637_, [POSIX]: raise exception if trying to send signal to PID 0 as it will affect os.getpid() 's process group and not PID 0.

• 639_, [Linux]: `Process.cmdline()`_ can be truncated.

• 640_, [Linux]: *connections functions may swallow errors and return an incomplete list of connections.

• 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.

2015-06-18

Bug fixes

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

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

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

2015-06-13

Enhancements

• 250_: new `net_if_stats()`_ returning NIC statistics (isup, duplex, speed, mtu).

• 376_: new `net_if_addrs()`_ returning all NIC addresses a-la ifconfig.

• 469_: on Python >= 3.4 IOPRIO_CLASS_* and *_PRIORITY_CLASS constants returned by `Process.ionice()`_ and `Process.nice()`_ are enums instead of plain integers.

• 581_: add .gitignore. (patch by Gabi Davar)

• 582_: connection constants returned by `net_connections()`_ and `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 pytest and nose test runners.

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

Bug fixes

• 428_, [POSIX], [critical]: correct handling of zombie processes on POSIX. Introduced new `ZombieProcess`_ exception class.

• 512_, [BSD], [critical]: fix segfault in `net_connections()`_.

• 555_, [Linux]: `users()`_ correctly handles ":0" as an alias for "localhost".

• 579_, [Windows]: fixed `Process.open_files()`_ for PID > 64K.

• 579_, [Windows]: fixed many compiler warnings.

• 585_, [FreeBSD]: `net_connections()`_ may raise KeyError.

• 586_, [FreeBSD], [critical]: `Process.cpu_affinity()`_ segfaults on set in case an invalid CPU number is provided.

• 593_, [FreeBSD], [critical]: `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()`_ with 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 string in case it contains spaces or parentheses.

2015-02-02

Bug fixes

• 572_, [Linux]: fix "ValueError: ambiguous inode with multiple PIDs references" for `Process.connections()`_. (patch by Bruno Binet)

2015-01-06

Enhancements

• 521_: drop support for Python 2.4 and 2.5.

• 553_: new `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 `pidof.py`_ script.

• 569_, [FreeBSD]: add support for `Process.cpu_affinity()`_ on FreeBSD.

Bug fixes

• 496_, [SunOS], [critical]: can't import psutil.

• 547_, [POSIX]: `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 `Process.username()`_ and `users()`_. (patch by Sylvain Mouquet)

• 567_, [Linux]: in the alternative implementation of `Process.cpu_affinity()`_ PyList_Append and Py_BuildValue return values are not checked.

• 569_, [FreeBSD]: fix memory leak in `cpu_count()`_ with logical=False.

• 571_, [Linux]: `Process.open_files()`_ might swallow `AccessDenied`_ exceptions and return an incomplete list of open files.

2014-09-26

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

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_: add `ps.py`_ script.

Bug fixes

• 340_, [Windows]: `Process.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()`_, `Process.open_files()`_ and `Process.connections()`_ can raise OSError(ESRCH) instead of `NoSuchProcess`_.

• 504_, [Linux]: can't build RPM packages via setup.py

• 506_, [Linux], [critical]: 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]: `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.

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]: `net_connections()`_ exceptions. (patch by Alexander Grothe)

2014-04-08

Enhancements

• 387_: system-wide open connections a-la netstat (add `net_connections()`_).

Bug fixes

• 421_, [SunOS], [critical]: psutil does not compile on SunOS 5.10. (patch by Naveed Roudsari)

• 489_, [Linux]: `disk_partitions()`_ return an empty list.

2014-03-10

Enhancements

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

• 427_: number of logical CPUs and physical cores (`cpu_count()`_).

• 447_: `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 Makefile 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.open_files()`_ no longer hangs. (patch by jtang@vahna.net)

• 443_, [Linux]: fix a potential overflow issue for `Process.cpu_affinity()`_ (set) on systems with more than 64 CPUs.

• 448_, [Windows]: `Process.children()`_ and `Process.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 alex@mroja.net)

• 473_: `psutil.Popen`_ wait() method does not set returncode attribute.

• 474_, [Windows]: `Process.cpu_percent()`_ is no longer capped at 100%.

• 476_, [Linux]: encoding error for `Process.name()`_ and `Process.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_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 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 `wait_procs()`_ has been renamed to returncode for consistency with subprocess.Popen.

2013-11-20

Enhancements

• 439_: assume os.getpid() if no argument is passed to `Process`_ class constructor.

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

Bug fixes

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

2013-11-07

Bug fixes

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

2013-10-22

Bug fixes

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

2013-10-08

Bug fixes

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

2013-09-28

Enhancements

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

• 412_, [Linux]: get/set process resource limits (`Process.rlimit()`_).

• 415_, [Windows]: `Process.children()`_ is an order of magnitude faster.

• 426_, [Windows]: `Process.name()`_ is an order of magnitude faster.

• 431_, [POSIX]: `Process.name()`_ is slightly faster because it unnecessarily retrieved also `Process.cmdline()`_.

Bug fixes

• 391_, [Windows]: `cpu_times_percent()`_ returns negative percentages.

• 408_: STATUS_* and CONN_* constants don't properly serialize on JSON.

• 411_, [Windows]: `disk_usage.py`_ may pop-up a GUI error.

• 413_, [Windows]: `Process.memory_info()`_ leaks memory.

• 414_, [Windows]: `Process.exe()`_ on Windows XP may raise ERROR_INVALID_PARAMETER.

• 416_: `disk_usage()`_ doesn't work well with unicode path names.

• 430_, [Linux]: `Process.io_counters()`_ report wrong number of r/w syscalls.

• 435_, [Linux]: `net_io_counters()`_ might report erreneous NIC names.

• 436_, [Linux]: `net_io_counters()`_ reports a wrong dropin value.

API changes

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

2013-07-12

Bug fixes

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

2013-07-10

Enhancements

• 18_, [SunOS]: add Solaris support (yay!) (thanks Justin Venus)

• 367_: `Process.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.memory_maps()`_ may raise ValueError.

• 394_, [macOS]: mapped memory regions of `Process.memory_maps()`_ report incorrect file name.

• 404_, [Linux]: sched_*affinity() are implicitly declared. (patch by Arfrever)

API changes

• `Process.connections()`_ status field is no longer a string but a constant object (psutil.CONN_*).

• `Process.connections()`_ local_address and remote_address fields renamed to laddr and raddr.

• psutil.network_io_counters() renamed to `net_io_counters()`_.

2013-05-03

Bug fixes

• 325_, [BSD], [critical]: `virtual_memory()`_ can raise SystemError. (patch by Jan Beich)

• 370_, [BSD]: `Process.connections()`_ requires root. (patch by John Baldwin)

• 372_, [BSD]: different process methods raise `NoSuchProcess`_ instead of `AccessDenied`_.

2013-04-12

Enhancements

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

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

• 328_, [Windows]: `Process.ionice()`_ support.

• 359_: add `boot_time()`_ as a substitute of psutil.BOOT_TIME since the latter cannot reflect system clock updates.

• 361_, [Linux]: `cpu_times()`_ now includes new steal, guest and guest_nice fields available on recent Linux kernels. Also, `cpu_percent()`_ is more accurate.

• 362_: add `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 `disk_partitions()`_ may cause a message box to appear.

• 313_, [Linux], [critical]: `virtual_memory()`_ and `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 RuntimeWarning instead.

• 315_, [macOS]: fix some compilation warnings.

• 317_, [Windows]: cannot set process CPU affinity above 31 cores.

• 319_, [Linux]: `Process.memory_maps()`_ raises KeyError 'Anonymous' on Debian squeeze.

• 321_, [POSIX]: `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()`_ read_time and write_time parameters were reporting microseconds not milliseconds. (patch by Gregory Szorc)

• 331_: `Process.cmdline()`_ is no longer cached after first access as it may change.

• 333_, [macOS]: leak of Mach ports (patch by rsesek@google.com)

• 337_, [Linux], [critical]: `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], [critical]: 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]: `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.nice()`_ (set) should check PID has not been reused by another process.

• 366_, [FreeBSD], [critical]: `Process.memory_maps()`_, `Process.num_fds()`_, `Process.open_files()`_ and `Process.cwd()`_ 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.

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_, [critical]: 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.

2012-08-13

Enhancements

• 216_, [POSIX]: `Process.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_: per-process extended memory info (`Process.memory_info_ex()`_).

• 295_, [macOS]: `Process.exe()`_ 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. `Process.name()`_, `Process.memory_info()`_, `Process.memory_percent()`_, `Process.cpu_times()`_, `Process.cpu_percent()`_, `Process.num_threads()`_.

• 300_: add `pmap.py`_ script.

• 301_: `process_iter()`_ now yields processes sorted by their PIDs.

• 302_: per-process number of voluntary and involuntary context switches (`Process.num_ctx_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: `Process.create_time()`_, `Process.cpu_times()`_, `Process.cpu_percent()`_, `Process.memory_info()`_, `Process.memory_percent()`_, `Process.num_handles()`_, `Process.io_counters()`_.

• 305_: add `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. Added new `virtual_memory()`_ and `swap_memory()`_ functions. All old memory-related functions are deprecated. Also two new example scripts were added: `free.py`_ and `meminfo.py`_.

• 312_: net_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], [BSD]: memory leak in `Process.num_fds()`_.

• 299_: potential memory leak every time PyList_New(0) is used.

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

• 305_, [FreeBSD], [critical]: can't compile on FreeBSD 9 due to removal of utmp.h.

• 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.

• 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.

• 309_: `Process.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 `virtual_memory()`_)

• psutil.virtmem_usage() is deprecated (use `swap_memory()`_)

• [Linux]: psutil.phymem_buffers() is deprecated (use `virtual_memory()`_)

• [Linux]: psutil.cached_phymem() is deprecated (use `virtual_memory()`_)

• [Windows], [BSD]: psutil.virtmem_usage() now returns information about swap memory instead of virtual memory.

2012-06-27

Enhancements

• 195_, [Windows]: number of handles opened by process (`Process.num_handles()`_).

• 209_: `disk_partitions()`_ now provides also mount options.

• 229_: list users currently connected on the system (`users()`_).

• 238_, [Linux], [Windows]: process CPU affinity (get and set, `Process.cpu_affinity()`_).

• 242_: add recursive=True to `Process.children()`_: return all process descendants.

• 245_, [POSIX]: `Process.wait()`_ incrementally consumes less CPU cycles.

• 257_, [Windows]: removed Windows 2000 support.

• 258_, [Linux]: `Process.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]: `disk_partitions()`_ was slow due to inspecting the floppy disk drive also when parameter is all=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_: `Process.ppid()`_, `Process.name()`_, `Process.exe()`_, `Process.cmdline()`_ and `Process.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 (`Process.num_fds()`_).

• 287_: `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.connections()`_.

• 244_, [POSIX]: `Process.wait()`_ can hog CPU resources if called against a process which is not our children.

• 248_, [Linux]: `net_io_counters()`_ might return erroneous NIC names.

• 252_, [Windows]: `Process.cwd()`_ 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.connections()`_ returns wrong remote address. (Patch by Amoser)

• 272_, [Linux]: `Process.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.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.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.

• `Process.ppid()`_, `Process.name()`_, `Process.exe()`_, `Process.cmdline()`_ and `Process.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.

2011-12-14

Bug fixes

• 228_: some example scripts were not working with Python 3.

• 230_, [Windows], [macOS]: fix memory leak in `Process.connections()`_.

• 232_, [Linux]: psutil.phymem_usage() can report erroneous values which are different than free command.

• 236_, [Windows]: fix memory/handle leak in `Process.memory_info()`_, `Process.suspend()`_ and `Process.resume()`_ methods.

2011-10-29

Enhancements

• 150_: network I/O counters (`net_io_counters()`_). (macOS and Windows patch by Jeremy Whitlock)

• 154_, [FreeBSD]: add support for `Process.cwd()`_.

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

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

• 206_: disk I/O counters (`disk_io_counters()`_). (macOS and Windows patch by Jeremy Whitlock)

• 213_: add `iotop.py`_ script.

• 217_: `Process.connections()`_ now has a kind argument to filter for connections with different criteria.

• 221_, [FreeBSD]: `Process.open_files()`_ has been rewritten in C and no longer relies on lsof.

• 223_: add `top.py`_ script.

• 227_: add `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]: `Process.cpu_percent()`_ now reports a percentage over 100 on multicore processors.

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

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

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

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

• 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.

2011-07-08

Enhancements

• 125_: system per-cpu percentage utilization and times (`Process.cpu_times()`_, `Process.cpu_percent()`_).

• 163_: per-process associated terminal / TTY (`Process.terminal()`_).

• 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 (`disk_usage()`_).

• 174_: mounted disk partitions (`disk_partitions()`_).

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

Bug fixes

• 159_, [Windows]: 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_: `Process.memory_info()`_ leaks handles hogging system resources.

• 168_: `cpu_percent()`_ returns erroneous results when used in non-blocking mode. (patch by Philip Roberts)

• 178_, [macOS]: `Process.threads()`_ leaks memory.

• 180_, [Windows]: `Process.num_threads()`_ and `Process.threads()`_ methods can raise `NoSuchProcess`_ exception while process still exists.

2011-03-20

Enhancements

• 64_: per-process I/O counters (`Process.io_counters()`_).

• 116_: per-process `Process.wait()`_ (wait for process to terminate and return its exit code).

• 134_: per-process threads (`Process.threads()`_).

• 136_: `Process.exe()`_ 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 (`Process.gids()`_).

• 140_: system boot time (`boot_time()`_).

• 142_: per-process get and set niceness (priority) (`Process.nice()`_).

• 143_: per-process status (`Process.status()`_).

• 147_ [Linux]: per-process I/O niceness / priority (`Process.ionice()`_).

• 148_: `psutil.Popen`_ class which tidies up subprocess.Popen and `Process`_ class in a single interface.

• 152_, [macOS]: `Process.open_files()`_ implementation has been rewritten in C and no longer relies on lsof resulting in a 3x speedup.

• 153_, [macOS]: `Process.connections()`_ implementation has been rewritten in C and no longer relies on lsof resulting in a 3x speedup.

Bug fixes

• 83_, [macOS]: `Process.cmdline()`_ is empty on macOS 64-bit.

• 130_, [Linux]: a race condition can cause IOError exception be raised on if process disappears between open() and the subsequent read() call.

• 145_, [Windows], [critical]: WindowsError was raised instead of `AccessDenied`_ when using `Process.resume()`_ or `Process.suspend()`_.

• 146_, [Linux]: `Process.exe()`_ property can raise TypeError if path contains NULL bytes.

• 151_, [Linux]: `Process.exe()`_ and `Process.cwd()`_ for PID 0 return inconsistent data.

API changes

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

2010-11-13

Enhancements

• 79_: per-process open files (`Process.open_files()`_).

• 88_: total system physical cached memory.

• 88_: total system physical memory buffers used by the kernel.

• 91_: add `Process.send_signal()`_ and `Process.terminate()`_ methods.

• 95_: `NoSuchProcess`_ and `AccessDenied`_ exception classes now provide pid, name and msg attributes.

• 97_: per-process children (`Process.children()`_).

• 98_: `Process.cpu_times()`_ and `Process.memory_info()`_ now return a namedtuple instead of a tuple.

• 103_: per-process opened TCP and UDP connections (`Process.connections()`_).

• 107_, [Windows]: add support for Windows 64 bit. (patch by cjgohlke)

• 111_: per-process executable name (`Process.exe()`_).

• 113_: exception messages now include `Process.name()`_ and `Process.pid`_.

• 114_, [Windows]: `Process.username()`_ 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 dependency. (patch by wj32)

• 117_, [Windows]: added support for Windows 2000.

• 123_: `cpu_percent()`_ and `Process.cpu_percent()`_ accept a new interval parameter.

• 129_: per-process threads (`Process.threads()`_).

Bug fixes

• 80_: fixed warnings when installing psutil with easy_install.

• 81_, [Windows]: psutil fails to compile with Visual Studio.

• 94_: `Process.suspend()`_ raises OSError instead of `AccessDenied`_.

• 86_, [FreeBSD]: psutil didn't compile against FreeBSD 6.x.

• 102_, [Windows]: orphaned process handles obtained by using OpenProcess in C were left behind every time `Process`_ class was instantiated.

• 111_, [POSIX]: path and name `Process`_ properties report truncated or erroneous values on POSIX.

• 120_, [macOS]: `cpu_percent()`_ always returning 100%.

• 112_: uid and gid properties don't change if process changes effective user/group id at some point.

• 126_: `Process.ppid()`_, `Process.uids()`_, `Process.gids()`_, `Process.name()`_, `Process.exe()`_, `Process.cmdline()`_ and `Process.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 psutil.Process.exe property.

• `Process.kill()`_: signal argument was removed - to send a signal to the process use `Process.send_signal()`_ method instead.

• `Process.memory_info()`_ returns a nametuple instead of a tuple.

• `cpu_times()`_ returns a nametuple instead of a tuple.

• New `Process`_ methods: `Process.open_files()`_, `Process.connections()`_, `Process.send_signal()`_ and `Process.terminate()`_.

• `Process.ppid()`_, `Process.uids()`_, `Process.gids()`_, `Process.name()`_, `Process.exe()`_, `Process.cmdline()`_ and `Process.create_time()`_ properties are no longer cached and raise `NoSuchProcess`_ exception if process disappears.

• `cpu_percent()`_ no longer returns immediately (see issue 123).

• `Process.cpu_percent()`_ and `cpu_percent()`_ no longer returns immediately by default (see issue 123_).

2010-03-02

Enhancements

• 14_: `Process.username()`_.

• 51_, [Linux], [Windows]: per-process current working directory (`Process.cwd()`_).

• 59_: `Process.is_running()`_ is now 10 times faster.

• 61_, [FreeBSD]: added supoprt for FreeBSD 64 bit.

• 71_: per-process suspend and resume (`Process.suspend()`_ and `Process.resume()`_).

• 75_: Python 3 support.

Bug fixes

• 36_: `Process.cpu_times()`_ and `Process.memory_info()`_ functions succeeded. also for dead processes while a `NoSuchProcess`_ exception is supposed to be raised.

• 48_, [FreeBSD]: incorrect size for MIB array defined in getcmdargs.

• 49_, [FreeBSD]: possible memory leak due to missing free() on error condition in getcmdpath().

• 50_, [BSD]: fixed getcmdargs() memory fragmentation.

• 55_, [Windows]: test_pid_4 was failing on Windows Vista.

• 57_: some unit tests were failing on systems where no swap memory is available.

• 58_: `Process.is_running()`_ is now called before `Process.kill()`_ to make sure we are going to kill the correct process.

• 73_, [macOS]: virtual memory size reported on includes shared library size.

• 77_: `NoSuchProcess`_ wasn't raised on `Process.create_time()`_ if `Process.kill()`_ was used first.

2009-05-06

Enhancements

• 32_: Per-process CPU user/kernel times (`Process.cpu_times()`_).

• 33_: Per-process create time (`Process.create_time()`_).

• 34_: Per-process CPU utilization percentage (`Process.cpu_percent()`_).

• 38_: Per-process memory usage (bytes) (`Process.memory_info()`_).

• 41_: Per-process memory percent (`Process.memory_percent()`_).

• 39_: System uptime (`boot_time()`_).

• 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_, [FreeBSD], [macOS]: fix test_get_cpu_times failures.

• 42_, [Windows]: `Process.memory_percent()`_ raises `AccessDenied`_.

2009-03-06

Enhancements

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

• 9, [macOS], [Windows]: add Process.uid and Process.gid, returning process UID and GID.

• 11: per-process parent object: 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, [Windows]: AccessDenied exception created for raising access denied errors from OSError or WindowsError on individual platforms.

• 26: 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.kill() for PID 0 was failing with an unset exception.

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

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

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