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 |