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


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

NEW FEATURES

 * #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: extensively use unittest2 module in unit tests and provide
         workarounds if this is not installed on python < 2.7.

BUG FIXES

 * #374: [Windows] negative memory usage reported when processes use 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
------------------

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.
