FazBrowse GitHub Viewer
|
Trending
|
URL:
|
Home
Tools:
[Download Repo ZIP]
[View Raw Code]
[Original HTTPS Page]
python-docs-zh-tw/c-api/perfmaps.po at cron/sync/3.13 · python/python-docs-zh-tw · GitHub
python
python-docs-zh-tw
Repository navigation
Code
Issues
33
(33)
Pull requests
11
(11)
Discussions
Actions
Wiki
Security and quality
Insights
Expand file tree
Breadcrumbs
python-docs-zh-tw
/
c-api
/
perfmaps.po
Copy path
More file actions
More file actions
Latest commit
History
History
History
115 lines (105 loc) · 5.11 KB
Breadcrumbs
python-docs-zh-tw
/
c-api
/
perfmaps.po
Copy path
File metadata and controls
115 lines (105 loc) · 5.11 KB
Raw
Copy raw file
Download raw file
Open symbols panel
Edit and raw actions
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
#
Copyright (C) 2001-2025, 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
""
"# 位址 大小 名稱\n"
"7f3529fcf759 b py::bar:/run/t.py"
#:
../../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 等特定場景外，"
"不應該明確地呼叫它。"
Back
|
FazBrowse Home
|
New Git URL