Bug tracker at https://github.com/giampaolo/psutil/issues 3.1.1 - 2015-07-15 ================== **Bug fixes** - #645: [Linux] psutil.cpu_times_percent() may produce negative results. - #656: 'from psutil import *' does not work. 3.1.0 - 2015-07-15 ================== **Enhancements** - #534: [Linux] disk_partitions() added support for ZFS filesystems. - #646: continuous tests integration for Windows with https://ci.appveyor.com/project/giampaolo/psutil. - #647: new dev guide: https://github.com/giampaolo/psutil/blob/master/DEVGUIDE.rst - #651: continuous code quality test integration with https://scrutinizer-ci.com/g/giampaolo/psutil/ **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 instances of PID 0 on OSX and FreeBSD platforms. 0.1.0 - 2009-01-27 ================== - Initial release.