| OLD | NEW | 
 | (Empty) | 
|    1 <html> |  | 
|    2  <head> |  | 
|    3  <title>Home</title> |  | 
|    4  </head> |  | 
|    5  <body> |  | 
|    6  |  | 
|    7  |  | 
|    8  |  | 
|    9  |  | 
|   10  |  | 
|   11 <div> |  | 
|   12 <table> |  | 
|   13  <tr> |  | 
|   14  |  | 
|   15  |  | 
|   16  <td style="vertical-align:top; padding-left:5px"> |  | 
|   17  |  | 
|   18  <div id="wikicontent"> |  | 
|   19  <div class="vt" id="wikimaincol"> |  | 
|   20  <h1><a name="Summary"></a>Summary<a href="#Summary" class="section_anchor"></a>
     </h1><p>psutil is a module providing an interface for retrieving information on 
     all running processes and system utilization (CPU, disk, memory) in a portable w
     ay by using <strong>Python</strong>, implementing many functionalities offered b
     y command line tools such as: </p><ul><li>ps </li><li>top </li><li>df </li><li>k
     ill  </li><li>free </li><li>lsof </li><li>netstat </li><li>nice </li><li>ionice 
     </li><li>uptime </li><li>tty </li></ul><p>It currently supports <strong>Linux</s
     trong>, <strong>Windows</strong>, <strong>OSX</strong> and <strong>FreeBSD</stro
     ng> both <strong>32-bit</strong> and <strong>64-bit</strong> with Python version
     s from <strong>2.4</strong> to <strong>3.3</strong> by using a single code base.
      </p><p><a href="http://code.google.com/p/psutil/#Donate" rel="nofollow"></a> </
     p><h1><a name="Example_usages"></a>Example usages<a href="#Example_usages" class
     ="section_anchor"></a></h1><h3><a name="CPU"></a>CPU<a href="#CPU" class="sectio
     n_anchor"></a></h3><pre class="prettyprint">>>> import psutil |  | 
|   21 >>> psutil.cpu_times() |  | 
|   22 cputimes(user=3961.46, nice=169.729, system=2150.659, idle=16900.540, iowait=629
     .509, irq=0.0, softirq=19.422) |  | 
|   23 >>> |  | 
|   24 >>> for x in range(3): |  | 
|   25 ...     psutil.cpu_percent(interval=1) |  | 
|   26 ... |  | 
|   27 4.0 |  | 
|   28 5.9 |  | 
|   29 3.8 |  | 
|   30 >>> |  | 
|   31 >>> for x in range(3): |  | 
|   32 ...     psutil.cpu_percent(interval=1, percpu=True) |  | 
|   33 ... |  | 
|   34 [4.0, 34.2] |  | 
|   35 [7.0, 8.5] |  | 
|   36 [1.2, 9.0] |  | 
|   37 >>></pre><h3><a name="Memory"></a>Memory<a href="#Memory" class="sectio
     n_anchor"></a></h3><pre class="prettyprint">>>> psutil.phymem_usage() |  | 
|   38 usage(total=4153868288, used=2854199296, free=1299668992, percent=34.6) |  | 
|   39 >>> psutil.virtmem_usage() |  | 
|   40 usage(total=2097147904, used=4096, free=2097143808, percent=0.0) |  | 
|   41 >>></pre><h3><a name="Disks"></a>Disks<a href="#Disks" class="section_a
     nchor"></a></h3><pre class="prettyprint">>>> psutil.get_partitions() |  | 
