summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorGiampaolo Rodola <g.rodola@gmail.com>2020-02-15 13:05:44 +0100
committerGiampaolo Rodola <g.rodola@gmail.com>2020-02-15 13:05:44 +0100
commitcec43a2015da2b7cf02d7f01b719731348881ce2 (patch)
tree30181213934ed2f85717d65289bc4e06bcd57bba
parentd03c176c0478ed96a529be103318c42fa2f0af9d (diff)
downloadpsutil-cec43a2015da2b7cf02d7f01b719731348881ce2.tar.gz
update doc
-rw-r--r--README.rst2
-rw-r--r--docs/index.rst20
-rwxr-xr-xscripts/cpu_distribution.py2
-rwxr-xr-xscripts/netstat.py2
-rwxr-xr-xscripts/pidof.py2
-rwxr-xr-xscripts/procsmem.py2
6 files changed, 15 insertions, 15 deletions
diff --git a/README.rst b/README.rst
index c28a55f9..56b4017e 100644
--- a/README.rst
+++ b/README.rst
@@ -456,7 +456,7 @@ Further process APIs
.. code-block:: python
>>> import psutil
- >>> for proc in psutil.process_iter(attrs=['pid', 'name']):
+ >>> for proc in psutil.process_iter(['pid', 'name']):
... print(proc.info)
...
{'pid': 1, 'name': 'systemd'}
diff --git a/docs/index.rst b/docs/index.rst
index 1a5c2434..499c7996 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -880,7 +880,7 @@ Functions
Example::
>>> import psutil
- >>> for proc in psutil.process_iter(('pid', 'name', 'username')):
+ >>> for proc in psutil.process_iter(['pid', 'name', 'username']):
... print(proc.info)
...
{'name': 'systemd', 'pid': 1, 'username': 'root'}
@@ -891,7 +891,7 @@ Functions
A dict comprehensions to create a ``{pid: info, ...}`` data structure::
>>> import psutil
- >>> procs = {p.pid: p.info for p in psutil.process_iter(('name', 'username'))}
+ >>> procs = {p.pid: p.info for p in psutil.process_iter(['name', 'username'])}
>>> procs
{1: {'name': 'systemd', 'username': 'root'},
2: {'name': 'kthreadd', 'username': 'root'},
@@ -900,7 +900,7 @@ Functions
Get new processes since last call::
- >>> for proc in psutil.process_iter(('pid', 'name'), new_only=True):
+ >>> for proc in psutil.process_iter(['pid', 'name'], new_only=True):
... print(proc.info)
...
@@ -2349,7 +2349,7 @@ Check string against :meth:`Process.name()`:
def find_procs_by_name(name):
"Return a list of processes matching 'name'."
ls = []
- for p in psutil.process_iter(attrs=['name']):
+ for p in psutil.process_iter(['name']):
if p.info['name'] == name:
ls.append(p)
return ls
@@ -2365,7 +2365,7 @@ A bit more advanced, check string against :meth:`Process.name()`,
def find_procs_by_name(name):
"Return a list of processes matching 'name'."
ls = []
- for p in psutil.process_iter(attrs=["name", "exe", "cmdline"]):
+ for p in psutil.process_iter(["name", "exe", "cmdline"]):
if name == p.info['name'] or \
p.info['exe'] and os.path.basename(p.info['exe']) == name or \
p.info['cmdline'] and p.info['cmdline'][0] == name:
@@ -2410,21 +2410,21 @@ A collection of code samples showing how to use :func:`process_iter()` to filter
Processes owned by user::
>>> import getpass
- >>> pp([(p.pid, p.info['name']) for p in psutil.process_iter(attrs=['name', 'username']) if p.info['username'] == getpass.getuser()])
+ >>> pp([(p.pid, p.info['name']) for p in psutil.process_iter(['name', 'username']) if p.info['username'] == getpass.getuser()])
(16832, 'bash'),
(19772, 'ssh'),
(20492, 'python')]
Processes actively running::
- >>> pp([(p.pid, p.info) for p in psutil.process_iter(attrs=['name', 'status']) if p.info['status'] == psutil.STATUS_RUNNING])
+ >>> pp([(p.pid, p.info) for p in psutil.process_iter(['name', 'status']) if p.info['status'] == psutil.STATUS_RUNNING])
[(1150, {'name': 'Xorg', 'status': 'running'}),
(1776, {'name': 'unity-panel-service', 'status': 'running'}),
(20492, {'name': 'python', 'status': 'running'})]
Processes using log files::
- >>> for p in psutil.process_iter(attrs=['name', 'open_files']):
+ >>> for p in psutil.process_iter(['name', 'open_files']):
... for file in p.info['open_files'] or []:
... if file.path.endswith('.log'):
... print("%-5s %-10s %s" % (p.pid, p.info['name'][:10], file.path))
@@ -2435,14 +2435,14 @@ Processes using log files::
Processes consuming more than 500M of memory::
- >>> pp([(p.pid, p.info['name'], p.info['memory_info'].rss) for p in psutil.process_iter(attrs=['name', 'memory_info']) if p.info['memory_info'].rss > 500 * 1024 * 1024])
+ >>> pp([(p.pid, p.info['name'], p.info['memory_info'].rss) for p in psutil.process_iter(['name', 'memory_info']) if p.info['memory_info'].rss > 500 * 1024 * 1024])
[(2650, 'chrome', 532324352),
(3038, 'chrome', 1120088064),
(21915, 'sublime_text', 615407616)]
Top 3 processes which consumed the most CPU time::
- >>> pp([(p.pid, p.info['name'], sum(p.info['cpu_times'])) for p in sorted(psutil.process_iter(attrs=['name', 'cpu_times']), key=lambda p: sum(p.info['cpu_times'][:2]))][-3:])
+ >>> pp([(p.pid, p.info['name'], sum(p.info['cpu_times'])) for p in sorted(psutil.process_iter(['name', 'cpu_times']), key=lambda p: sum(p.info['cpu_times'][:2]))][-3:])
[(2721, 'chrome', 10219.73),
(1150, 'Xorg', 11116.989999999998),
(2650, 'chrome', 18451.97)]
diff --git a/scripts/cpu_distribution.py b/scripts/cpu_distribution.py
index c509c732..839d31df 100755
--- a/scripts/cpu_distribution.py
+++ b/scripts/cpu_distribution.py
@@ -84,7 +84,7 @@ def main():
# processes
procs = collections.defaultdict(list)
- for p in psutil.process_iter(attrs=['name', 'cpu_num']):
+ for p in psutil.process_iter(['name', 'cpu_num']):
procs[p.info['cpu_num']].append(p.info['name'][:5])
curr_line = 3
diff --git a/scripts/netstat.py b/scripts/netstat.py
index 490b429f..af56d03d 100755
--- a/scripts/netstat.py
+++ b/scripts/netstat.py
@@ -41,7 +41,7 @@ def main():
"Proto", "Local address", "Remote address", "Status", "PID",
"Program name"))
proc_names = {}
- for p in psutil.process_iter(attrs=['pid', 'name']):
+ for p in psutil.process_iter(['pid', 'name']):
proc_names[p.info['pid']] = p.info['name']
for c in psutil.net_connections(kind='inet'):
laddr = "%s:%s" % (c.laddr)
diff --git a/scripts/pidof.py b/scripts/pidof.py
index bcb8a2e6..c1042f4f 100755
--- a/scripts/pidof.py
+++ b/scripts/pidof.py
@@ -18,7 +18,7 @@ import sys
def pidof(pgname):
pids = []
- for proc in psutil.process_iter(attrs=['name', 'cmdline']):
+ for proc in psutil.process_iter(['name', 'cmdline']):
# search for matches in the process name and cmdline
if proc.info['name'] == pgname or \
proc.info['cmdline'] and proc.info['cmdline'][0] == pgname:
diff --git a/scripts/procsmem.py b/scripts/procsmem.py
index f660c085..4f8b4c84 100755
--- a/scripts/procsmem.py
+++ b/scripts/procsmem.py
@@ -64,7 +64,7 @@ def main():
with p.oneshot():
try:
mem = p.memory_full_info()
- info = p.as_dict(attrs=["cmdline", "username"])
+ info = p.as_dict(["cmdline", "username"])
except psutil.AccessDenied:
ad_pids.append(p.pid)
except psutil.NoSuchProcess: