ɧdMg , dZddlmZddlmZddlZddlZddlZddlZddlZddl Z ddl Z ddl Z ddl Z ddl Z ddlmZddl mZddl mZddl mZ dd l mZn #e$rdZYnwxYw dd l mZn #e$rdZYnwxYwe jd krddlZndZe jdd kZeejd dZgdZejdkZejdkZe j dZ!e j dZ"e"Z#e j dZ$e j dZ%e j dZ&e$pe%pe&Z'e j dZ(e j dZ)dZ*dZ+dZ,dZ-dZ.dZ/dZ0dZ1d Z2d!Z3d"Z4d#Z5d$Z6d%Z7d&Z8d'Z9d(Z:d)Z;d*Zd-Z?d.Z@d/ZAd0ZBd1ZCed2ZDd3ZEdZFn5Gd4d5ejGZHeIJeHjKed6ZLd7ZMn5Gd8d9ejGZNeIJeNjKe jOZPesd:ZQn" e jRZQn#eS$r erd;nd:ZQYnwxYwedgd?ZUed@gdAZVedBgdCZWedDgdEZXedFgdGZYedHgdIZZedJgdKZ[edLgdMZ\edNgdOZ]edPgdQZ^edRgdSZ_edTgdUZ`edVdWdXgZaedYgdZZbed[d\d]gZced^gd_Zded`gdaZeedbgdaZfedcgddZgededfdggZhedhdidjgZiedkgdlZjedmdndogZkeeegeegfeegegfegegfeegegfegegfeegeegfegeegfegeegfdpZle elJegegfegegfdqeelJdregeegfiGdsdtemZnGdudvenZoGdwdxeoZpGdydzenZqGd{d|enZrdd}Zsd~ZtdZudZvdZwetdZxdZydZzdZ{ddZ|dZ}GddZ~dZe~Zeje_eje_dZdZddZdZerdZndZete jfdZddZdde jfdZdZdS)z9Common objects shared by __init__.py and _ps*.py modules.)division)print_functionN) namedtuple)AF_INET) SOCK_DGRAM) SOCK_STREAM)AF_INET6)AF_UNIX)r PSUTIL_DEBUG)NFREEBSDBSDLINUXNETBSDOPENBSDMACOSOSXPOSIXSUNOSWINDOWS CONN_CLOSECONN_CLOSE_WAIT CONN_CLOSINGCONN_ESTABLISHEDCONN_FIN_WAIT1CONN_FIN_WAIT2 CONN_LAST_ACK CONN_LISTEN CONN_NONE CONN_SYN_RECV CONN_SYN_SENTCONN_TIME_WAITNIC_DUPLEX_FULLNIC_DUPLEX_HALFNIC_DUPLEX_UNKNOWN STATUS_DEADSTATUS_DISK_SLEEP STATUS_IDLE STATUS_LOCKEDSTATUS_RUNNINGSTATUS_SLEEPINGSTATUS_STOPPEDSTATUS_SUSPENDEDSTATUS_TRACING_STOPSTATUS_WAITINGSTATUS_WAKE_KILL STATUS_WAKING STATUS_ZOMBIE STATUS_PARKEDENCODING ENCODING_ERRSr pconn pcputimespctxswpgidspiopionice popenfilepthreadpuidssconn scpustatssdiskio sdiskpart sdiskusagesnetiosnicaddr snicstatssswapsuser conn_tmapdeprecated_method isfile_strictmemoizeparse_environ_blockpath_exists_strict usage_percent supports_ipv6sockfam_to_enumsocktype_to_enum wrap_numbers bytes2humanconn_to_ntupledebughiliteterm_supports_colors print_colorposixntlinuxdarwin)freebsd midnightbsdopenbsdnetbsd)sunossolarisaixrunningsleepingz disk-sleepstoppedz tracing-stopzombiedeadz wake-killwakingidlelockedwaiting suspendedparked ESTABLISHEDSYN_SENTSYN_RECV FIN_WAIT1 FIN_WAIT2 TIME_WAITCLOSE CLOSE_WAITLAST_ACKLISTENCLOSINGNONEceZdZdZdZdZdS) NicDuplexr}r~rN)__name__ __module__ __qualname__r$r%r&.lib/python3.11/site-packages/psutil/_common.pyrrs rrceZdZdZdZdS) BatteryTimerrN)rrrPOWER_TIME_UNKNOWNPOWER_TIME_UNLIMITEDrrrrrs!rrreplacesurrogateescaperH)totalusedfreepercentsinsoutrD)rrrrrB) read_count write_count read_bytes write_bytes read_time write_timerC)device mountpointfstypeoptsmaxfilemaxpathrE) bytes_sent bytes_recv packets_sent packets_recverrinerroutdropindropoutrI)nameterminalhoststartedpidr@)fdfamilytypeladdrraddrstatusrrF)raddressnetmask broadcastptprG)isupduplexspeedmturA) ctx_switches interruptssoft_interruptssyscallsscpufreq)currentminmaxshwtemp)labelrhighcriticalsbattery)rsecsleft power_pluggedsfanrrr8)usersystem children_userchildren_systemr=pathrr>)id user_time system_timer?)real effectivesavedr:r;)rrrrr<ioclassvaluer9 voluntary involuntaryr7)rrrrrraddripport)alltcptcp4udpudp4inetinet4inet6)tcp6udp6unixc(eZdZdZdZdZdZdZdS)ErrorzQBase exception class. All other psutil exceptions inherit from this one. psutilc tj}n#t$ri}YnwxYw|D]}t||d}|r|||<|SN) collections OrderedDictAttributeErrorgetattr)selfattrsinforrs r _infodictzError._infodictsr *,,DD   DDD  # #DD$--E #"T  s  %%c|d}|r5ddd|Dz}nd}dd|j|fDS)N)rppidrz(%s), c"g|] \}}|d| S=r.0kvs r z!Error.__str__..)s';;;daAAAqq!;;;r cg|]}||Srr)rxs rrz!Error.__str__..,s===q1====r)rjoinitemsmsgrrdetailss r__str__z Error.__str__$s~~566  tyy;;djjll;;; = ==GGGxx==TXw$7===>>>rc|d}dd|D}d|jjd|dS)N)rrrsecondsrrc"g|] \}}|d| Srrrs rrz"Error.__repr__..1s'GGG$!Q11-GGGrzpsutil.())rrr __class__rrs r__repr__zError.__repr__.sX~~GHH))GG$**,,GGGHH"&."9"9"9777CCrN)rrr__doc__rr rrrrrrsWJ   ???DDDDDrrceZdZdZdZddZdS) NoSuchProcesszXException raised when a process with a certain PID doesn't or no longer exists. rNcht|||_||_|pd|_dS)Nzprocess no longer existsr__init__rrrrrrrs rrzNoSuchProcess.__init__;s3 t 44rNNrrrrrrrrrr5s9J555555rrceZdZdZdZddZdS) ZombieProcessa1Exception raised when querying a zombie process. This is raised on macOS, BSD and Solaris only, and not always: depending on the query the OS may be able to succeed anyway. On Linux all zombie processes are querable (hence this is never raised). Windows doesn't have zombie processes. rNc`t||||||_|pd|_dS)Nz"PID still exists but it's a zombie)rrrr)rrrrrs rrzZombieProcess.__init__Ks4tS$444 >>rNNNrrrrrrBs9 J??????rrceZdZdZdZddZdS) AccessDeniedz@Exception raised when permission to perform an action is denied.rNcht|||_||_|pd|_dS)Nrrs rrzAccessDenied.__init__Us1 t 9"rrrrrrrrQs3JJJrrceZdZdZdZddZdS)TimeoutExpiredzWRaised on Process.wait(timeout) if timeout expires and process is still alive. rNcxt|||_||_||_d|z|_dS)Nztimeout after %s seconds)rrr rrr)rr rrs rrzTimeoutExpired.__init__bs9 t  -7rrrrrrr#r#\s9J888888rr#cx t||z dz}|t||}|S#t$rYdSwxYw)z5Calculate percentage usage of 'used' against 'total'.dNg)floatroundZeroDivisionError)rrround_rets rrPrPos^T{{U"c)  %V$$C sss + 99cftjfd}fd}i||_|S)aA simple memoize decorator for functions supporting (hashable) positional arguments. It also provides a cache_clear() function for clearing the cache: >>> @memoize ... def foo() ... return 1 ... >>> foo() 1 >>> foo.cache_clear() >>> c|tt|f} |S#t$r|i|x}|<|cYSwxYwr) frozensetsortedrKeyError)argskwargskeyr+cachefuns rwrapperzmemoize..wrappersuYvfllnn55667 :    "sD3F33 3C%*JJJ s;AAc0dS)z Clear cache.N)clear)r4sr cache_clearzmemoize..cache_clears r) functoolswrapsr9)r5r6r9r4s` @rrMrM{sf_S E%G Nrcntjfd}d}d}||_||_|S)aA memoize decorator which is disabled by default. It can be activated and deactivated on request. For efficiency reasons it can be used only against class methods accepting no arguments. >>> class Foo: ... @memoize ... def foo() ... print(1) ... >>> f = Foo() >>> # deactivated (default) >>> foo() 1 >>> foo() 1 >>> >>> # activated >>> foo.cache_activate(self) >>> foo() 1 >>> foo() >>> foo() >>> c |j}nM#t$r|cYSt$r*|} ||j<n#t$rYnwxYwYnwxYw|Sr)_cacherr0)rr+r5s rr6z'memoize_when_activated..wrappers +c"CC   3t99      #d))C #& C  !      s7 AA AA AAAAAci|_dS)zjActivate cache. Expects a Process instance. Cache will be stored as a "_cache" instance attribute.N)r>procs rcache_activatez.memoize_when_activated..cache_activates rc. |`dS#t$rYdSwxYw)zDeactivate and clear cache.N)r>rr@s rcache_deactivatez0memoize_when_activated..cache_deactivates2      DD s  )r:r;rBrD)r5r6rBrDs` rmemoize_when_activatedrEsh4_S& ,G/G Nrc tj|}tj|jS#t$r+}|jt jt jfvrYd}~dSd}~wwxYw)zSame as os.path.isfile() but does not swallow EACCES / EPERM exceptions, see: http://mail.python.org/pipermail/python-dev/2012-June/120787.html NF)osstatS_ISREGst_modeOSErrorerrnoEPERMEACCES)rsterrs rrLrLsq ( WT]] |BJ'''  9el3 3  uuuuus/ A$ AA$c tj|dS#t$r+}|jtjtjfvrYd}~dSd}~wwxYw)zSame as os.path.exists() but does not swallow EACCES / EPERM exceptions, see: http://mail.python.org/pipermail/python-dev/2012-June/120787.html TNF)rGrHrKrLrMrN)rrPs rrOrOsd   t  9el3 3  uuuuus A  AA c(tjrtdS tjttj}t j|5|ddddn #1swxYwYdS#tj$rYdSwxYw)z2Return True if IPv6 is supported on this platform.NF)z::1rT)sockethas_ipv6r r contextlibclosingbinderror)socks rrQrQs ?hu}Xv'9::   % % " " IIj ! ! ! " " " " " " " " " " " " " " "t <uus58A>A1% A>1A55A>8A59A>>BBci}d}t} |d|}||krnU|d||}||kr2|||}||dz|}|r|}|||<|dz}r|S)zCParse a C environ block of environment variables into a dictionary.rTrr~)rfindupper)datar+posWINDOWS_next_pos equal_posr3rs rrNrNs C CH99T3'' s?  IIc311 s? s9}%CQx/0E "iikkCHl Jrcbt|S tj|S#t$r|cYSwxYw)zConvert a numeric socket family value to an IntEnum member. If it's not a known member, return the numeric value itself. )enumrS AddressFamily ValueErrornums rrRrR"sK   ',, ,   JJJ   ..cbt|S tj|S#t$r|cYSwxYw)zConvert a numeric socket type value to an IntEnum member. If it's not a known member, return the numeric value itself. )rdrS SocketKindrfrgs rrSrS/sK   $S)) )   JJJ ric p|tjtfvr|r t|}|r t|}|tjkr,|ttfvr||t }nt }t|}t|}|t||||||St|||||||S)z2Convert a raw connection tuple to a proper ntuple.) rSrr rrgetr rRrSr7r@)rfamtype_rrr status_maprs rrVrV<s v~x((!  !%LE  !%LE ""sw.A'A 22 #  C U # #E @ReUE6:::ReUE63???rcfd}|S)zA decorator which can be used to mark a method as deprecated 'replcement' is the method name which will be called instead. c|jdd|j|_tj|fd}|S)Nz*() is deprecated and will be removed; use z () insteadchtjtdt||i|S)Nr})category stacklevel)warningswarnDeprecationWarningr)rr1r2r replacements rinnerz/deprecated_method..outer..innerYs: M#(:q I I I I-74--t>v>> >r)rrr:r;)r5rzrrys @routerz deprecated_method..outerSse LLL+++' ; CK    ? ? ? ? ?   ? rr)ryr{s` rrKrKOs#      Lrc8eZdZdZdZdZdZdZd dZdZ dS) _WrapNumberszNWatches numbers so that they don't overflow and wrap (reset to zero). c`tj|_i|_i|_i|_dSr) threadingLocklockr4 reminders reminder_keysrs rrz_WrapNumbers.__init__fs-N$$  rc||jvsJ||jvsJ||jvsJ||j|<tjt |j|<tjt |j|<dSr)r4rrr defaultdictintset)r input_dictrs r _add_dictz_WrapNumbers._add_dictls}4:%%%%4>))))4-----% 4*6s;;t#.#:3#?#?4   rc|j|}t|t|z }|D]4}|j||D]}|j||=|j||=5dS)zIn case the number of keys changed between calls (e.g. a disk disappears) this removes the entry from self.reminders. N)r4rkeysrr)rrrold_dict gone_keysgone_keyremkeys r_remove_dead_remindersz#_WrapNumbers._remove_dead_remindersts:d# ((3z/@/@+A+AA ! 3 3H,T28< 1 1N4(00"4(22 3 3rc||jvr||||S||||j|}i}|D]}||} ||}n#t$r|||<Y%wxYwg}t t |D]} || } || } || f} | | krA|j|| xx| z cc<|j|| | | | |j|| zt|||<||j|<|S)zkCache dict and sum numbers which overflow and wrap. Return an updated copy of `input_dict` ) r4rrrr0rangelenrraddappendtuple) rrrrnew_dictr3 input_tuple old_tuplebitsi input_value old_valuers rrunz_WrapNumbers.runs tz !  NN:t , , ,  ##J555:d#??$$ ( (C$S/K $SM    !,    D3{++,, H H)!n %aL q*>N4(000I=000&t,S155f=== K$.*>v*FFGGGG!$KKHSMM% 4s&A//BBNc|j5|L|j|j|jnQ|j|d|j|d|j|dddddS#1swxYwYdS)z>Clear the internal cache, optionally only for function 'name'.N)rr4r8rrpop)rrs rr9z_WrapNumbers.cache_clears Y 3 3 3   """$$&&&"((**** tT***""4..."&&tT222 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3sB B55B9<B9cl|j5|j|j|jfcdddS#1swxYwYdS)z5Return internal cache dicts as a tuple of 3 elements.N)rr4rrrs r cache_infoz_WrapNumbers.cache_infos Y D DJ0BC D D D D D D D D D D D D D D D D D Ds )--r) rrrrrrrrr9rrrrr}r}as   @@@ 3 3 3%%%N 3 3 3 3DDDDDrr}ctj5t||cdddS#1swxYwYdS)zGiven an `input_dict` and a function `name`, adjust the numbers which "wrap" (restart from zero) across different calls by adding "old value" to "new value" and return an updated dict. N)_wnrr)rrs rrTrTs ))wwz4(())))))))))))))))))s 599c t|dfi|S)Nrb)openfnamer2s r open_binaryrs t & &v & &&rc tr6|dt|dtt |dfi|S)zOn Python 3 opens a file in text mode by using fs encoding and a proper en/decoding errors handler. On Python 2 this is just an alias for open(name, 'rt'). encodingerrorsrt)PY3 setdefaultr5r6rrs r open_textrsR  3 *h///(M222 t & &v & &&r%(value).1f%(symbol)sc6d}i}t|ddD]\}}d|dzdzz||<t|ddD]9}|||kr+t|||z }|tzcS:|t |d|zS)zUsed by various scripts. See: http://goo.gl/zeJZl >>> bytes2human(10000) '9.8K' >>> bytes2human(100001221) '95.4M' ) BKMGTPEZYr~N r)symbolr) enumeratereversedr'localsdict)nformatsymbolsprefixrsrrs rrUrUs   !"" "" KK  C"%((4....!!! 44s : r) r inspect getframeinfo currentframef_back isinstancerrKIOErrorEnvironmentErrorrrr)rrrlineno func_namelinesindexs rrWrWCs 181E1E  " " )2+2+.vy% c9 % % *#2BCDD *#c)#c) EEE66633?:        rr)r)NF)r __future__rrrrUrLr:rGrSrHrrrvrrrrr ImportErrorr version_infordrboolgetenvr __all__rrrplatform startswithrrrrrrrrAIXr+r,r(r-r/r3r'r1r2r)r*r0r.r4rr"r!rrr#rrrrrr r$r%r&IntEnumrglobalsupdate __members__rrrgetfilesystemencodingr5r6getfilesystemencodeerrorsrrHrDrBrCrErIr@rFrGrArrrrr8r=r>r?r:r;r<r9r7rrJrrrrrr#rPrMrErLrOrQrNrRrSrVrKr}rTrr9rrrrUrrstdoutrYrXrZrWrrrr#s  @?  %%%%%%  """"""HHHGGGvKKKK D qQtIBIna0011    H 7 'T/ (( ))  , ! !"< = = , ! !) , ,   * * ""F  455 le$$ $      !         ,OODL  GIIY*+++."""""dl""" GII[,--- %3 $ & & BMMB5577 BBB-2A)) B  7%%% & &Z &J&J&J K K *Y!<!<!< = = J{%;%;%; < <  H444 5 5  7JJJKK 7... / / :jJJJ L L J{$F$F$F G G JNNN P P  :j";";"; < < * 777 9 9 :j"J"J"J K Kz&7I.// J{MMM O O  J{VTN 3 3 *Y B B B C C 7:::;; 7:::;;j66677 *YG 4 5 5 H{M: ; ; 7''' ( (z&4.))h (; *C D h + /Y & h * .Y %x ; "; <i+z2 3j; 3 4     k]+j\*   '[*56DDDDDIDDDD 5 5 5 5 5E 5 5 5 ? ? ? ? ?M ? ? ?5 8 8 8 8 8U 8 8 8&    @<<<~ ( ( (        8      @@@@&$TDTDTDTDTDTDTDTDn)))lnn? . ''' ' ' '5555(--- AAAA !j     5555(E  ; ; ; ;F     s6AA! A!%A,,A65A6I!! I/.I/