summaryrefslogtreecommitdiffstats
path: root/python/psutil/HISTORY.rst
blob: 12b985d1e93f7af342bcf38af54f6b5e071a5244 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
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.