Bug tracker at http://code.google.com/p/psutil/issues 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 ------------------ NEW FEATURES * #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 ------------------ NEW FEATURES * #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 ------------------ NEW FEATURES * #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 ------------------ NEW FEATURES * #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 ------------------ NEW FEATURES * #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 ------------------ NEW FEATURES * #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 ------------------ NEW FEATURES * #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 ------------------ NEW FEATURES * #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 ------------------ NEW FEATURES * #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 ------------------ NEW FEATURES * #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 ------------------ NEW FEATURES * #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 ------------------ NEW FEATURES * #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 OS X and FreeBSD platforms. 0.1.0 - 2009-01-27 ------------------ * Initial release.