
실행 중인 Python 프로세스에 코드 주입
.. image:: https://raw.githubusercontent.com/lmacken/pyrasite/develop/docs/logo.png
.. image:: https://github.com/lmacken/pyrasite/actions/workflows/ci.yml/badge.svg?branch=develop :target: https://github.com/lmacken/pyrasite/actions/workflows/ci.yml .. image:: https://img.shields.io/pypi/v/pyrasite?style=flat :target: https://pypi.org/project/pyrasite/
실행 중인 Python 프로세스에 임의의 코드를 주입하기 위한 도구입니다.
:homepage: https://github.com/lmacken/pyrasite :documentation: https://pyrasite.readthedocs.io/ :download: https://pypi.org/project/pyrasite/ :source: https://github.com/lmacken/pyrasite :issues: https://github.com/lmacken/pyrasite/issues
요구 사항
* `gdb <https://www.gnu.org/s/gdb>`_ (버전 7.3 이상)
* ptrace 정책이 대상 프로세스에 연결(attach)하는 것을 허용하는 Linux 시스템.
아래의 `ptrace_scope`를 참고하십시오.
설치
::
pipx install pyrasite
또는 선택적 메모리 뷰어의 경우::
pip install "pyrasite[memory-viewer]"
호환성
Pyrasite는 CPython 3.9부터 3.15까지에서 실행됩니다. 주입은 서로 다른 버전
간에도 동작하므로, 한 Python에서 Pyrasite를 실행하고 다른 버전에서 실행 중인
프로세스에 주입할 수 있습니다. pyrasite 클라이언트와 대상 프로세스 모두
CPython이어야 합니다.
ptrace_scope
~~~~~~~~~~~~
최근 Linux 배포판은 프로세스가 자신의 조상 프로세스에 의해서만 연결될 수
있도록 ptrace를 제한합니다. ``/proc/sys/kernel/yama/ptrace_scope``가 0이
아니면 경고가 표시됩니다. 전역적으로 연결을 허용하거나::
echo 0 | sudo tee /proc/sys/kernel/yama/ptrace_scope
대상 프로세스가 ``prctl(PR_SET_PTRACER, PR_SET_PTRACER_ANY)``를 호출하여
직접 허용하도록 할 수 있습니다. Fedora에서는 SELinux에 다음이 추가로 필요할
수 있습니다::
sudo setsebool -P deny_ptrace=off
멀티스레드 프로그램의 경우 pyrasite는 ``Py_AddPendingCall``로 페이로드를
큐에 넣어 이미 GIL을 보유한 스레드에서 실행되도록 합니다. 대상이 C 코드에서
블록되어 Python 바이트코드를 전혀 실행하지 않는 경우에는 대신
``--inject-method direct``를 사용하십시오.
사용법
~~~~~
::
pyrasite <pid> hello.py
pyrasite <pid> - <<'EOF'
import sys
print(sys.version)
EOF
pyrasite <pid> <(echo 'print("hello")')
페이로드는 pyrasite 프로세스가 읽어 gdb 명령에 포함시키므로, 대상 프로세스가
페이로드 파일에 대한 읽기 권한을 가질 필요가 없습니다. 따라서 파이프와
프로세스 치환도 동작합니다. 표준 페이로드는 이름으로 선택할 수 있습니다
(``pyrasite --list-payloads`` 참고).
테스트
~~~~~~~
::
pip install -e ".[dev]"
pytest
ruff check .
ruff format --check .
`uv <https://docs.astral.sh/uv/>`_를 사용하여 지원되는 모든 인터프리터에 대해
테스트 스위트를 실행하려면::
uv python install 3.9 3.10 3.11 3.12 3.13 3.14 3.15
tox
한 인터프리터에서 다른 모든 인터프리터로의 주입을 테스트하려면 pytest를
실행하기 전에 ``PYRASITE_TEST_INTERPRETERS``를 콜론으로 구분된 인터프리터
경로 목록으로 설정하십시오.
pyrasite-gui
~~~~~~~~~~~~
그래픽 인터페이스는 https://github.com/lmacken/pyrasite-gui 에서 별도로
유지 관리됩니다.
저자
~~~~~~~
`Luke Macken <https://twitter.com/lmacken>`_이
`David Malcolm <https://dmalcolm.livejournal.com>`_과 다수의
`기여자 <https://github.com/lmacken/pyrasite/contributors>`_의 도움을 받아
제작했습니다.
로고는 `Adam Saunders <https://fedorahosted.org/design-team/ticket/214>`_가
제작했습니다.
라이선스
~~~~~~~~
코드
^^^^
.. image:: https://www.gnu.org/graphics/gplv3-127x51.png
:target: https://www.gnu.org/licenses/gpl.txt
로고
^^^^
.. image:: https://creativecommons.org/images/deed/nolaw.png
:target: https://creativecommons.org/publicdomain/zero/1.0/