Current File : //usr/lib/python2.7/site-packages/salt/modules/ps.pyo
�
���^c @@ sG d Z d d l m Z m Z m Z d d l Z d d l Z d d l Z d d l Z d d l
m Z m Z d d l
Z d d l m Z y4 d d l j j Z e Z e e d d, � d- k Z Wn e k
r� e Z n Xd � Z d � Z d
� Z d � Z d � Z d
� Z d � Z d d d � Z! d � Z" d d � Z$ d d � Z% d d e d � Z& d e d � Z' d e d � Z( e d � Z) d � Z* d � Z+ e d � Z, d � Z- e d � Z. d � Z/ d! � Z0 d d" � Z1 d d# � Z2 d d$ � Z3 d% � Z4 d& � Z5 e j j6 j7 j8 d' � d( � � Z9 e j j6 j7 j8 d) � d* � � Z: d+ � Z; d S(. u�
A salt interface to psutil, a system and process library.
See http://code.google.com/p/psutil.
:depends: - psutil Python module, version 0.3.0 or later
- python-utmp package (optional)
i ( t absolute_importt unicode_literalst print_functionN( t SaltInvocationErrort CommandExecutionError( t sixu version_infoi c C@ s9 t s t d f St j d k r# t St d j t j � f S( NuC The ps module cannot be loaded: python module psutil not installed.i i ua The ps execution module cannot be loaded: the psutil python module version {0} is less than 0.3.0( i i i ( t
HAS_PSUTILt Falset psutilt version_infot Truet format( ( ( s3 /usr/lib/python2.7/site-packages/salt/modules/ps.pyt __virtual__" s
c C@ sQ y, t j j j t r! | j � n | j � SWn t j t j f k
rL g SXd S( uq
Returns the cmdline of a Process instance.
It's backward compatible with < 2.0 versions of psutil.
N( t saltt utilst datat decodet PSUTIL2t cmdlineR t
NoSuchProcesst AccessDenied( t proc( ( s3 /usr/lib/python2.7/site-packages/salt/modules/ps.pyt _get_proc_cmdline2 s ,c C@ sQ y, t j j j t r! | j � n | j � SWn t j t j f k
rL d SXd S( uu
Returns the create_time of a Process instance.
It's backward compatible with < 2.0 versions of psutil.
N(
R
R R R R t create_timeR R R t None( R ( ( s3 /usr/lib/python2.7/site-packages/salt/modules/ps.pyt _get_proc_create_time> s ,c C@ sQ y, t j j j t r! | j � n | j � SWn t j t j f k
rL g SXd S( un
Returns the name of a Process instance.
It's backward compatible with < 2.0 versions of psutil.
N( R
R R R R t nameR R R ( R ( ( s3 /usr/lib/python2.7/site-packages/salt/modules/ps.pyt _get_proc_nameJ s ,c C@ sQ y, t j j j t r! | j � n | j � SWn t j t j f k
rL d SXd S( up
Returns the status of a Process instance.
It's backward compatible with < 2.0 versions of psutil.
N(
R
R R R R t statusR R R R ( R ( ( s3 /usr/lib/python2.7/site-packages/salt/modules/ps.pyt _get_proc_statusV s ,c C@ sT y, t j j j t r! | j � n | j � SWn! t j t j t f k
rO d SXd S( ur
Returns the username of a Process instance.
It's backward compatible with < 2.0 versions of psutil.
N( R
R R R R t usernameR R R t KeyErrorR ( R ( ( s3 /usr/lib/python2.7/site-packages/salt/modules/ps.pyt _get_proc_usernameb s , c C@ s | j S( um
Returns the pid of a Process instance.
It's backward compatible with < 2.0 versions of psutil.
( t pid( R ( ( s3 /usr/lib/python2.7/site-packages/salt/modules/ps.pyt
_get_proc_pidn s i i c C@ s� g } i } x� t j � D]{ } y% t j | � } | j � \ } } Wn? t k
ro | j � \ } } } } n t j k
r� q n X| | | | <q Wt j | � t � } x� t j
| � D]� \ } }
y | j � \ } } Wn? t k
r | j � \ } } } } n t j k
r!q� n X| | } | |
} | j | | f � q� WxEt t
t | � � � D]+\ }
\ } } | r�|
| k r�Pn t t | � � d k r�t | � } n t | � } i | d 6t | � d 6t | � d 6t | � d 6t | � d 6i d 6i d 6} x7 t j
| j � j � � D] \ } } | | d | <q,Wx7 t j
| j � j � � D] \ } } | | d | <qfW| j | � qfW| S( u*
Return a list of top CPU consuming processes during the interval.
num_processes = return the top N CPU consuming processes
interval = the number of seconds to sample CPU usage over
CLI Examples:
.. code-block:: bash
salt '*' ps.top
salt '*' ps.top 5 10
i u cmdu useru statusu pidu create_timeu cpuu mem( R t pidst Processt cpu_timest
ValueErrorR t timet sleept setR t iteritemst addt enumeratet reversedt sortedt lenR R R R R" R t _asdictt memory_infot append( t
num_processest intervalt resultt start_usageR! t processt usert systemt _t usaget startt nowt difft idxR t infot keyt value( ( s3 /usr/lib/python2.7/site-packages/salt/modules/ps.pyt topw sT
+
((c C@ s
t j � S( u�
Return a list of process ids (PIDs) for all running processes.
CLI Example:
.. code-block:: bash
salt '*' ps.get_pid_list
( R R# ( ( ( s3 /usr/lib/python2.7/site-packages/salt/modules/ps.pyt get_pid_list� s
c C@ sU y t j | � } | j | � SWn. t j t j t f k
rP } t | � � n Xd S( u�
Return a dictionary of information for a process id (PID).
CLI Example:
.. code-block:: bash
salt '*' ps.proc_info 2322
salt '*' ps.proc_info 2322 attrs='["pid", "name"]'
pid
PID of process to query.
attrs
Optional list of desired process attributes. The list of possible
attributes can be found here:
http://pythonhosted.org/psutil/#psutil.Process
N( R R$ t as_dictR R t AttributeErrorR ( R! t attrsR t exc( ( s3 /usr/lib/python2.7/site-packages/salt/modules/ps.pyt proc_info� s
i c C@ s: y t j | � j | � t SWn t j k
r5 t SXd S( u�
Kill a process by PID.
.. code-block:: bash
salt 'minion' ps.kill_pid pid [signal=signal_number]
pid
PID of process to kill.
signal
Signal to send to the process. See manpage entry for kill
for possible values. Default: 15 (SIGTERM).
**Example:**
Send SIGKILL to process with PID 2000:
.. code-block:: bash
salt 'minion' ps.kill_pid 2000 signal=9
N( R R$ t send_signalR
R R ( R! t signal( ( s3 /usr/lib/python2.7/site-packages/salt/modules/ps.pyt kill_pid� s
c C@ s� g } x� t j � D]� } | r: | d j t | � � k n | t | � k } | d k r^ t n | t | � k } | r | r y$ | j | � | j t
| � � Wq� t j k
r� q� Xq q W| s� d Si | d 6Sd S( u�
Kill processes matching a pattern.
.. code-block:: bash
salt '*' ps.pkill pattern [user=username] [signal=signal_number] \
[full=(true|false)]
pattern
Pattern to search for in the process list.
user
Limit matches to the given username. Default: All users.
signal
Signal to send to the process(es). See manpage entry for kill
for possible values. Default: 15 (SIGTERM).
full
A boolean value indicating whether only the name of the command or
the full command line should be matched against the pattern.
**Examples:**
Send SIGHUP to all httpd processes on all 'www' minions:
.. code-block:: bash
salt 'www.*' ps.pkill httpd signal=1
Send SIGKILL to all bash processes owned by user 'tom':
.. code-block:: bash
salt '*' ps.pkill bash signal=9 user=tom
u u killedN( R t process_itert joinR R R R
R RJ R2 R" R ( t patternR8 RK t fullt killedR t
name_matcht
user_match( ( s3 /usr/lib/python2.7/site-packages/salt/modules/ps.pyt pkill� s &!$
c C@ s� g } x� t j � D] } | r: | d j t | � � k n | t | � k } | d k r^ t n | t | � k } | r | r | j t | � � q q W| p� d S( u9
Return the pids for processes matching a pattern.
If full is true, the full command line is searched for a match,
otherwise only the name of the command is searched.
.. code-block:: bash
salt '*' ps.pgrep pattern [user=username] [full=(true|false)]
pattern
Pattern to search for in the process list.
user
Limit matches to the given username. Default: All users.
full
A boolean value indicating whether only the name of the command or
the full command line should be matched against the pattern.
**Examples:**
Find all httpd processes on all 'www' minions:
.. code-block:: bash
salt 'www.*' ps.pgrep httpd
Find all bash processes owned by user 'tom':
.. code-block:: bash
salt '*' ps.pgrep bash user=tom
u N(
R RM RN R R R R
R R2 R" ( RO R8 RP t procsR RR RS ( ( s3 /usr/lib/python2.7/site-packages/salt/modules/ps.pyt pgrep1 s $!$ g�������?c C@ s4 | r! t t j | t � � } n t j | � } | S( uN
Return the percent of time the CPU is busy.
interval
the number of seconds to sample CPU usage over
per_cpu
if True return an array of CPU percent busy for each CPU, otherwise
aggregate all percents into one number
CLI Example:
.. code-block:: bash
salt '*' ps.cpu_percent
( t listR t cpu_percentR
( R4 t per_cpuR5 ( ( s3 /usr/lib/python2.7/site-packages/salt/modules/ps.pyRX _ s c C@ sV | r7 g t j t � D] } t | j � � ^ q } n t t j | � j � � } | S( uF
Return the percent of time the CPU spends in each state,
e.g. user, system, idle, nice, iowait, irq, softirq.
per_cpu
if True return an array of percents for each CPU, otherwise aggregate
all percents into one number
CLI Example:
.. code-block:: bash
salt '*' ps.cpu_times
( R R% R
t dictR0 ( RY t timesR5 ( ( s3 /usr/lib/python2.7/site-packages/salt/modules/ps.pyR% v s 1c C@ s: t j d k r$ d } t | � � n t t j � j � � S( u
.. versionadded:: 2014.7.0
Return a dict that describes statistics about system memory usage.
.. note::
This function is only available in psutil version 0.6.0 and above.
CLI Example:
.. code-block:: bash
salt '*' ps.virtual_memory
i i u; virtual_memory is only available in psutil 0.6.0 or greater( i i i ( R R R RZ t virtual_memoryR0 ( t msg( ( s3 /usr/lib/python2.7/site-packages/salt/modules/ps.pyR\ � s c C@ s: t j d k r$ d } t | � � n t t j � j � � S( u
.. versionadded:: 2014.7.0
Return a dict that describes swap memory statistics.
.. note::
This function is only available in psutil version 0.6.0 and above.
CLI Example:
.. code-block:: bash
salt '*' ps.swap_memory
i i u8 swap_memory is only available in psutil 0.6.0 or greater( i i i ( R R R RZ t swap_memoryR0 ( R] ( ( s3 /usr/lib/python2.7/site-packages/salt/modules/ps.pyR^ � s c C@ s2 g t j | � D] } t | j � � ^ q } | S( uK
Return a list of disk partitions and their device, mount point, and
filesystem type.
all
if set to False, only return local, physical partitions (hard disk,
USB, CD/DVD partitions). If True, return all filesystems.
CLI Example:
.. code-block:: bash
salt '*' ps.disk_partitions
( R t disk_partitionsRZ R0 ( t allt partitionR5 ( ( s3 /usr/lib/python2.7/site-packages/salt/modules/ps.pyR_ � s +c C@ s t t j | � j � � S( u�
Given a path, return a dict listing the total available space as well as
the free space, and used space.
CLI Example:
.. code-block:: bash
salt '*' ps.disk_usage /home
( RZ R t
disk_usageR0 ( t path( ( s3 /usr/lib/python2.7/site-packages/salt/modules/ps.pyRb � s c C@ s8 t | � } x% | D] } | j t | d � � q W| S( u�
Return a list of disk partitions plus the mount point, filesystem and usage
statistics.
CLI Example:
.. code-block:: bash
salt '*' ps.disk_partition_usage
u
mountpoint( R_ t updateRb ( R` R5 Ra ( ( s3 /usr/lib/python2.7/site-packages/salt/modules/ps.pyt disk_partition_usage� s
c C@ sQ t j d k r$ d } t | � � n y t j � j SWn t k
rL t j SXd S( u�
Return the total number of bytes of physical memory.
CLI Example:
.. code-block:: bash
salt '*' ps.total_physical_memory
i i u; virtual_memory is only available in psutil 0.6.0 or greaterN( i i i ( R R R R\ t totalRF t TOTAL_PHYMEM( R] ( ( s3 /usr/lib/python2.7/site-packages/salt/modules/ps.pyt total_physical_memory� s
c C@ s* y t j � SWn t k
r% t j SXd S( un
Return the number of CPUs.
CLI Example:
.. code-block:: bash
salt '*' ps.num_cpus
N( R t cpu_countRF t NUM_CPUS( ( ( s3 /usr/lib/python2.7/site-packages/salt/modules/ps.pyt num_cpus s
c C@ s� y t t j � � } Wn# t k
r; t t j � � } n X| r� t j j | � } y | j | � SWq� t k
r� } t d j | � � � q� Xn | S( u�
Return the boot time in number of seconds since the epoch began.
CLI Example:
time_format
Optionally specify a `strftime`_ format string. Use
``time_format='%c'`` to get a nicely-formatted locale specific date and
time (i.e. ``Fri May 2 19:08:32 2014``).
.. _strftime: https://docs.python.org/2/library/datetime.html#strftime-strptime-behavior
.. versionadded:: 2014.1.4
.. code-block:: bash
salt '*' ps.boot_time
u Invalid format string: {0}(
t intR t boot_timeRF t datetimet
fromtimestampt strftimet TypeErrorR R ( t time_formatt b_timeRH ( ( s3 /usr/lib/python2.7/site-packages/salt/modules/ps.pyRm s
c C@ sV | s t t j � j � � St j d t � } | | k rN t | | j � � St Sd S( u�
Return network I/O statistics.
CLI Example:
.. code-block:: bash
salt '*' ps.network_io_counters
salt '*' ps.network_io_counters interface=eth0
t pernicN( RZ R t net_io_countersR0 R
R ( t interfacet stats( ( s3 /usr/lib/python2.7/site-packages/salt/modules/ps.pyt network_io_counters5 s c C@ sV | s t t j � j � � St j d t � } | | k rN t | | j � � St Sd S( u�
Return disk I/O statistics.
CLI Example:
.. code-block:: bash
salt '*' ps.disk_io_counters
salt '*' ps.disk_io_counters device=sda1
t perdiskN( RZ R t disk_io_countersR0 R
R ( t deviceRw ( ( s3 /usr/lib/python2.7/site-packages/salt/modules/ps.pyRz K s c C@ s y3 t j � } g | D] } t | j � � ^ q SWn� t k
r y� d d l } g } x� t r� | j j � } | d k r� | S| d d k r[ | d } t
| t � r� | d } n | j i | d d 6| d d 6| d 6| d
d 6� q[ q[ WWq t
k
rt SXn Xd S( ul
Return logged-in users.
CLI Example:
.. code-block:: bash
salt '*' ps.get_users
i Ni i i u namei u terminalu startedi u host( R t usersRZ R0 RF t utmpR
t
utmpaccesst getutentR t
isinstancet tupleR2 t ImportErrorR ( t recst xR} R5 t rect started( ( s3 /usr/lib/python2.7/site-packages/salt/modules/ps.pyt get_usersa s&
'
!
c C@ s@ t j | � } t d d | � } g } | j | | g � | S( u�
Retrieve the lsof information of the given process name.
CLI Example:
.. code-block:: bash
salt '*' ps.lsof apache2
u cmd.runu lsof -c ( R t text_typet __salt__t extend( R t
sanitize_namet
lsof_infost ret( ( s3 /usr/lib/python2.7/site-packages/salt/modules/ps.pyt lsof� s
u netstatc C@ s~ t j | � } t d d � } g } g } x9 | j � D]+ } | j | � d k r8 | j | � q8 q8 W| j | | g � | S( u�
Retrieve the netstat information of the given process name.
CLI Example:
.. code-block:: bash
salt '*' ps.netstat apache2
u cmd.runu netstat -napi����( R R� R� t
splitlinest findR2 R� ( R R� t
netstat_infost found_infosR� R@ ( ( s3 /usr/lib/python2.7/site-packages/salt/modules/ps.pyt netstat� s u ssc C@ s~ t j | � } t d d � } g } g } x9 | j � D]+ } | j | � d k r8 | j | � q8 q8 W| j | | g � | S( u�
Retrieve the ss information of the given process name.
CLI Example:
.. code-block:: bash
salt '*' ps.ss apache2
.. versionadded:: 2016.11.6
u cmd.runu ss -neapi����( R R� R� R� R� R2 R� ( R R� t ss_infosR� R� R@ ( ( s3 /usr/lib/python2.7/site-packages/salt/modules/ps.pyt ss� s c C@ s� t j | � } t j | � } t j d � } t d d � } g } g } d } x[ | j � D]M } | j | � } | d k r\ | j | � s� | d 7} | j | � q� q\ q\ Wt j | � d }
g } | j | | |
g � | S( u
Retrieve information corresponding to a "ps aux" filtered
with the given pattern. It could be just a name or a regular
expression (using python search from "re" module).
CLI Example:
.. code-block:: bash
salt '*' ps.psaux www-data.+apache2
u salt.+ps.psaux.+u cmd.runu ps auxi i u occurence(s).N(
R R� t ret compileR� R� t searchR R2 R� ( R R� RO t salt_exception_patternt ps_auxR� R� t nb_linesR@ t foundt pid_count( ( s3 /usr/lib/python2.7/site-packages/salt/modules/ps.pyt psaux� s"
( ( i i (< t __doc__t
__future__R R R R' Rn R� t salt.utils.dataR
t salt.exceptionsR R t salt.utils.decorators.patht salt.extR t salt.utils.psutil_compatR t
psutil_compatR R
R t getattrR R� R R R R R R R R" RC RD R RI RL RT RV RX R% R\ R^ R_ Rb Re Rh Rk Rm Rx Rz R� R� t
decoratorsRc t whichR� R� R� ( ( ( s3 /usr/lib/python2.7/site-packages/salt/modules/ps.pyt <module> sX
>
7. # " !!
Mini Shell