|   42 [partition(device='/dev/sda3', mountpoint='/', fstype='
     ext4'), |  | 
|   43  partition(device='/dev/sda7', mountpoint='/home', fstype=&#
     x27;ext4')] |  | 
|   44 >>> |  | 
|   45 >>> psutil.disk_usage('/') |  | 
|   46 usage(total=21378641920, used=4809781248, free=15482871808, percent=22.5) |  | 
|   47 >>></pre><h3><a name="Process_management"></a>Process management<a href
     ="#Process_management" class="section_anchor"></a></h3><pre class="prettyprint">
     >>> import psutil |  | 
|   48 >>> psutil.get_pid_list() |  | 
|   49 [1, 2, 3, 4, 5, 6, 7, 46, 48, 50, 51, 178, 182, 222, 223, 224, |  | 
|   50 268, 1215, 1216, 1220, 1221, 1243, 1244, 1301, 1601, 2237, 2355, |  | 
|   51 2637, 2774, 3932, 4176, 4177, 4185, 4187, 4189, 4225, 4243, 4245, |  | 
|   52 4263, 4282, 4306, 4311, 4312, 4313, 4314, 4337, 4339, 4357, 4358, |  | 
|   53 4363, 4383, 4395, 4408, 4433, 4443, 4445, 4446, 5167, 5234, 5235, |  | 
|   54 5252, 5318, 5424, 5644, 6987, 7054, 7055, 7071] |  | 
|   55 >>> |  | 
|   56 >>> p = psutil.Process(7055) |  | 
|   57 >>> p.name |  | 
|   58 'python' |  | 
|   59 >>> p.exe |  | 
|   60 '/usr/bin/python' |  | 
|   61 >>> p.cmdline |  | 
|   62 ['/usr/bin/python', 'main.py'] |  | 
|   63 >>> str(p.status) |  | 
|   64 'running' |  | 
|   65 >>> |  | 
|   66 >>> p.uids |  | 
|   67 user(real=1000, effective=1000, saved=1000) |  | 
|   68 >>> p.gids |  | 
|   69 group(real=1000, effective=1000, saved=1000) |  | 
|   70 >>> p.username |  | 
|   71 'giampaolo' |  | 
|   72 >>> p.create_time |  | 
|   73 1267551141.5019531 |  | 
|   74 >>> p.get_cpu_percent(interval=1.0) |  | 
|   75 12.1 |  | 
|   76 >>> p.get_memory_percent() |  | 
|   77 0.63423 |  | 
|   78 >>> p.get_memory_info() |  | 
|   79 meminfo(rss=7471104, vms=68513792) |  | 
|   80 >>> p.get_io_counters() |  | 
|   81 io(read_count=478001, write_count=59371, read_bytes=700416, write_bytes=69632) |  | 
|   82 >>> |  | 
|   83 >>> p.get_open_files() |  | 
|   84 [openfile(path='/home/giampaolo/svn/psutil/somefile', fd=3)] |  | 
|   85 >>> |  | 
|   86 >>> p.get_connections() |  | 
|   87 [connection(fd=115, family=2, type=1, local_address=('10.0.0.1', 48776
     ), remote_address=('93.186.135.91', 80), status='ESTABLISHED'
     ;), |  | 
|   88  connection(fd=117, family=2, type=1, local_address=('10.0.0.1', 43761
     ), remote_address=('72.14.234.100', 80), status='CLOSING'), |  | 
|   89  connection(fd=119, family=2, type=1, local_address=('10.0.0.1', 60759
     ), remote_address=('72.14.234.104', 80), status='ESTABLISHED'
     ;), |  | 
|   90  connection(fd=123, family=2, type=1, local_address=('10.0.0.1', 51314
     ), remote_address=('72.14.234.83', 443), status='SYN_SENT')] |  | 
|   91 >>> |  | 
|   92 >>> p.get_threads() |  | 
|   93 [thread(id=5234, user_time=22.5, system_time=9.2891), |  | 
|   94  thread(id=5235, user_time=0.0, system_time=0.0), |  | 
|   95  thread(id=5236, user_time=0.0, system_time=0.0), |  | 
|   96  thread(id=5237, user_time=0.0707, system_time=1.1)] |  | 
|   97 >>> |  | 
|   98 >>> p.nice |  | 
|   99 0 |  | 
|  100 >>> p.nice = 10  # set/change process priority |  | 
|  101 >>> p.nice |  | 
|  102 10 |  | 
|  103 >>> |  | 
|  104 >>> p.suspend() |  | 
|  105 >>> p.resume() |  | 
|  106 >>> |  | 
|  107 >>> p.terminate() |  | 
|  108 >>> p.wait(timeout=3) |  | 
|  109 0 |  | 
|  110 >>> |  | 
|  111 >>> psutil.test() |  | 
|  112 UID       PID %CPU %MEM     VSZ     RSS START     TIME COMMAND |  | 
|  113 0           0  0.0  0.0       0       0 00:12    00:00 [sched] |  | 
|  114 0           1  0.0  0.3    1740     600 00:12    00:04 /sbin/init |  | 
|  115 0           2  0.0  0.0       0       0 00:12    00:00 [kthreadd] |  | 
|  116 0           3  0.1  0.0       0       0 00:12    00:00 [migration/0] |  | 
|  117 ... |  | 
|  118 0       13239  0.0  2.6    13604   1044 00:38    00:00 /usr/sbin/smbd -D |  | 
|  119 1000    23648  1.1  2.4    12512   2008 14:43    00:06 sshd: user@pts/2 |  | 
|  120 1000    23649  0.0  1.2    5944    3340 14:43    00:00 -bash |  | 
|  121 0       25926  0.3  1.1    5432    3072 17:55    00:00 -su |  | 
|  122 0       28655  0.0  1.0    4932    3204 21:58    00:00 python _psutil.py |  | 
|  123 >>></pre><h1><a name="Donate"></a>Donate<a href="#Donate" class="sectio
     n_anchor"></a></h1><p>A lot of time and effort went into making psutil as it is 
     right now. If you feel psutil is useful to you or your business and want to supp
     ort it's future development please consider donating us (Giampaolo RodolĂ  a
     nd Jay Loden) some money. We only ask for a small donation, but of course we app
     reciate any amount. </p><p><a href="https://www.paypal.com/cgi-bin/webscr?cmd=_s
     -xclick&hosted_button_id=A9ZS7PKKRM3S8" rel="nofollow"></a> </p><h2><a name=
     "People_who_donated_so_far"></a>People who donated so far<a href="#People_who_do
     nated_so_far" class="section_anchor"></a></h2><ul><li>Kim Gräsman </li></ul><h1>
     <a name="Mailing_lists"></a>Mailing lists<a href="#Mailing_lists" class="section
     _anchor"></a></h1><p><strong>Users</strong><br><a href="http://groups.google.com
     /group/psutil/" rel="nofollow">http://groups.google.com/group/psutil/</a> </p><p
     ><strong>Developers</strong><br><a href="http://groups.google.com/group/psutil-d
     ev/" rel="nofollow">http://groups.google.com/group/psutil-dev/</a> </p><p><stron
     g>SVN commits and issue tracker changes</strong><br><a href="http://groups.googl
     e.com/group/psutil-commits/" rel="nofollow">http://groups.google.com/group/psuti
     l-commits/</a> </p><h1><a name="Contribute"></a>Contribute<a href="#Contribute" 
     class="section_anchor"></a></h1><p>If you want to help or just give us suggestio
     ns about the project and other related things,  subscribe to the <a href="http:/
     /groups.google.com/group/psutil" rel="nofollow">discussion mailing list</a>. If 
     you want to talk with project team members about psutil and other related things
      feel free to contact us at the following addresses: </p><p><table class="wikita
     ble"><tr><td style="border: 1px solid #ccc; padding: 5px;"> <strong>Name</strong
     > </td><td style="border: 1px solid #ccc; padding: 5px;"> <strong>Country</stron
     g> </td><td style="border: 1px solid #ccc; padding: 5px;"> <strong>E-mail</stron
     g> </td></tr> <tr><td style="border: 1px solid #ccc; padding: 5px;"> Giampaolo R
     odola' </td><td style="border: 1px solid #ccc; padding: 5px;"> Turin (Italy
     ) </td><td style="border: 1px solid #ccc; padding: 5px;"> g.rodola at gmail dot 
     com </td></tr> <tr><td style="border: 1px solid #ccc; padding: 5px;"> Jay Loden 
     </td><td style="border: 1px solid #ccc; padding: 5px;"> New Jersey (USA) </td><t
     d style="border: 1px solid #ccc; padding: 5px;"> jloden at gmail dot com  </td><
     /tr> </table></p><p>Feedbacks and suggestions are greatly appreciated as well as
      new testers and coders willing to join the development.<br> For any bug report,
      patch proposal or feature request, add an entry into the <a href="http://code.g
     oogle.com/p/psutil/issues/list" rel="nofollow">Issue Tracker</a>.<br> </p><p>Tha
     nk you. </p> |  | 
|  124  </body> |  | 
|  125 </html> |  | 
| OLD | NEW |