python-docs-fa/c-api/perfmaps.po at 3.15 · python/python-docs-fa · GitHub

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
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001 Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
# Translators:
# Revisto <theRevisto@gmail.com>, 2025
# Sepehr Rasouli <sepehrrasouli06@gmail.com>, 2026
# arman mohebali <armanmohebali@outlook.com>, 2026
#
msgid ""
msgstr ""
"Project-Id-Version: Python 3.14\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2026-10-01 14:41+0330\n"
"PO-Revision-Date: 2023-05-24 13:07+0000\n"
"Last-Translator: Sepehr Rasouli <sepehrrasouli06@gmail.com>, 2026\n"
"Language-Team: Persian (https://github.com/python/python-docs-fa/)\n"
"Language: fa\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Plural-Forms: nplurals=2; plural=(n > 1);\n"

msgid "Support for Perf Maps"
msgstr "پشتیبانی از Perf Maps"

msgid "On supported platforms (Linux and macOS), 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>`_ or `samply <https://github.com/mstange/samply/>`_). 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 "روی سکوهای پشتیبانی‌شده (لینوکس و مک‌اواس)، زمان‌اجرا می‌تواند از *پرونده‌های نگاشت perf* بهره ببرد تا توابع پایتون برای یک ابزار پروفایل‌گیری خارجی (مانند `perf <https://perf.wiki.kernel.org/index.php/Main_Page>`_ یا `samply <https://github.com/mstange/samply/>`_) قابل مشاهده شوند. یک فرایند در حال اجرا ممکن است پرونده‌ای در پوشه‌ی ``/tmp`` ایجاد کند که حاوی مواردی برای نگاشت بخش از کد اجرایی به یک نام است. این رابط در `مستندات ابزار لینوکس Perf <https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/tree/tools/perf/Documentation/jit-interface.txt>`_ شرح داده شده است."

msgid "In Python, these helper APIs can be used by libraries and features that rely on generating machine code on the fly."
msgstr "در پایتون، کتابخانه‌ها و قابلیت‌هایی که به تولید کد ماشین در لحظه وابسته‌اند، می‌توانند از این APIهای کمکی استفاده کنند."

msgid "Note that holding an :term:`attached thread state` is not required for these APIs."
msgstr "توجه داشته باشید که نگه‌داشتن :term:`attached thread state` برای این API‌ها الزامی نیست."

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`` را باز کنید، مگر اینکه از قبل باز شده باشد، و یک قفل ایجاد کنید تا نوشتن در پرونده به‌صورت نخ‌ایمن تضمین شود (به شرطی که نوشتن‌ها از طریق :c:func:`PyUnstable_WritePerfMapEntry` انجام شوند). معمولاً نیازی به فراخوانی صریح آن نیست؛ کافی است از :c:func:`PyUnstable_WritePerfMapEntry` استفاده کنید و این تابع وضعیت را در نخستین فراخوانی مقداردهی اولیه می‌کند."

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 "در صورت موفقیت مقدار ``0``، در صورت شکست در ایجاد/باز کردن پرونده‌ی perf map مقدار ``-1`` و در صورت شکست در ایجاد قفل مقدار ``-2`` را برمی‌گرداند. برای کسب اطلاعات بیشتر درباره‌ی علت شکست، ``errno`` را بررسی کنید."

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`` می‌نویسد. این تابع نخ‌ایمن است. نمونه‌ای از یک ورودی به شکل زیر است::"

msgid ""
"# address      size  name\n"
"7f3529fcf759 b     py::bar:/run/t.py"
msgstr ""
"# address      size  name\n"
"7f3529fcf759 b     py::bar:/run/t.py"

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` را برمی‌گرداند."

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 "پرونده‌ی نقشه‌ی perf (perf map) باز‌شده توسط :c:func:`PyUnstable_PerfMapState_Init` را می‌بندد. این تابع توسط خودِ ران‌تایم در زمان خاموشی مفسر فراخوانی می‌شود. به‌طور کلی، نباید دلیلی برای فراخوانی صریح آن وجود داشته باشد، مگر برای مدیریت سناریوهای خاص مانند انشعاب."

msgid "Open the ``/tmp/perf-$pid.map`` file and append the content of *parent_filename* to it."
msgstr "پرونده‌ی ``/tmp/perf-$pid.map`` را باز کنید و محتوای *parent_filename* را به آن الحاق کنید."

msgid "This function is available on all platforms but only generates output on platforms that support perf maps (currently only Linux). On other platforms, it does nothing."
msgstr "این تابع در همه‌ی پلتفرم‌ها دسترس‌پذیر است، اما تنها در پلتفرم‌هایی که از نقشه‌های perf (perf maps) پشتیبانی می‌کنند (در حال حاضر فقط لینوکس) خروجی تولید می‌کند. در پلتفرم‌های دیگر، هیچ کاری انجام نمی‌دهد."

msgid "Compile the given code object using the current perf trampoline."
msgstr "شیء کد داده‌شده را با استفاده از ترامپولین فعلی perf کامپایل کنید."

msgid "The \"current\" trampoline is the one set by the runtime or the most recent :c:func:`PyUnstable_PerfTrampoline_SetPersistAfterFork` call."
msgstr "ترامپولین «جاری» همان ترامپولینی است که توسط ران‌تایم یا جدیدترین فراخوانی :c:func:`PyUnstable_PerfTrampoline_SetPersistAfterFork` تنظیم‌شده است."

msgid "If no trampoline is set, falls back to normal compilation (no perf map entry)."
msgstr "اگر هیچ ترامپولینی تنظیم‌نشده باشد، به کامپایل عادی بازمی‌گردد (بدون ورودی در نقشه‌ی perf)."

msgid "Parameters"
msgstr "پارامترها"

msgid "The code object to compile."
msgstr "شیء کدی که باید کامپایل شود."

msgid "Returns"
msgstr "بازگشت"

msgid "0 on success, -1 on failure."
msgstr "0 در صورت موفقیت، -1 در صورت شکست."

msgid "Set whether the perf trampoline should persist after a fork."
msgstr "تعیین می‌کند که آیا ترامپولین perf باید پس از فورک پایا بماند یا خیر."

msgid "If ``enable`` is true (non-zero): perf map file remains open/valid post-fork. Child process inherits all existing perf map entries."
msgstr "اگر ``enable`` درست (ناصفر) باشد: پرونده‌ی perf map پس از انشعاب باز/معتبر باقی می‌ماند. فرایند فرزند تمام ورودی‌های موجود perf map را به ارث می‌برد."

msgid "If ``enable`` is false (zero): perf map closes post-fork. Child process gets empty perf map."
msgstr "اگر ``enable`` نادرست (صفر) باشد: نقشه perf (perf map) پس از انشعاب بسته می‌شود. فرایند فرزند نقشه perf خالی دریافت می‌کند."

msgid "Default: false (clears on fork)."
msgstr "پیش‌فرض: false (هنگام انشعاب پاک می‌شود)."

msgid "1 to enable, 0 to disable."
msgstr "۱ برای فعال‌سازی، ۰ برای غیرفعال‌سازی."