| FazBrowse GitHub Viewer | Trending | | Home |
| Tools: [Download Repo ZIP] [Original HTTPS Page] |
1 parent ba942ef commit e0fd3c0
31 files changed
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
@@ -11,7 +11,7 @@ msgid "" | |||
| 11 | 11 | msgstr "" | |
| 12 | 12 | "Project-Id-Version: Python 3.15\n" | |
| 13 | 13 | "Report-Msgid-Bugs-To: \n" | |
| 14 | - "POT-Creation-Date: 2026-09-03 17:25+0000\n" | ||
| 14 | + "POT-Creation-Date: 2026-09-23 18:03+0000\n" | ||
| 15 | 15 | "PO-Revision-Date: 2025-09-16 00:00+0000\n" | |
| 16 | 16 | "Last-Translator: python-doc bot, 2025\n" | |
| 17 | 17 | "Language-Team: Indonesian (https://app.transifex.com/python-doc/teams/5390/" | |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
@@ -11,7 +11,7 @@ msgid "" | |||
| 11 | 11 | msgstr "" | |
| 12 | 12 | "Project-Id-Version: Python 3.15\n" | |
| 13 | 13 | "Report-Msgid-Bugs-To: \n" | |
| 14 | - "POT-Creation-Date: 2026-09-03 17:25+0000\n" | ||
| 14 | + "POT-Creation-Date: 2026-09-23 18:03+0000\n" | ||
| 15 | 15 | "PO-Revision-Date: 2025-09-16 00:00+0000\n" | |
| 16 | 16 | "Last-Translator: python-doc bot, 2026\n" | |
| 17 | 17 | "Language-Team: Indonesian (https://app.transifex.com/python-doc/teams/5390/" | |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
@@ -11,7 +11,7 @@ msgid "" | |||
| 11 | 11 | msgstr "" | |
| 12 | 12 | "Project-Id-Version: Python 3.15\n" | |
| 13 | 13 | "Report-Msgid-Bugs-To: \n" | |
| 14 | - "POT-Creation-Date: 2026-09-05 16:26+0000\n" | ||
| 14 | + "POT-Creation-Date: 2026-09-25 18:08+0000\n" | ||
| 15 | 15 | "PO-Revision-Date: 2025-09-16 00:00+0000\n" | |
| 16 | 16 | "Last-Translator: python-doc bot, 2025\n" | |
| 17 | 17 | "Language-Team: Indonesian (https://app.transifex.com/python-doc/teams/5390/" | |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
@@ -11,7 +11,7 @@ msgid "" | |||
| 11 | 11 | msgstr "" | |
| 12 | 12 | "Project-Id-Version: Python 3.15\n" | |
| 13 | 13 | "Report-Msgid-Bugs-To: \n" | |
| 14 | - "POT-Creation-Date: 2026-09-11 17:24+0000\n" | ||
| 14 | + "POT-Creation-Date: 2026-09-25 18:08+0000\n" | ||
| 15 | 15 | "PO-Revision-Date: 2025-09-16 00:00+0000\n" | |
| 16 | 16 | "Last-Translator: python-doc bot, 2025\n" | |
| 17 | 17 | "Language-Team: Indonesian (https://app.transifex.com/python-doc/teams/5390/" | |
@@ -31,8 +31,8 @@ msgid "" | |||
| 31 | 31 | msgstr "" | |
| 32 | 32 | ||
| 33 | 33 | msgid "" | |
| 34 | - "Most platforms require elevated privileges to attach to another Python " | ||
| 35 | - "process." | ||
| 34 | + "Attaching to another Python process may require additional permissions or " | ||
| 35 | + "configuration, depending on the platform." | ||
| 36 | 36 | msgstr "" | |
| 37 | 37 | ||
| 38 | 38 | msgid "Disabling remote debugging" | |
@@ -56,56 +56,120 @@ msgid "Permission requirements" | |||
| 56 | 56 | msgstr "" | |
| 57 | 57 | ||
| 58 | 58 | msgid "" | |
| 59 | - "Attaching to a running Python process for remote debugging requires elevated " | ||
| 60 | - "privileges on most platforms. The specific requirements and troubleshooting " | ||
| 61 | - "steps depend on your operating system:" | ||
| 59 | + "Attaching to a running Python process for remote debugging requires special " | ||
| 60 | + "configuration on most platforms. The specific requirements and " | ||
| 61 | + "troubleshooting steps depend on your operating system:" | ||
| 62 | 62 | msgstr "" | |
| 63 | 63 | ||
| 64 | 64 | msgid "Linux" | |
| 65 | 65 | msgstr "" | |
| 66 | 66 | ||
| 67 | 67 | msgid "" | |
| 68 | - "The tracer process must have the ``CAP_SYS_PTRACE`` capability or equivalent " | ||
| 69 | - "privileges. You can only trace processes you own and can signal. Tracing may " | ||
| 70 | - "fail if the process is already being traced, or if it is running with set-" | ||
| 71 | - "user-ID or set-group-ID. Security modules like Yama may further restrict " | ||
| 72 | - "tracing." | ||
| 68 | + "In general, you can debug your own processes, but there are several common " | ||
| 69 | + "configurations that may disable this. Some Linux distributions enable " | ||
| 70 | + "**ptrace restrictions**, aka \"Yama,\" as a form of system hardening. Recent " | ||
| 71 | + "versions of the ``setpriv`` command (util-linux 2.41, released June 2025) " | ||
| 72 | + "let you loosen ptrace restrictions on a per-process basis:" | ||
| 73 | 73 | msgstr "" | |
| 74 | 74 | ||
| 75 | - msgid "To temporarily relax ptrace restrictions (until reboot), run:" | ||
| 75 | + msgid "``setpriv --ptracer any python3``" | ||
| 76 | + msgstr "" | ||
| 77 | + | ||
| 78 | + msgid "" | ||
| 79 | + "(This is configured on the process *being debugged*.) You can also turn off " | ||
| 80 | + "ptrace restrictions for all processes until reboot with:" | ||
| 76 | 81 | msgstr "" | |
| 77 | 82 | ||
| 78 | 83 | msgid "``echo 0 | sudo tee /proc/sys/kernel/yama/ptrace_scope``" | |
| 79 | 84 | msgstr "" | |
| 80 | 85 | ||
| 86 | + msgid "This can also be configured persistently, usually in ``/etc/sysctl.d``." | ||
| 87 | + msgstr "" | ||
| 88 | + | ||
| 81 | 89 | msgid "" | |
| 82 | 90 | "Disabling ``ptrace_scope`` reduces system hardening and should only be done " | |
| 83 | - "in trusted environments." | ||
| 91 | + "in low-security environments." | ||
| 92 | + msgstr "" | ||
| 93 | + | ||
| 94 | + msgid "" | ||
| 95 | + "It is also possible that the ``ptrace`` system call is disabled because of a " | ||
| 96 | + "security filter. In particular, this was common with older versions of some " | ||
| 97 | + "container software. Docker 19.03 or newer (released 2019) and containerd " | ||
| 98 | + "1.6.7 or newer (released 2022) will automatically allow usage of the " | ||
| 99 | + "``ptrace`` system call inside containers, when running on Linux kernel 4.8 " | ||
| 100 | + "or higher. If you cannot upgrade to these versions, you can create your " | ||
| 101 | + "container with an option like ``--security-opt seccomp=unconfined`` to " | ||
| 102 | + "disable the system call security filter for that container. This weakens the " | ||
| 103 | + "container's isolation and should only be done in low-security environments." | ||
| 84 | 104 | msgstr "" | |
| 85 | 105 | ||
| 86 | 106 | msgid "" | |
| 87 | - "If running inside a container, use ``--cap-add=SYS_PTRACE`` or ``--" | ||
| 88 | - "privileged``, and run as root if needed." | ||
| 107 | + "If you need to trace a process that you *do not* own, you will need " | ||
| 108 | + "superuser access or equivalent. This also applies to processes that have " | ||
| 109 | + "changed their security credentials, e.g., set-user-ID or set-group-ID " | ||
| 110 | + "processes (though this is unusual for Python). Try running the debugging " | ||
| 111 | + "command with ``sudo -E``." | ||
| 89 | 112 | msgstr "" | |
| 90 | 113 | ||
| 91 | - msgid "Try re-running the command with elevated privileges:" | ||
| 114 | + msgid "" | ||
| 115 | + "The ``CAP_SYS_PTRACE`` capability is equivalent to superuser access, in that " | ||
| 116 | + "it allows debugging *any* process, not just your own. You may see advice on " | ||
| 117 | + "the internet suggesting using it to work around ptrace restrictions or " | ||
| 118 | + "system call filters. This may work in practice, as would ``sudo``, but this " | ||
| 119 | + "gives the debugging process much more access than it needs and should only " | ||
| 120 | + "be done in low-security environments." | ||
| 92 | 121 | msgstr "" | |
| 93 | 122 | ||
| 94 | - msgid "``sudo -E !!``" | ||
| 123 | + msgid "" | ||
| 124 | + "Finally, note that a process can only have one tracer at a time. If you have " | ||
| 125 | + "already attached to a Python process under ``strace``, ``gdb``, etc., you " | ||
| 126 | + "won't be able to simultaneously use remote debugging. (Superuser access " | ||
| 127 | + "cannot get around this restriction.)" | ||
| 95 | 128 | msgstr "" | |
| 96 | 129 | ||
| 97 | 130 | msgid "macOS" | |
| 98 | 131 | msgstr "macOS" | |
| 99 | 132 | ||
| 133 | + msgid "By default, macOS disables the ability to debug other processes." | ||
| 134 | + msgstr "" | ||
| 135 | + | ||
| 136 | + msgid "" | ||
| 137 | + "You can modify your Python binary to opt in to being debugged by giving it " | ||
| 138 | + "an **ad-hoc code signature** with an **entitlement** enabling it to be " | ||
| 139 | + "debugged. (An ad-hoc \"signature\" is just a configuration without any " | ||
| 140 | + "actual cryptographic signature or a need for a certificate or anything else " | ||
| 141 | + "such as an Apple developer program membership.)" | ||
| 142 | + msgstr "" | ||
| 143 | + | ||
| 144 | + msgid "" | ||
| 145 | + "The following commands will create a file ``get-task-allow.plist`` with the " | ||
| 146 | + "necessary entitlement and add it to the Python binary:" | ||
| 147 | + msgstr "" | ||
| 148 | + | ||
| 149 | + msgid "" | ||
| 150 | + "echo '{\"com.apple.security.get-task-allow\": true}' | plutil -convert xml1 -" | ||
| 151 | + "o get-task-allow.plist -\n" | ||
| 152 | + "codesign --sign - --entitlements get-task-allow.plist path/to/bin/python3" | ||
| 153 | + msgstr "" | ||
| 154 | + | ||
| 155 | + msgid "" | ||
| 156 | + "where ``path/to/bin/python3`` is the path to your Python binary, which you " | ||
| 157 | + "can find by e.g. running ``which python3`` or evaluating ``sys." | ||
| 158 | + "base_executable`` at the Python REPL. (These instructions are for a non-" | ||
| 159 | + "framework build of Python. Framework builds may need to be configured " | ||
| 160 | + "differently.)" | ||
| 161 | + msgstr "" | ||
| 162 | + | ||
| 100 | 163 | msgid "" | |
| 101 | - "To attach to another process, you typically need to run your debugging tool " | ||
| 102 | - "with elevated privileges. This can be done by using ``sudo`` or running as " | ||
| 103 | - "root." | ||
| 164 | + "You should then be able to debug your own Python processes started with that " | ||
| 165 | + "binary." | ||
| 104 | 166 | msgstr "" | |
| 105 | 167 | ||
| 106 | 168 | msgid "" | |
| 107 | - "Even when attaching to processes you own, macOS may block debugging unless " | ||
| 108 | - "the debugger is run with root privileges due to system security restrictions." | ||
| 169 | + "Alternatively, much as with Linux, processes with superuser privileges e.g. " | ||
| 170 | + "``sudo`` are not subject to this check and can debug any user's process on " | ||
| 171 | + "the system (though there are additional checks on specific binaries, such as " | ||
| 172 | + "OS-provided commands, due to System Integrity Protection)." | ||
| 109 | 173 | msgstr "" | |
| 110 | 174 | ||
| 111 | 175 | msgid "Windows" | |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
@@ -11,7 +11,7 @@ msgid "" | |||
| 11 | 11 | msgstr "" | |
| 12 | 12 | "Project-Id-Version: Python 3.15\n" | |
| 13 | 13 | "Report-Msgid-Bugs-To: \n" | |
| 14 | - "POT-Creation-Date: 2026-09-03 17:25+0000\n" | ||
| 14 | + "POT-Creation-Date: 2026-09-23 18:03+0000\n" | ||
| 15 | 15 | "PO-Revision-Date: 2025-09-16 00:00+0000\n" | |
| 16 | 16 | "Last-Translator: python-doc bot, 2025\n" | |
| 17 | 17 | "Language-Team: Indonesian (https://app.transifex.com/python-doc/teams/5390/" | |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
@@ -8,7 +8,7 @@ msgid "" | |||
| 8 | 8 | msgstr "" | |
| 9 | 9 | "Project-Id-Version: Python 3.15\n" | |
| 10 | 10 | "Report-Msgid-Bugs-To: \n" | |
| 11 | - "POT-Creation-Date: 2026-09-23 18:03+0000\n" | ||
| 11 | + "POT-Creation-Date: 2026-09-25 18:08+0000\n" | ||
| 12 | 12 | "PO-Revision-Date: 2025-09-16 00:00+0000\n" | |
| 13 | 13 | "Language-Team: Indonesian (https://app.transifex.com/python-doc/teams/5390/" | |
| 14 | 14 | "id/)\n" | |
@@ -2415,8 +2415,8 @@ msgstr "" | |||
| 2415 | 2415 | ||
| 2416 | 2416 | msgid "" | |
| 2417 | 2417 | "In addition, if ``mode`` is ``'func_type'``, the input syntax is modified to " | |
| 2418 | - "correspond to :pep:`484` \"signature type comments\", e.g. ``(str, int) -> " | ||
| 2419 | - "List[str]``." | ||
| 2418 | + "correspond to :pep:`484` \"signature type comments\", for example ``(str, " | ||
| 2419 | + "int) -> List[str]``." | ||
| 2420 | 2420 | msgstr "" | |
| 2421 | 2421 | ||
| 2422 | 2422 | msgid "" | |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
@@ -11,7 +11,7 @@ msgid "" | |||
| 11 | 11 | msgstr "" | |
| 12 | 12 | "Project-Id-Version: Python 3.15\n" | |
| 13 | 13 | "Report-Msgid-Bugs-To: \n" | |
| 14 | - "POT-Creation-Date: 2026-09-03 17:25+0000\n" | ||
| 14 | + "POT-Creation-Date: 2026-09-23 18:03+0000\n" | ||
| 15 | 15 | "PO-Revision-Date: 2025-09-16 00:00+0000\n" | |
| 16 | 16 | "Last-Translator: python-doc bot, 2025\n" | |
| 17 | 17 | "Language-Team: Indonesian (https://app.transifex.com/python-doc/teams/5390/" | |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
@@ -11,7 +11,7 @@ msgid "" | |||
| 11 | 11 | msgstr "" | |
| 12 | 12 | "Project-Id-Version: Python 3.15\n" | |
| 13 | 13 | "Report-Msgid-Bugs-To: \n" | |
| 14 | - "POT-Creation-Date: 2026-09-03 17:25+0000\n" | ||
| 14 | + "POT-Creation-Date: 2026-09-23 18:03+0000\n" | ||
| 15 | 15 | "PO-Revision-Date: 2025-09-16 00:01+0000\n" | |
| 16 | 16 | "Last-Translator: python-doc bot, 2025\n" | |
| 17 | 17 | "Language-Team: Indonesian (https://app.transifex.com/python-doc/teams/5390/" | |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
@@ -11,7 +11,7 @@ msgid "" | |||
| 11 | 11 | msgstr "" | |
| 12 | 12 | "Project-Id-Version: Python 3.15\n" | |
| 13 | 13 | "Report-Msgid-Bugs-To: \n" | |
| 14 | - "POT-Creation-Date: 2026-09-05 16:26+0000\n" | ||
| 14 | + "POT-Creation-Date: 2026-09-25 18:08+0000\n" | ||
| 15 | 15 | "PO-Revision-Date: 2025-09-16 00:01+0000\n" | |
| 16 | 16 | "Last-Translator: python-doc bot, 2025\n" | |
| 17 | 17 | "Language-Team: Indonesian (https://app.transifex.com/python-doc/teams/5390/" | |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
@@ -12,7 +12,7 @@ msgid "" | |||
| 12 | 12 | msgstr "" | |
| 13 | 13 | "Project-Id-Version: Python 3.15\n" | |
| 14 | 14 | "Report-Msgid-Bugs-To: \n" | |
| 15 | - "POT-Creation-Date: 2026-09-03 17:25+0000\n" | ||
| 15 | + "POT-Creation-Date: 2026-09-23 18:03+0000\n" | ||
| 16 | 16 | "PO-Revision-Date: 2025-09-16 00:01+0000\n" | |
| 17 | 17 | "Last-Translator: Rafael Fontenelle <rffontenelle@gmail.com>, 2026\n" | |
| 18 | 18 | "Language-Team: Indonesian (https://app.transifex.com/python-doc/teams/5390/" | |
| Back | FazBrowse Home | New Git URL |
0 commit comments