perfmaps.po

# Copyright (C) 2001-2024, Python Software Foundation
# This file is distributed under the same license as the Python package.
#
# Translators:
# Matt Wang <mattwang44@gmail.com>, 2024
msgid ""
msgstr ""
"Project-Id-Version: Python 3.13\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2023-07-17 17:39+0800\n"
"PO-Revision-Date: 2024-05-11 14:42+0800\n"
"Last-Translator: Matt Wang <mattwang44@gmail.com>\n"
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
"tw)\n"
"Language: zh_TW\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"

#: ../../c-api/perfmaps.rst:6
msgid "Support for Perf Maps"
msgstr "對 Perf Map 的支援"

#: ../../c-api/perfmaps.rst:8
msgid ""
"On supported platforms (as of this writing, only Linux), the runtime can "
"take advantage of *perf map files* to make Python functions visible to an "
"external profiling tool (such as `perf <https://perf.wiki.kernel.org/index."
"php/Main_Page>`_). A running process may create a file in the ``/tmp`` "
"directory, which contains entries that can map a section of executable code "
"to a name. This interface is described in the `documentation of the Linux "
"Perf tool <https://git.kernel.org/pub/scm/linux/ kernel/git/torvalds/linux."
"git/tree/tools/perf/Documentation/jit-interface.txt>`_."
msgstr ""
"在支援的平台上（截至撰寫本文時，僅限 Linux），runtime 可以利用 *perf map 檔案"
"*\\ 使得外部分析工具（例如 `perf <https://perf.wiki.kernel.org/index.php/"
"Main_Page>`_）可以見到 Python 函式。正在運行的行程可能會在 ``/tmp`` 目錄中建"
"立一個檔案，其中包含可以將一段可執行程式碼對映到名稱的各個條目。此介面在 "
"`Linux Perf 工具的文件 <https://git.kernel.org/pub/scm/linux/ kernel/git/"
"torvalds/linux.git/tree/tools/perf/Documentation/jit-interface.txt>`_\\ 中有"
"被描述。"

#: ../../c-api/perfmaps.rst:16
msgid ""
"In Python, these helper APIs can be used by libraries and features that rely "
"on generating machine code on the fly."
msgstr ""
"在 Python 中，這些輔助 API 可以被依賴於運行期間 (on the fly) 產生機器碼的函式"
"庫和功能所使用。"

#: ../../c-api/perfmaps.rst:19
msgid ""
"Note that holding the Global Interpreter Lock (GIL) is not required for "
"these APIs."
msgstr "請注意，這些 API 不需要持有全域直譯器鎖 (GIL)。"

#: ../../c-api/perfmaps.rst:23
msgid ""
"Open the ``/tmp/perf-$pid.map`` file, unless it's already opened, and create "
"a lock to ensure thread-safe writes to the file (provided the writes are "
"done through :c:func:`PyUnstable_WritePerfMapEntry`). Normally, there's no "
"need to call this explicitly; just use :c:func:"
"`PyUnstable_WritePerfMapEntry` and it will initialize the state on first "
"call."
msgstr ""
"打開 ``/tmp/perf-$pid.map`` 檔案，除非它已經打開，並建立一個鎖以確保執行緒安"
"全地 (thread-safe) 寫入該檔案（前提是寫入是透過 :c:func:"
"`PyUnstable_WritePerfMapEntry` 完成的）。通常不需要明確地呼叫它；只需使用 :c:"
"func:`PyUnstable_WritePerfMapEntry` 它就會在首次呼叫時初始化狀態。"

#: ../../c-api/perfmaps.rst:29
msgid ""
"Returns ``0`` on success, ``-1`` on failure to create/open the perf map "
"file, or ``-2`` on failure to create a lock. Check ``errno`` for more "
"information about the cause of a failure."
msgstr ""
"建立/打開 perf map 檔案成功時回傳 ``0``，失敗時回傳 ``-1``，建立鎖時失敗則回"
"傳 ``-2``。檢查 ``errno`` 以取得更多造成失敗的資訊。"

#: ../../c-api/perfmaps.rst:35
msgid ""
"Write one single entry to the ``/tmp/perf-$pid.map`` file. This function is "
"thread safe. Here is what an example entry looks like::"
msgstr ""
"將單一條目寫入 ``/tmp/perf-$pid.map`` 檔案。此函式是執行緒安全的。以下是一個"
"條目的範例："

#: ../../c-api/perfmaps.rst:38
msgid ""
"# address      size  name\n"
"7f3529fcf759 b     py::bar:/run/t.py"
msgstr ""

#: ../../c-api/perfmaps.rst:41
msgid ""
"Will call :c:func:`PyUnstable_PerfMapState_Init` before writing the entry, "
"if the perf map file is not already opened. Returns ``0`` on success, or the "
"same error codes as :c:func:`PyUnstable_PerfMapState_Init` on failure."
msgstr ""
"如果尚未開啟 perf map 檔案，將在寫入條目之前呼叫 :c:func:"
"`PyUnstable_PerfMapState_Init`。成功時回傳 ``0``，失敗時回傳與 :c:func:"
"`PyUnstable_PerfMapState_Init` 失敗時相同的錯誤碼。"

#: ../../c-api/perfmaps.rst:47
msgid ""
"Close the perf map file opened by :c:func:`PyUnstable_PerfMapState_Init`. "
"This is called by the runtime itself during interpreter shut-down. In "
"general, there shouldn't be a reason to explicitly call this, except to "
"handle specific scenarios such as forking."
msgstr ""
"關閉由 :c:func:`PyUnstable_PerfMapState_Init` 開啟的 perf map 檔案，這是在直"
"譯器關閉期間由 runtime 本身呼叫的。一般來說，除了處理 forking 等特定場景外，"
"不應該明確地呼叫它。"