+ GiD8cs^RIt^RIt^RIt^RIt^RIt^RIt^RIt^RIt^RIt RRlt Rt RRlt RRlt RRltRtRtRR ltRR ltR tR tR tRRltR#)iNcs.ROpW9d\R\V4,4hVeVR8Xd \R4hV'dVR9d\RV,4hR#R#)zx Raise an exception if the parameters passed to core() don't make sense (all parameters are described in core() below). backgroundzInvalid output value: Nz'Can't use check with output: backgroundz%Can't use output_return with output: )logstdout interactivetuirpipe)rr) RuntimeErrorstr)output output_returncheckZvals&&& +/usr/lib/waydroid/tools/helpers/run_core.py sanity_checksr sc ID 3c&kABB  V|3DEE#88BVKLL9}c sT;_uu_4\VPR4F7p\P!WP RR7P 44K9 RRR4R# +'giR#;i)rreplaceZerrorsN)Ziterreadlineloggingrdecoderstrip)rZlevelZline&& r forward_streamr&sH ,D KK{{){<CCE F- s AA'' A8 cs\P!V\P\PVR7p\P!\ VP \P3RR7P4\P!\ VP\P3RR7P4\P!RPVP44V#)zCRun a subprocess in background and redirect its output to the log. rstderrcwdTZtargetargsdaemonz1New background process: pid={}, output=background) subprocessPopenPIPE threadingThreadrrrDEBUGstartrdebugformatpid)rcmd working_dirprocr r rr,s   C   + -D N$++w}}1MVZ[aac N$++w}}1MVZ[aac MMELLTXXVW Krcsb\P!V\P\PVR7p\P!\ \ P\P3RR7P4\P!RPVP44V#)zBRun a subprocess in background and redirect its output to a pipe. rTrz+New background process: pid={}, output=pipe)rrrr r!rr)rrr"r#verboser%r&)rr'r(retr r rr6sm   3zz* ,C N$++w}}1MVZ[aac OOAHHQR JrcsVPP4p\V4'd\P!VP RR7P 44V'd*\PPPV4V'dVPV4KV'd\PP4R#)a  Read all available output from a subprocess and copy it to the log and optionally stdout and a buffer variable. This is only meant to be called by foreground_pipe() below. :param process: subprocess.Popen instance :param output_to_stdout: copy all output to waydroid's stdout :param output_return: when set to True, output_return_buffer will be extended :param output_return_buffer: list of bytes that gets extended with the current output in case output_return is True. rrN) rrlenrr$rrsysZbufferZwriteappendZflush)rprocessoutput_to_stdoutr Zoutput_return_bufferZouts&&&&& r pipe_readr1?s nn%%' s88 MM#**I*6==? @ !!'',$++C0   JJ   rcsJV'd:\PPPVRR\ V4.RR7M8\PPP VRR\ V4.RR7VF#wrEV\ V48XgK\ WW#4K% R#)z Recursively kill a pid and its child processes :param pid: process id that will be killed :param ppids: list of process id and parent process id tuples (pid, ppid) :param sudo: use sudo to kill the process Zkillz-9F)r N)toolsZhelpersrunZrootrZuserkill_process_tree)rr&ppidssudoZ child_pidZ child_ppids&&&& r r4r4^s  tfdCH%=#(  *  tfdCH%=#(  *$) S ! du ;$)rcs.ROp\P!VR\PR7p.pVPP R4P 4P R4R,pVFFpVP 4p\V4^8wd\RV,4hVPV4KH \WWR4R#) z Kill a command process and recursively kill its child processes :param pid: process id that will be killed :param sudo: use sudo to kill the process T)r rutf-8Z :iNNzUnexpected ps output: N)Zpsz-ez-ozpid,ppid) rr3rrrrZsplitr,rr.r4) rr&r6r'r+r5Z proc_entriesZrowZitemss &&& r kill_commandr8rs )C ..D AC E::$$W-446< > U  d-rcsV\P!V\P\PVR7pVPP 4p\ P !V\ P4p \ P !V\ PV \P,4.p \P!4p V PVP\P4V'd VPMRp VP!4fV'd\"P$!4MRp V P'V 4V'd\"P$!4pW, VP8df\(P*!R\-VP4,R,4\(P*!R4\/WP0V4K\3WW4V 4K\3WW4V 4VP4RP7V 4P9R43#)a# Run a subprocess in foreground with redirected output and optionally kill it after being silent for too long. :param cmd: command as list, e.g. ["echo", "string with spaces"] :param working_dir: path in host system where the command should run :param output_to_stdout: copy all output to waydroid's stdout :param output_return: return the output of the whole program :param output_timeout: kill the process when it doesn't print any output after a certain time (configured with --timeout) and raise a RuntimeError exception :param sudo: use sudo to kill the process when it hits the timeout :returns: (code, output) * code: return code of the program * output: "" * output: full program output string (output_return is True) rNz%Process did not write any output for z seconds. Killing it.z6NOTE: The timeout can be increased with 'waydroid -t'.rr7)rrrZSTDOUTrZfilenofcntlZF_GETFLZF_SETFLosZ O_NONBLOCK selectorsZDefaultSelectorZregisterZ EVENT_READtimeoutZpolltimeZ perf_counterZselectrinforr8r&r1Z returncodeZjoinr)rr'r(r0r output_timeoutr6r/ZhandleZflagsZ output_bufferZselr<Z wait_startZwait_ends&&&&&&& r foreground_piper@s*s:??&0&7&7[JG^^ " " $F KK .E KK ur}}'<=M  # # %CLL!5!56,dll$G ,,. ,:T&&(  7 ((*H$ 4 D ./1HIJ /0T;;5 $!1 !d-mL    7 > >w G HHrcs|\P!R4\P!WR7pVP 4#)z Run a subprocess in foreground without redirecting any of its output. This is the only way text-based user interfaces (ncurses programs like vim, nano or the kernel's menuconfig) work properly. z9*** output passed to waydroid stdout, not to this log ***)r)rr$rrwait)r'r(r/rr foreground_tuirBs1 MMs4G <<>rcsV'dP\P!R4\P!RVP,4\ RV,4hR#)a] Check the return code of a command. :param code: exit code to check :param log_message: simplified and more readable form of the command, e.g. "(native) % echo test" instead of the full command with entering the chroot and more escaping :raises RuntimeError: when the code indicates that the command failed zINOTE: The failed command's output is above the ^^^ line in the log file: zCommand failed: NzF^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^)rr$r>rr)rcode log_messages&&&r check_return_coderEsF  h *,0HH5 6- ;<<  rcs\P!RR.4P4\P!^<\ R7pRVnVP4R#)z: Run sudo -v and schedule a new timer to repeat the same. r6z-v)ZintervalZfunctionTN)rrrAr ZTimersudo_timer_iteraterr#)Ztimers r rFrFs@ fd^$))+ OOR2D EEEL KKMrcs^RVP9dR#RVPR&\4R#)zW Start a timer to call sudo -v periodically, so that the password is only needed once. Zsudo_timer_activeNT)ZcacherF)rs&r sudo_timer_startrGs( djj(&*DJJ"#rc s\WEV4VP'dV'd \V4\P!V4\P !R\ V4,4VR8Xd \WV4#VR8Xd \WV4#Rp VR8Xd \W#4p MCRp VP'g VR9dRp VR 9;'dV'*p \WVV VV V4wrVRJd \W V4V'dV #T #) a Run a command and create a log entry. This is a low level function not meant to be used directly. Use one of the following instead: tools.helpers.run.user(), tools.helpers.run.root(), tools.chroot.user(), tools.chroot.root() :param log_message: simplified and more readable form of the command, e.g. "(native) % echo test" instead of the full command with entering the chroot and more escaping :param cmd: command as list, e.g. ["echo", "string with spaces"] :param working_dir: path in host system where the command should run :param output: where to write the output (stdout and stderr) of the process. We almost always write to the log file, which can be read with "waydroid log" (output values: "log", "stdout", "interactive", "background"), so it's easy to trace what waydroid does. The exceptions are "tui" (text-based user interface), where it does not make sense to write to the log file (think of ncurses UIs, such as "menuconfig") and "pipe" where the output is written to a pipe for manual asynchronous consumption by the caller. When the output is not set to "interactive", "tui", "background" or "pipe", we kill the process if it does not output anything for 5 minutes (time can be set with "waydroid --timeout"). The table below shows all possible values along with their properties. "wait" indicates that we wait for the process to complete. output value | timeout | out to log | out to stdout | wait ----------------------------------------------------------- "log" | x | x | | x "stdout" | x | x | x | x "interactive" | | x | x | x "tui" | | | x | x "background" | | x | | "pipe" | | | | :param output_return: in addition to writing the program's output to the destinations above in real time, write to a buffer and return it as string when the command has completed. This is not possible when output is "background", "pipe" or "tui". :param check: an exception will be raised when the command's return code is not 0. Set this to False to disable the check. This parameter can not be used when the output is "background" or "pipe". :param sudo: use sudo to kill the process when it hits the timeout. :returns: * program's return code (default) * subprocess.Popen instance (output is "background" or "pipe") * the program's entire output (output_return is True) zrun: rrZrFT)rr)rr) r Z sudo_timerrGrr$r*rrrrBZdetails_to_stdoutr@rE) rrDr'r(rr r r6Zdisable_timeoutZoutput_after_runrCr0r?s &&&&&&&&& r corerHst&/ 4 MM+ OOGc#h&'$[11D{++ c/!%%%&4M*M# #44LL_9L#24k3C3@3A37 $9  E$k2 - 6$6r)rFN)N)FFF)NFFTF)NrFNFF)r9rr;rr-r r=r:Ztools.helpers.runr2r rrrr1r4r8r@rBrErFrGrH)rr rIsm    M(G ><(.(=I@ =$  c7r