HISTORY

Bug tracker at http://code.google.com/p/psutil/issues

0.6.1 - 2012-08-16
------------------

NEW FEATURES

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

BUG FIXES

 * Issue 316: process exe was resolved in case it was a symlink.
 * Issue 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

 * Issue 216: (UNIX) get_connections() UNIX sockets support.
 * Issue 220: (BSD) get_connections() has been rewritten in C and no longer
   requires lsof.
 * Issue 222: (OSX) add support for process cwd.
 * Issue 261: process extended memory info.
 * Issue 295: (OSX) process executable path is now determined by asking the OS
   instead of being guessed from process cmdline.
 * Issue 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()
 * Issue 300: examples/pmap.py script.
 * Issue 301: process_iter() now yields processes sorted by their PIDs.
 * Issue 302: process number of voluntary and involuntary context switches.
 * Issue 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()
 * Issue 305: add examples/netstat.py script.
 * Issue 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 (UNIX)
    - inactive (UNIX)
    - buffers (BSD, Linux)
    - cached (BSD, OSX)
    - wired (OSX, BSD)
    - shared (BSD)
   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.
 * Issue 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

 * Issue 298: (OSX - BSD) memory leak in get_num_fds().
 * Issue 299: potential memory leak every time PyList_New(0) is used.
 * Issue 303: (Windows) potential heap corruption in get_num_threads() and
   get_status() Process methods.
 * Issue 305: (BSD) psutil can't compile on FreeBSD 9 due to removal of utmp.h.
 * Issue 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.
 * Issue 307: (BSD) values returned by psutil.network_io_counters() are wrong.
 * Issue 308: (BSD / Windows) psutil.virtmem_usage() wasn't actually returning
   information about swap memory usage as it was supposed to do. It does now.
 * Issue 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

 * Issue 293: (Windows) process executable path is now determined by asking the
   OS instead of being guessed from process cmdline.

BUGFIXES

 * Issue 292: (Linux) race condition in process files/threads/connections.
 * Issue 294: (Windows) Process CPU affinity is only able to set CPU #0.


0.5.0 - 2012-06-27
------------------

NEW FEATURES

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

BUGFIXES

 * Issue #193: psutil.Popen constructor can throw an exception if the spawned
   process terminates quickly.
 * Issue #240: (OSX) incorrect use of free() for Process.get_connections().
 * Issue #244: (POSIX) Process.wait() can hog CPU resources if called against
   a process which is not our children.
 * Issue #248: (Linux) psutil.network_io_counters() might return erroneous NIC
   names.
 * Issue #252: (Windows) process getcwd() erroneously raise NoSuchProcess for
   processes owned by another user.  It now raises AccessDenied instead.
 * Issue #266: (Windows) psutil.get_pid_list() only shows 1024 processes.
   (patch by Amoser)
 * Issue #267: (OSX) Process.get_connections() - an erroneous remote address
   was returned. (Patch by Amoser)
 * Issue #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.
 * Issue #275: (Linux) Process.get_io_counters() erroneously raise NoSuchProcess
   on old Linux versions. Where not available it now raises NotImplementedError.
 * Issue #286: Process.is_running() doesn't actually check whether PID has been
   reused.
 * Issue #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

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


0.4.0 - 2011-10-29
------------------

NEW FEATURES

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

BUGFIXES

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


0.3.0 - 2011-07-08
------------------

NEW FEATURES

 * Issue 125: system per-cpu percentage utilization and times.
 * Issue 163: per-process associated terminal (TTY).
 * Issue 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.
 * Issue 172: disk usage statistics.
 * Issue 174: mounted disk partitions.
 * Issue 179: setuptools is now used in setup.py

BUGFIXES

 * Issue 159: SetSeDebug() does not close handles or unset impersonation on
   return.
 * Issue 164: wait function raises a TimeoutException when a process returns
   -1 (Windows).
 * Issue 165: process.status raises an unhandled exception.
 * Issue 166: get_memory_info() leaks handles hogging system resources.
 * Issue 168: psutil.cpu_percent() returns erroneous results when used in
   non-blocking mode.  (patch by Philip Roberts)
 * Issue 178: OSX - Process.get_threads() leaks memory
 * Issue 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

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

BUGFIXES

 * Issue 83: process cmdline is empty on OSX 64-bit.
 * Issue 130: a race condition can cause IOError exception be raised on
   Linux if process disappears between open() and subsequent read() calls.
 * Issue 145: WindowsError was raised instead of psutil.AccessDenied when using
   process resume() or suspend() on Windows.
 * Issue 146: 'exe' property on Linux can raise TypeError if path contains NULL
   bytes.
 * Issue 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

 * Issue 79: per-process open files.
 * Issue 88: total system physical cached memory.
 * Issue 88: total system physical memory buffers used by the kernel.
 * Issue 91: per-process send_signal() and terminate() methods.
 * Issue 95: NoSuchProcess and AccessDenied exception classes now provide "pid",
   "name" and "msg" attributes.
 * Issue 97: per-process children.
 * Issue 98: Process.get_cpu_times() and Process.get_memory_info now return
   a namedtuple instead of a tuple.
 * Issue 103: per-process opened TCP and UDP connections.
 * Issue 107: add support for Windows 64 bit. (patch by cjgohlke)
 * Issue 111: per-process executable name.
 * Issue 113: exception messages now include process name and pid.
 * Issue 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)
 * Issue 117: added support for Windows 2000.
 * Issue 123: psutil.cpu_percent() and psutil.Process.cpu_percent() accept a
   new 'interval' parameter.
 * Issue 129: per-process number of threads.

BUGFIXES

 * Issue 80: fixed warnings when installing psutil with easy_install.
 * Issue 81: psutil fails to compile with Visual Studio.
 * Issue 94: suspend() raises OSError instead of AccessDenied.
 * Issue 86: psutil didn't compile against FreeBSD 6.x.
 * Issue 102: orphaned process handles obtained by using OpenProcess in C were
   left behind every time Process class was instantiated.
 * Issue 111: path and name Process properties report truncated or erroneous
   values on UNIX.
 * Issue 120: cpu_percent() always returning 100% on OS X.
 * Issue 112: uid and gid properties don't change if process changes effective
   user/group id at some point.
 * Issue 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

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

BUGFIXES

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


0.1.2 - 2009-05-06
------------------

NEW FEATURES

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

BUGFIXES

 * Issue 36: NoSuchProcess not raised on Windows when accessing timing methods
 * Issue 40: test_get_cpu_times() failing on FreeBSD and OS X
 * Issue 42: get_memory_percent() raises AccessDenied on Windows


0.1.1 - 2009-03-06
------------------

NEW FEATURES

 * Issue 4: FreeBSD support for all functions of psutil
 * Issue 9: Process.uid and Process.gid now retrieve process UID and GID.
 * Issue 11: Support for parent/ppid - Process.parent property returns a
   Process object representing the parent process, and Process.ppid returns
   the parent PID.
 * Issue 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.
 * Issue 21: AccessDenied exception created for raising access denied errors
   from OSError or WindowsError on individual platforms.
 * Issue 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

 * Issue 16: Special case for Windows' "System Idle Process" (PID 0) which
   otherwise would return an "invalid parameter" exception.
 * Issue 17: get_process_list() ignores NoSuchProcess and AccessDenied
   exceptions during building of the list.
 * Issue 22: Process(0).kill() was failing on Windows with an unset exception
 * Issue 23: Special case for pid_exists(0)
 * Issue 24: Process(0).kill() now raises AccessDenied exception instead of
   WindowsError.
 * Issue 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.