VhddlmZdZddlZddlZddlZddlZddlmZddl m Z ddl m Z ddl mZmZmZddlmZmZdd lmZeZGd d eZy) ) annotationsa author: Ansible Core Team name: jail short_description: Run tasks in jails description: - Run commands or put/fetch files to an existing jail. options: remote_addr: description: - Path to the jail. type: string default: inventory_hostname vars: - name: inventory_hostname - name: ansible_host - name: ansible_jail_host remote_user: description: - User to execute as inside the jail. type: string vars: - name: ansible_user - name: ansible_jail_user N) AnsibleError) shlex_quote) get_bin_path)to_bytes to_nativeto_text)ConnectionBaseBUFSIZE)DisplayceZdZdZdZdZdZdZfdZe dZ dZ fd Z e jfd Zdfd Ze d Zfd ZfdZfdZxZS) Connectionz" Local BSD Jail based connections conn_jail_namezcommunity.general.jailTFctt| ||g|i||jj|_|j |vr||j |_tjdk7r td|jd|_ |jd|_ |j |jvrtd|j y)Nrz(jail connection requires running as rootjlsjexeczincorrect jail name )superr__init__ _play_context remote_addrjailmodified_jailname_keyosgeteuidr_search_executablejls_cmd jexec_cmd list_jails)self play_context new_stdinargskwargs __class__s m/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/community/general/plugins/connection/jail.pyrzConnection.__init__?s j$(yR4R6R&&22  % % /t99:DI ::<1 IJ J..u5 009 99DOO- -!5dii[AB B .cP t|S#t$rt|dwxYw)Nz command not found in PATH)r ValueErrorr) executables r%rzConnection._search_executableOs7 J + + J*-GHI I Js %ctj|jddgtjtjtj}|j \}}t |dj S)Nz-qname)stdinstdoutstderrsurrogate_or_stricterrors) subprocessPopenrPIPE communicater split)rpr-r.s r%rzConnection.list_jailsVs\   dllD&9#-??$.OOJOO Mv&;<BBDDr&ctt| |js@tj d|j j|jd|_yy)z) connect to the jail; nothing to do here z$ESTABLISH JAIL CONNECTION FOR USER: hostTN) rr_connect _connecteddisplayvvvr remote_userrrr$s r%r;zConnection._connect_sO j$(* KK>t?Q?Q?]?]>^_fjfofoK p"DOr&c|jg}d}|jj5|d|jjgz }d|jjd}||j|jjd||zgz }t j d||j|Dcgc]}t|d }}tj|d |tjtj }|Scc}w) a- run a command on the jail. This is only needed for implementing put_file() get_file() so that we don't have to read the whole file into memory. compared to exec_command() it looses some niceties like being able to return the process's exit code immediately. z-UzHOME=~ z-czEXEC r9r/r0F)shellr,r-r.) rrr?rr)r=r>rr2r3r4)rcmdr, local_cmdset_envir7s r%_buffered_exec_commandz!Connection._buffered_exec_commandfs^^$     ) ) 5 $ 2 2 > >? ?It11==>a@Gdii!3!3!>!>gPSmTT  eI;'dii 8HQR1Xa(=>R R   Ye5$.OOJOO M Ss-C;ctt| ||||j|}|j |\}}|j ||fS)z run a command on the jail )in_datasudoable)rr exec_commandrIr5 returncode)rrErKrLr7r-r.r$s r%rMzConnection.exec_commandsL j$,S'H,U  ' ' ,w/||VV++r&c|jtjjs8tjj tjj|}tjj |S)a Make sure that we put files into a standard path If a path is relative, then we need to choose where to put it. ssh chooses $HOME but we aren't guaranteed that a home dir will exist in any given chroot. So for now we're choosing "/" instead. This also happens to be the former default. Can revisit using $HOME instead if it is a problem ) startswithrpathsepjoinnormpath) remote_paths r%_prefix_login_pathzConnection._prefix_login_pathsK%%bggkk2'',,rww{{K@Kww ,,r&c tt| ||tj d|d||j t |j|} tt|dd5}tj|jjsd}nd} |jd |d t|| } |j%\}}|j,dk7r)t#d |d|dt/|dt/| dddy#t $r t#d wxYw#t&$r&t)j*t#d |d|wxYw#1swYyxYw#t0$rt#d|wxYw)z$ transfer a file from local to jail zPUT  TO r9r/r0rbz count=0rBzdd of= bs=)r,/jail connection requires dd command in the jailfailed to transfer file  to r:  Nz"file or module does not exist at: )rrput_filer=r>rrrVopenrrfstatfilenost_sizerIr OSErrorrr5 Exception traceback print_excrNrIOError) rin_pathout_pathin_filecountr7r-r.r$s r%r`zConnection.put_files j$((; d7)4z2 Ct66x@A Ohw/DEtL FPWxx 0199&EEZ33fXJd7)TYSZ4[cj3kA[%&]]_NFF<<1$&)A'$xjX[\efl\m[nnpqz|BrCqD(EFF% F FZ&'XYYZ!['')&)A'$xj'YZZ[ F F  O!CG9MN N OsTE./3E"#DD08E"E.D--E"0/EE""E+'E.+E..Fc tt| ||tj d|d||j t |j|} |jd|dt}tt|dd 5} |jjt}|r3|j!||jjt}|r3|j)\}}|j*d k7r)td |d |d t-|dt-| dddy#t$r tdwxYw#t"$r&t%j&td |d |wxYw#1swYyxYw)z! fetch a file from jail to local zFETCH rXr9zdd if=rZr[r/r0zwb+r\r]rr^r_N)rr fetch_filer=r>rrrVrIr rerrarr-readwriterfrgrhr5rNr) rrjrkr7out_filechunkr-r.r$s r%rozConnection.fetch_files j$*7H= fWIT(4499 Ed55g>? R++fWIT',KLA(8,ABE J Bh W g.NN5)HHMM'2E ]]_NFF||q "%=gYd8*TWXabhXiWjjlmvw}m~l$ABB! B B RPQ Q R W##%"%=gYd8*#UVV W B Bs2D5 E? AE  A E?5E  /E<<E??Fc8tt| d|_y)z. terminate the connection; nothing to do here FN)rrcloser<r@s r%ruzConnection.closes j$%'r&)NF)__name__ __module__ __qualname____doc__r transporthas_pipelininghas_ttyr staticmethodrrr;r2r4rIrMrVr`roru __classcell__)r$s@r%rr4s,,(INGC JJ E#1;4, - -O4B0  r&r) __future__r DOCUMENTATIONros.pathr2rgansible.errorsransible.module_utils.six.movesr#ansible.module_utils.common.processr+ansible.module_utils.common.text.convertersrrr ansible.plugins.connectionr r ansible.utils.displayr r=rr&r%rsI# 2 '6<TT>) )Y Y r&