3
{Meʍ @ s d dl Z d dlZd dlZd dlZd dlmZ d dlmZ d dlm Z dZ
dd Z dd Z G d
d d Z
d d
Zdd ZG dd dZG dd dZG dd dZG dd dZG dd dZG dd dZG d d d ZG d d d ZG d d! d!ZG d"d# d#Zed$krd dlZe Z x0e e jj D ] Z e e d%e je q*W e Z!x0e e!j!j D ] Z"e e" d%e!j!e" qbW e Z#e d&e#j$ d' x,e e#j D ] Z%e e% d(e#e% qW e d)d*d+ ee&ej'd, Z(x8ee(j)D ]*Z e e(j*e j+d-d.e(j*e j, qW e d*d+ x&e(j-ej'd/ D ]Z.e e.d0 qDW e Z/e e/d, e Z0xFej1d, e0j2 x$e0D ] Z#e e# d%e0e# qW e d2 qtW dS )3 N)reduce)range) bitmasklistz0.7.3c C s t j } ttjd| S )z) Return True if running on s390 or s390x Zs390)platformmachineboolresearch)r r
/usr/lib/python3.6/procfs.pyis_s390 s r c C s: | d r t dd | d j S y | d d S dS dS )z
Returns the process command line, if available in the given `process' class,
if not available, falls back to using the comm (short process name) in its
pidstat key.
cmdlinec S s | d| S )Nz %sr
)abr
r
r ! s z!process_cmdline..statcommN)r strip)Zpid_infor
r
r process_cmdline s r c + @ sN e Zd ZdZdZdZdZdZdZdZ dZ
d Z d
Z d Z
d Zd
ZdZdZdZdZdZdZdZdZdZdZdZdZdZ dZ dZ dZ d Z d Z!d Z"d Z#d Z$d Z%d!Z&d!Z'd"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;dd?d@dAdBdCdDdEdFdGdHdIdJdKdLg+Z(dcdNdOZ)dPdQ Z*dRdS Z+dTdU Z,dVdW Z-dXdY Z.dZd[ Z/ddd\d]Z0d^d_ Z1d`da Z2dbS )epidstatam
Provides a dictionary to access the fields in the
per process /proc/PID/stat files.
One can obtain the available fields by asking for the keys of the
dictionary, e.g.:
>>> p = procfs.pidstat(1)
>>> print p.keys()
['majflt', 'rss', 'cnswap', 'cstime', 'pid', 'session', 'startstack', 'startcode', 'cmajflt', 'blocked', 'exit_signal', 'minflt', 'nswap', 'environ', 'priority', 'state', 'delayacct_blkio_ticks', 'policy', 'rt_priority', 'ppid', 'nice', 'cutime', 'endcode', 'wchan', 'num_threads', 'sigcatch', 'comm', 'stime', 'sigignore', 'tty_nr', 'kstkeip', 'utime', 'tpgid', 'itrealvalue', 'kstkesp', 'rlim', 'signal', 'pgrp', 'flags', 'starttime', 'cminflt', 'vsize', 'processor']
And then access the various process properties using it as a dictionary:
>>> print p['comm']
systemd
>>> print p['priority']
20
>>> print p['state']
S
Please refer to the 'procfs(5)' man page, by using:
$ man 5 procfs
To see information for each of the above fields, it is part of the
'man-pages' RPM package.
@ i i i i i i @ i i i i i i i i @ i i i i i i i i @l pidr stateZppidZpgrpZsessionZtty_nrZtpgidflagsZminfltZcminfltZmajfltZcmajfltutimeZstimeZcutimeZcstimeZpriorityniceZ num_threadsZ itrealvalueZ starttimeZvsizeZrssZrlimZ startcodeZendcodeZ
startstackZkstkespZkstkeipsignalZblockedZ sigignoreZsigcatchZwchanZnswapZcnswapZ exit_signal processor rt_priorityZpolicyZdelayacct_blkio_ticksenviron/procc C s0 || _ y| j| W n tk
r* Y nX d S )N)r loadFileNotFoundError)selfr basedirr
r
r __init__~ s
zpidstat.__init__c C s
| j | S )N)fields)r+ fieldnamer
r
r __getitem__ s zpidstat.__getitem__c C s t | jj S )N)listr. keys)r+ r
r
r r2 s z pidstat.keysc C s t | jj S )N)r1 r. values)r+ r
r
r r3 s zpidstat.valuesc C s
|| j kS )N)r. )r+ r/ r
r
r has_key s zpidstat.has_keyc C s | j S )N)r. )r+ r
r
r items s z
pidstat.itemsc C s
|| j kS )N)r. )r+ r/ r
r
r __contains__ s zpidstat.__contains__c C s yt | d| j d}W n tk
r0 Y nX |j j jd}|j |d jd|d j }i | _tt |t | j
}xft |D ]Z}| j
| }|| }|dkr|jd| jd< qyt || j|< W q || j|< Y qX qW d S ) N/z/statz) r z (r r z())
openr r* readliner splitcloser. minlenproc_stat_fieldsr int)r+ r, fr. nr_fieldsiZattrnamevaluer
r
r r) s$
z pidstat.loadc C s t | jd | j@ S )z
Returns true if this process has a fixed smp affinity mask,
not allowing it to be moved to a different set of CPUs.
r! )r r. PF_THREAD_BOUND)r+ r
r
r is_bound_to_cpu s zpidstat.is_bound_to_cpuc C sN g }xDt | D ]8}|dd dkr$qt| |}|| jd @ r|j| qW |S )a
Returns a list with all the process flags known, details depend
on kernel version, declared in the file include/linux/sched.h in
the kernel sources.
As of v4.2-rc7 these include (from include/linux/sched.h comments):
PF_EXITING Getting shut down
PF_EXITPIDONE Pi exit done on shut down
PF_VCPU I'm a virtual CPU
PF_WQ_WORKER I'm a workqueue worker
PF_FORKNOEXEC Forked but didn't exec
PF_MCE_PROCESS Process policy on mce errors
PF_SUPERPRIV Used super-user privileges
PF_DUMPCORE Dumped core
PF_SIGNALED Killed by a signal
PF_MEMALLOC Allocating memory
PF_NPROC_EXCEEDED Set_user noticed that RLIMIT_NPROC was exceeded
PF_USED_MATH If unset the fpu must be initialized before use
PF_USED_ASYNC Used async_schedule*(), used by module init
PF_NOFREEZE This thread should not be frozen
PF_FROZEN Frozen for system suspend
PF_FSTRANS Inside a filesystem transaction
PF_KSWAPD I am kswapd
PF_MEMALLOC_NOIO Allocating memory without IO involved
PF_LESS_THROTTLE Throttle me less: I clean memory
PF_KTHREAD I am a kernel thread
PF_RANDOMIZE Randomize virtual address space
PF_SWAPWRITE Allowed to write to swap
PF_NO_SETAFFINITY Userland is not allowed to meddle with cpus_allowed
PF_MCE_EARLY Early kill for mce process policy
PF_MUTEX_TESTER Thread belongs to the rt mutex tester
PF_FREEZER_SKIP Freezer should not count it as freezable
PF_SUSPEND_TASK This thread called freeze_processes and
should not be frozen
N ZPF_r! )dirgetattrr. append)r+ ZsflagsattrrC r
r
r
process_flags s &
zpidstat.process_flagsN)r( )r( )3__name__
__module__ __qualname____doc__Z PF_ALIGNWARNZ PF_STARTINGZ
PF_EXITINGZ
PF_EXITPIDONEZPF_VCPUZ PF_WQ_WORKERZ
PF_FORKNOEXECZPF_MCE_PROCESSZ PF_SUPERPRIVZ PF_DUMPCOREZ PF_SIGNALEDZ PF_MEMALLOCZPF_NPROC_EXCEEDEDZ
PF_FLUSHERZ PF_USED_MATHZ
PF_USED_ASYNCZ PF_NOFREEZEZ PF_FROZENZ
PF_FSTRANSZ PF_KSWAPDZPF_MEMALLOC_NOIOZ
PF_SWAPOFFZPF_LESS_THROTTLEZ
PF_KTHREADZ PF_RANDOMIZEZ PF_SWAPWRITEZPF_SPREAD_PAGEZPF_SPREAD_SLABrD PF_NO_SETAFFINITYZ PF_MCE_EARLYZ PF_MEMPOLICYZPF_MUTEX_TESTERZPF_FREEZER_SKIPZPF_FREEZER_NOSIGZPF_SUSPEND_TASKr> r- r0 r2 r3 r4 r5 r6 r) rE rK r
r
r
r r * st
r c
C s2 d}y t t| j| d d |@ S dS d S )Ni r r! T)r r? processes)r+ r rP r
r
r cannot_set_affinity s rR c
C s8 d}y$t t| j| j| d d |@ S dS d S )Ni r r! T)r r? rQ threads)r+ r tidrP r
r
r cannot_set_thread_affinity s rU c @ sT e Zd ZdZdddZdd Zdd Zd d
Zd d Zd
d Z dd Z
dddZ dS ) pidstatusa
Provides a dictionary to access the fields
in the per process /proc/PID/status files.
This provides additional information about processes and threads to
what can be obtained with the procfs.pidstat() class.
One can obtain the available fields by asking for the keys of the
dictionary, e.g.:
>>> import procfs
>>> p = procfs.pidstatus(1)
>>> print p.keys()
['VmExe', 'CapBnd', 'NSpgid', 'Tgid', 'NSpid', 'VmSize', 'VmPMD', 'ShdPnd', 'State', 'Gid', 'nonvoluntary_ctxt_switches', 'SigIgn', 'VmStk', 'VmData', 'SigCgt', 'CapEff', 'VmPTE', 'Groups', 'NStgid', 'Threads', 'PPid', 'VmHWM', 'NSsid', 'VmSwap', 'Name', 'SigBlk', 'Mems_allowed_list', 'VmPeak', 'Ngid', 'VmLck', 'SigQ', 'VmPin', 'Mems_allowed', 'CapPrm', 'Seccomp', 'VmLib', 'Cpus_allowed', 'Uid', 'SigPnd', 'Pid', 'Cpus_allowed_list', 'TracerPid', 'CapInh', 'voluntary_ctxt_switches', 'VmRSS', 'FDSize']
>>> print p["Pid"]
1
>>> print p["Threads"]
1
>>> print p["VmExe"]
1248 kB
>>> print p["Cpus_allowed"]
f
>>> print p["SigQ"]
0/30698
>>> print p["VmPeak"]
320300 kB
>>>
Please refer to the 'procfs(5)' man page, by using:
$ man 5 procfs
To see information for each of the above fields, it is part of the
'man-pages' RPM package.
In the man page there will be references to further documentation, like
referring to the "getrlimit(2)" man page when explaining the "SigQ"
line/field.
/procc C s || _ | j| d S )N)r r) )r+ r r, r
r
r r- ! s zpidstatus.__init__c C s
| j | S )N)r. )r+ r/ r
r
r r0 % s zpidstatus.__getitem__c C s t | jj S )N)r1 r. r2 )r+ r
r
r r2 ( s zpidstatus.keysc C s t | jj S )N)r1 r. r3 )r+ r
r
r r3 + s zpidstatus.valuesc C s
|| j kS )N)r. )r+ r/ r
r
r r4 . s zpidstatus.has_keyc C s | j S )N)r. )r+ r
r
r r5 1 s zpidstatus.itemsc C s
|| j kS )N)r. )r+ r/ r
r
r r6 4 s zpidstatus.__contains__c C s i | _ t| d| j dn}xf|j D ]Z}|jd}t|dkrDq(|d }|d j }yt|| j |< W q( || j |< Y q(X q(W W d Q R X d S )Nr7 z/status:r r r )r. r8 r readlinesr: r= r r? )r+ r, r@ liner. namerC r
r
r r) 7 s
zpidstatus.loadN)rW )rW ) rL rM rN rO r- r0 r2 r3 r4 r5 r6 r) r
r
r
r rV s &
rV c @ sR e Zd ZdZdddZdd Zdd Zd d
Zd d Zd
d Z dd Z
dd Z dS )processa+
Information about a process with a given pid, provides a dictionary with
two entries, instances of different wrappers for /proc/ process related
meta files: "stat" and "status", see the documentation for procfs.pidstat
and procfs.pidstatus for further info about those classes.
/procc C s || _ || _d S )N)r r, )r+ r r, r
r
r r- N s zprocess.__init__c C s t | |s|dkrX|dkr t}nt}yt| ||| j| j W q tk
rT Y qX nF|dkrj| j n4|dkr|| j n"|dkr| j n|dkr| j
t | |S )Nr statusr
rS cgroupsr' )r r^ ) hasattrr rV setattrr r, r* load_cmdline load_threads load_cgroups load_environrH )r+ rJ Zsclassr
r
r r0 R s$
zprocess.__getitem__c C s
t | |S )N)r` )r+ rJ r
r
r r4 j s zprocess.has_keyc C s
t | |S )N)r` )r+ rJ r
r
r r6 m s zprocess.__contains__c C sv y>t d| j d"}|j j jdd d | _W d Q R X W n2 tk
rX d | _Y n tk
rp d | _Y nX d S )Nz/proc/z/cmdline r )r8 r r9 r r: r
r* UnicodeDecodeError)r+ r@ r
r
r rb p s *
zprocess.load_cmdlinec C s" t d| j d| _| j| j= d S )Nz/proc/z/task/)pidstatsr rS )r+ r
r
r rc { s zprocess.load_threadsc C st d| _ td| j dR}xJt|j D ]:}t| j dkrT| j d |d d | _ q(|d d | _ q(W W d Q R X d S ) N z/proc/z/cgroupr ,r rg rg )r_ r8 r reversedrY r= )r+ r@ rZ r
r
r rd s zprocess.load_cgroupsc C sh i | _ td| j dF}x>|j jdD ],}t|dkr*|jd}|d | j |d < q*W W dQ R X dS )aD
Loads the environment variables for this process. The entries then
become available via the 'environ' member, or via the 'environ'
dict key when accessing as p["environ"].
E.g.:
>>> all_processes = procfs.pidstats()
>>> firefox_pid = all_processes.find_by_name("firefox")
>>> firefox_process = all_processes[firefox_pid[0]]
>>> print firefox_process["environ"]["PWD"]
/home/acme
>>> print len(firefox_process.environ.keys())
66
>>> print firefox_process["environ"]["SHELL"]
/bin/bash
>>> print firefox_process["environ"]["USERNAME"]
acme
>>> print firefox_process["environ"]["HOME"]
/home/acme
>>> print firefox_process["environ"]["MAIL"]
/var/spool/mail/acme
>>>
z/proc/z/environrf r =r N)r' r8 r r9 r: r= )r+ r@ xyr
r
r re s
zprocess.load_environN)r] ) rL rM rN rO r- r0 r4 r6 rb rc rd re r
r
r
r r\ F s
r\ c @ s e Zd ZdZd$ddZdd Zdd Zd d
Zd d Zd
d Z dd Z
dd Z dd Z dd Z
dd Zdd Zdd Zd d Zd d Zd!d" Zd#S )%ri a#
Provides access to all the processes in the system, to get a picture of
how many processes there are at any given moment.
The entries can be accessed as a dictionary, keyed by pid. Also there are
methods to find processes that match a given COMM or regular expression.
/procc C s || _ i | _| j d S )N)r, rQ reload)r+ r, r
r
r r- s zpidstats.__init__c C s
| j | S )N)rQ )r+ keyr
r
r r0 s zpidstats.__getitem__c C s y | j |= W n Y nX d S )N)rQ )r+ rr r
r
r __delitem__ s zpidstats.__delitem__c C s t | jj S )N)r1 rQ r2 )r+ r
r
r r2 s z
pidstats.keysc C s t | jj S )N)r1 rQ r3 )r+ r
r
r r3 s zpidstats.valuesc C s
|| j kS )N)rQ )r+ rr r
r
r r4 s zpidstats.has_keyc C s | j S )N)rQ )r+ r
r
r r5 s zpidstats.itemsc C s
|| j kS )N)rQ )r+ rr r
r
r r6 s zpidstats.__contains__c
C sV | ` i | _ tj| j}x:|D ]2}y t|}W n w Y nX t|| j| j |< q W dS )a'
This operation will throw away the current dictionary contents,
if any, and read all the pid files from /proc/, instantiating a
'process' instance for each of them.
This is a high overhead operation, and should be avoided if the
perf python binding can be used to detect when new threads appear
and existing ones terminate.
In RHEL it is found in the python-perf rpm package.
More information about the perf facilities can be found in the
'perf_event_open' man page.
N)rQ oslistdirr, r? r\ )r+ pidsZspidr r
r
r rq s
zpidstats.reloadc C sh g }xHt | jj D ]6}y| j| j W q tk
rH |j| Y qX qW x|D ] }| j|= qTW d S )N)r1 rQ r2 rc OSErrorrI )r+ Z to_remover r
r
r reload_threads s
zpidstats.reload_threadsc C sn |d d }g }xXt | jj D ]F}y$|| j| d d krF|j| W q tk
rd | j|= Y q X q W |S )N r r )r1 rQ r2 rI IOError)r+ r[ rv r r
r
r find_by_name s zpidstats.find_by_namec C sd g }xZt | jj D ]H}y&|j| j| d d r<|j| W q tk
rZ | j|= Y qX qW |S )Nr r )r1 rQ r2 matchrI rz )r+ regexrv r r
r
r
find_by_regex s zpidstats.find_by_regexc C s` g }xVt | jj D ]D}y"|jt| j| r8|j| W q tk
rV | j|= Y qX qW |S )N)r1 rQ r2 r| r rI rz )r+ r} rv r r
r
r find_by_cmdline_regex s z pidstats.find_by_cmdline_regexc s d}d}g x| d| }| j |}| sFt fdd|D dkrHP xF|D ]>}y || j| d d 7 }W qN tk
r | j|= Y qNX qNW |7 |d7 }qW |jd }|S )
Nr rj r7 c s g | ]}| kr|qS r
r
).0n)processed_pidsr
r
' s z0pidstats.get_per_cpu_rtprios..r r& r rk )r{ r= rQ rz r )r+ basenamecpu
prioritiesr[ rv r r
)r r get_per_cpu_rtprios s"
z pidstats.get_per_cpu_rtpriosc s d}d}g x| j |}| s8t fdd|D dkr:P xF|D ]>}y || j| d d 7 }W q@ tk
r| | j|= Y q@X q@W |7 |d7 }qW |jd}|S ) Nr rj c s g | ]}| kr|qS r
r
)r r )r r
r r = s z(pidstats.get_rtprios..r r& r rk )r{ r= rQ rz r )r+ r[ r r rv r r
)r r get_rtprios7 s
zpidstats.get_rtpriosc C s | j | d j S )zQ
Checks if a given pid can't have its SMP affinity mask changed.
r )rQ rE )r+ r r
r
r rE M s zpidstats.is_bound_to_cpuN)rp )rL rM rN rO r- r0 rs r2 r3 r4 r5 r6 rq rx r{ r~ r r r rE r
r
r
r ri s"
ri c @ sp e Zd ZdZdd Zdd Zdd Zdd Zd
d Zd d
Z dd Z
dd Z dd Z dd Z
dd Zdd ZdS )
interruptsam
Information about IRQs in the system. A dictionary keyed by IRQ number
will have as its value another dictionary with "cpu", "type" and "users"
keys, with the SMP affinity mask, type of IRQ and the drivers associated
with each interrupt.
The information comes from the /proc/interrupts file, documented in
'man procfs(5)', for instance, the 'cpu' dict is an array with one entry
per CPU present in the sistem, each value being the number of interrupts
that took place per CPU.
E.g.:
>>> import procfs
>>> interrupts = procfs.interrupts()
>>> thunderbolt_irq = interrupts.find_by_user("thunderbolt")
>>> print thunderbolt_irq
34
>>> thunderbolt = interrupts[thunderbolt_irq]
>>> print thunderbolt
{'affinity': [0, 1, 2, 3], 'type': 'PCI-MSI', 'cpu': [3495, 0, 81, 0], 'users': ['thunderbolt']}
>>>
c C s i | _ | j d S )N)r rq )r+ r
r
r r- m s zinterrupts.__init__c C s | j t| S )N)r str)r+ rr r
r
r r0 q s zinterrupts.__getitem__c C s t | jj S )N)r1 r r2 )r+ r
r
r r2 t s zinterrupts.keysc C s t | jj S )N)r1 r r3 )r+ r
r
r r3 w s zinterrupts.valuesc C s t || jkS )N)r r )r+ rr r
r
r r4 z s zinterrupts.has_keyc C s | j S )N)r )r+ r
r
r r5 } s zinterrupts.itemsc C s t || jkS )N)r r )r+ rr r
r
r r6 s zinterrupts.__contains__c C s | ` i | _ td}x|j D ]}|j }|j }|d d d dkrRt|| _q |d jd}i | j |< | j|dd || j |< y t|}W n w Y nX | j || j | d< q W W d Q R X d S )Nz/proc/interruptsr rF ZCPUrX r Zaffinity)
r r8 rY r r: r= nr_cpus parse_entryr? parse_affinity)r+ r@ rZ r. irqZnirqr
r
r rq s"
zinterrupts.reloadc C s i }g |d< |d j t|d t|}|| jkr|d dd |d| j D 7 < || jkr|| j |d< || jd krdd ||d jdD |d < ng |d < |S )
Nr r c S s g | ] }t |qS r
)r? )r rB r
r
r r s z*interrupts.parse_entry..r typec S s g | ] }|j qS r
)r )r r r
r
r r s rk users)rI r? r= r r: )r+ r. rZ dictrA r
r
r r s
$
zinterrupts.parse_entryc C sL y0t d| d}|j }W d Q R X t|| jS tk
rF dgS X d S )Nz
/proc/irq/z
/smp_affinityr )r8 r9 r r rz )r+ r r@ rZ r
r
r r s zinterrupts.parse_affinityc C s@ x:t | jj D ](}d| j| kr|| j| d kr|S qW dS )a
Looks up a interrupt number by the name of one of its users"
E.g.:
>>> import procfs
>>> interrupts = procfs.interrupts()
>>> thunderbolt_irq = interrupts.find_by_user("thunderbolt")
>>> print thunderbolt_irq
34
>>> thunderbolt = interrupts[thunderbolt_irq]
>>> print thunderbolt
{'affinity': [0, 1, 2, 3], 'type': 'PCI-MSI', 'cpu': [3495, 0, 81, 0], 'users': ['thunderbolt']}
>>>
r N)r1 r r2 )r+ userrB r
r
r find_by_user s
zinterrupts.find_by_userc C s^ g }xTt | jj D ]B}d| j| kr(qx,| j| d D ]}|j|r8|j| P q8W qW |S )a
Looks up a interrupt number by a regex that matches names of its users"
E.g.:
>>> import procfs
>>> import re
>>> interrupts = procfs.interrupts()
>>> usb_controllers = interrupts.find_by_user_regex(re.compile(".*hcd"))
>>> print usb_controllers
['22', '23', '31']
>>> print [ interrupts[irq]["users"] for irq in usb_controllers ]
[['ehci_hcd:usb4'], ['ehci_hcd:usb3'], ['xhci_hcd']]
>>>
r )r1 r r2 r| rI )r+ r} ZirqsrB r r
r
r find_by_user_regex s
z interrupts.find_by_user_regexN)rL rM rN rO r- r0 r2 r3 r4 r5 r6 rq r r r r r
r
r
r r T s r c @ s@ e Zd ZdZdd Zdd Zdd Zdd Zd
d Zd d
Z dS )r
a9
Parses the kernel command line (/proc/cmdline), turning it into a dictionary."
Useful to figure out if some kernel boolean knob has been turned on,
as well as to find the value associated to other kernel knobs.
It can also be used to find out about parameters passed to the
init process, such as 'BOOT_IMAGE', etc.
E.g.:
>>> import procfs
>>> kcmd = procfs.cmdline()
>>> print kcmd.keys()
['LANG', 'BOOT_IMAGE', 'quiet', 'rhgb', 'rd.lvm.lv', 'ro', 'root']
>>> print kcmd["BOOT_IMAGE"]
/vmlinuz-4.3.0-rc1+
>>>
c C s i | _ | j d S )N)optionsparse)r+ r
r
r r- s zcmdline.__init__c C sj t dX}xP|j j j D ]<}|jd}t|dkrFd| j|d < q |d | j|d < q W W d Q R X d S )Nz
/proc/cmdlinerm r Tr )r8 r9 r r: r= r )r+ r@ Zoptionr. r
r
r r s
z
cmdline.parsec C s
| j | S )N)r )r+ rr r
r
r r0 s zcmdline.__getitem__c C s t | jj S )N)r1 r r2 )r+ r
r
r r2 s z cmdline.keysc C s t | jj S )N)r1 r r3 )r+ r
r
r r3 s zcmdline.valuesc C s | j S )N)r )r+ r
r
r r5
s z
cmdline.itemsN)
rL rM rN rO r- r r0 r2 r3 r5 r
r
r
r r
s r
c @ sB e Zd ZdZdddZdd Zdd Zd d
Zd d Zd
d Z dS )cpuinfoa
Dictionary with information about CPUs in the system.
Please refer to 'man procfs(5)' for further information about the
'/proc/cpuinfo' file, that is the source of the information provided
by this class. The 'man lscpu(1)' also has information about a program that
uses the '/proc/cpuinfo' file.
Using this class one can obtain the number of CPUs in a system:
>>> cpus = procfs.cpuinfo()
>>> print cpus.nr_cpus
4
It is also possible to figure out aspects of the CPU topology, such as
how many CPU physical sockets exists, i.e. groups of CPUs sharing
components such as CPU memory caches:
>>> print len(cpus.sockets)
1
Additionally dictionary with information common to all CPUs in the system
is available:
>>> print cpus["model name"]
Intel(R) Core(TM) i7-3667U CPU @ 2.00GHz
>>> print cpus["cache size"]
4096 KB
>>>
/proc/cpuinfoc C s i | _ d| _g | _| j| d S )Nr )tagsr socketsr )r+ filenamer
r
r r- . s zcpuinfo.__init__c C s | j |j S )N)r lower)r+ rr r
r
r r0 4 s zcpuinfo.__getitem__c C s t | jj S )N)r1 r r2 )r+ r
r
r r2 7 s z cpuinfo.keysc C s t | jj S )N)r1 r r3 )r+ r
r
r r3 : s zcpuinfo.valuesc C s | j S )N)r )r+ r
r
r r5 = s z
cpuinfo.itemsc C s( t |}x|j D ]}|j }|s&q|jd}|d j j }|dkrX| jd7 _qt rv|dkrv| jd7 _q|dkrq|d j | j|< |dkr| j| }|| jkr| jj | qW W d Q R X | jrt
| jp| jd| jkrt | jd pd | _ d | jkrt | jd pd| j | _
d S )
NrX r r% r z
cpu numberzcore idz physical idZsiblingsz cpu cores)r8 rY r r: r r r r r rI r= r? Z
nr_socketsZnr_cores)r+ r r@ rZ r. ZtagnameZ socket_idr
r
r r @ s2
z
cpuinfo.parseN)r )
rL rM rN rO r- r0 r2 r3 r5 r r
r
r
r r s
r c @ s8 e Zd ZdZdd Zdd Zdd Zdd Zd
d Zd S )
smaps_libat
Representation of an mmap in place for a process. Can be used to figure
out which processes have an library mapped, etc.
The 'perm' member can be used to figure out executable mmaps,
i.e. libraries.
The 'vm_start' and 'vm_end' in turn can be used when trying to resolve
processor instruction pointer addresses to a symbol name in a library.
c
C s |d j }dd |d j dD \| _| _|d | _t|d d| _|d j d \| _| _t|d
| _t |d kr|d | _
nd | _
i | _ x^|dd D ]N}|j }|d d d j }yt|d | j |< W q || j |< Y qX qW d S )
Nr c S s g | ]}t |d qS )r )r? )r r r
r
r r j s z&smaps_lib.__init__..-r r r rF rX r rg )
r: vm_startZvm_endZpermsr? offsetmajorminorinoder= r[ r r )r+ linesr. rZ tagr
r
r r- h s"
zsmaps_lib.__init__c C s | j |j S )N)r r )r+ rr r
r
r r0 } s zsmaps_lib.__getitem__c C s t | jj S )N)r1 r r2 )r+ r
r
r r2 s zsmaps_lib.keysc C s t | jj S )N)r1 r r3 )r+ r
r
r r3 s zsmaps_lib.valuesc C s | j S )N)r )r+ r
r
r r5 s zsmaps_lib.itemsN) rL rM rN rO r- r0 r2 r3 r5 r
r
r
r r \ s
r c @ s@ e Zd ZdZdd Zdd Zdd Zdd Zd
d Zd d
Z dS )smapsa~
List of libraries mapped by a process. Parses the lines in
the /proc/PID/smaps file, that is further documented in the
procfs(5) man page.
Example: Listing the executable maps for the 'sshd' process:
>>> import procfs
>>> processes = procfs.pidstats()
>>> sshd = processes.find_by_name("sshd")
>>> sshd_maps = procfs.smaps(sshd[0])
>>> for i in range(len(sshd_maps)):
... if 'x' in sshd_maps[i].perms:
... print "%s: %s" % (sshd_maps[i].name, sshd_maps[i].perms)
...
/usr/sbin/sshd: r-xp
/usr/lib64/libnss_files-2.20.so: r-xp
/usr/lib64/librt-2.20.so: r-xp
/usr/lib64/libkeyutils.so.1.5: r-xp
/usr/lib64/libkrb5support.so.0.1: r-xp
/usr/lib64/libfreebl3.so: r-xp
/usr/lib64/libpthread-2.20.so: r-xp
...
c C s || _ g | _| j d S )N)r entriesrq )r+ r r
r
r r- s zsmaps.__init__c C sx g }|s|j j }|s d S |j| x<|j }|s6P |j }|j d d dkr^|j| q(P q(W | jjt| |S )Nr r rX rg )r9 r rI r: r r )r+ r@ rZ r r
r
r r s
zsmaps.parse_entryc C s
t | jS )N)r= r )r+ r
r
r __len__ s z
smaps.__len__c C s
| j | S )N)r )r+ indexr
r
r r0 s zsmaps.__getitem__c
C sJ d }t d| j d }x| j||}|sP qW W d Q R X t| j| _d S )Nz/proc/z/smaps)r8 r r r= r
nr_entries)r+ rZ r@ r
r
r rq s z smaps.reloadc C sN g }xDt | jD ]6}| j| jr| j| jj|dkr|j| j| qW |S )Nr )r r r r[ findrI )r+ ZfragmentresultrB r
r
r find_by_name_fragment s zsmaps.find_by_name_fragmentN)
rL rM rN rO r- r r r0 rq r r
r
r
r r s r c @ s e Zd ZdZdd Zdd ZdS )cpustatz
CPU statistics, obtained from a line in the '/proc/stat' file, Please
refer to 'man procfs(5)' for further information about the '/proc/stat'
file, that is the source of the information provided by this class.
c C st |d | _ dd |dd D \| _| _| _| _| _| _| _t|dkrpt |d | _
t|dkrpt |d | _ d S )Nr c S s g | ] }t |qS r
)r? )r rB r
r
r r s z$cpustat.__init__..r r ) r[ r r# systemidleiowaitr softirqr= r? stealguest)r+ r. r
r
r r- s
2 zcpustat.__init__c C sx d| j d| j d| j d| j d| j d| j d| j }t| drV|d | j 7 }t| d
rp|d | j 7 }|d S )
Nz< user: z, nice: z
, system: z, idle: z
, iowait: z, irq: z , softirq: r z , steal: r z , guest: >)
r r# r r r r r r` r r )r+ sr
r
r __repr__ s <
zcpustat.__repr__N)rL rM rN rO r- r r
r
r
r r s r c @ sR e Zd ZdZdddZdd Zdd Zd d
Zd d Zd
d Z dd Z
dd Z dS ) cpusstatsaN
Dictionary with information about CPUs in the system. First entry in the
dictionary gives an aggregate view of all CPUs, each other entry is about
separate CPUs. Please refer to 'man procfs(5)' for further information
about the '/proc/stat' file, that is the source of the information provided
by this class.
/proc/statc C s* i | _ d | _tjd| _|| _| j d S )Nr )r timert sysconfhertzr rq )r+ r r
r
r r- s
zcpusstats.__init__c C s
t | jS )N)iterr )r+ r
r
r __iter__ s zcpusstats.__iter__c C s
| j | S )N)r )r+ rr r
r
r r0 s zcpusstats.__getitem__c C s t t| jj S )N)r= r1 r r2 )r+ r
r
r r s zcpusstats.__len__c C s t | jj S )N)r1 r r2 )r+ r
r
r r2 s zcpusstats.keysc C s t | jj S )N)r1 r r3 )r+ r
r
r r3 s zcpusstats.valuesc C s | j S )N)r )r+ r
r
r r5 s zcpusstats.itemsc C s: | j }i | _ t| jv}xn|j D ]b}|j j }|d d d j dkrLq"t|}|jdkrdd}nt |jdd d }|| j |< q"W W d Q R X | j
}t
j
| _
|r6| j
| }|| j } xxt | j j
D ]f}
|
|krd| _q| j |
} ||
} | j| j | j| j | j| j }
|
| d | _t| jd| _qW d S )Nr rF r r d )r r8 r rY r r: r r r[ r? r r r1 r2 Zusager r# r r< )r+ Z last_entriesr@ rZ r. cidxZ last_timeZ delta_secZ interval_hzr ZcurrprevZdeltar
r
r rq s6
zcpusstats.reloadN)r ) rL rM rN rO r- r r0 r r2 r3 r5 rq r
r
r
r r s
r __main__z: z
cpuinfo data: z processorsrm zsmaps:
r ( r z#x r ZSize
z
----------)3rt r r r functoolsr Z six.movesr Zprocfs.utilistr VERSIONr r r rR rU rV r\ ri r r
r r r r r rL sysZintsr1 r2 rB printr or r r r? argvr r r r r[ r r ZpsZcsZsleeprq r
r
r
r sj > Me *
.N.K B
*