1256 lines (994 sloc) 46.7 KB

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

4.3.1 - XXXX-XX-XX

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 OSX 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: [OSX] 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: [OSX] psutil won't compile on OSX 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, OSX, 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 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 OSX. (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 physical CPUs instead of physical 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 and physical CPUs (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 jtang@vahna.net)
  • #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 alex@mroja.net)
  • #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: [OSX] 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: [OSX] 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: [OSX] 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: [OSX] Leak of Mach ports on OS X (patch by rsesek@google.com)
  • #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: [OSX] get_users() returns an empty list on OSX 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: [OSX] add support for process cwd.
  • #261: process extended memory info.
  • #295: [OSX] process executable path is now determined by asking the OS instead of being guessed from process cmdline.
  • #297: [OSX] 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, OSX) - wired (OSX, 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.

Bugfixes

  • #298: [OSX 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.

Bugfixes

  • #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, OSX 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.

Bugfixes

  • #193: psutil.Popen constructor can throw an exception if the spawned process terminates quickly.
  • #240: [OSX] 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: [OSX] 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

Bugfixes

  • #228: some example scripts were not working with python 3.
  • #230: [Windows / OSX] 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. (OSX 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. (OSX 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.

Bugfixes

  • #135: [OSX] 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

Bugfixes

  • #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: OSX - 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: [OSX] get_process_open_files() implementation has been rewritten in C and no longer relies on lsof resulting in a 3x speedup.
  • #153: [OSX] get_process_connection() implementation has been rewritten in C and no longer relies on lsof resulting in a 3x speedup.

Bugfixes

  • #83: process cmdline is empty on OSX 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.

Bugfixes

  • #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 OS X.
  • #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

Bugfixes

  • #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 OS X 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

Bugfixes

  • #36: [Windows] NoSuchProcess not raised when accessing timing methods.
  • #40: test_get_cpu_times() failing on FreeBSD and OS X.
  • #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).

Bugfixes

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