GeezerVisonThe World Wide Web, restored to 800 pixels of glory. |
| Home|About|Gaming cabinet|Archives|How it works|Starter sites |
GeezerVison is showing github.com — python-docs-fa/howto/instrumentation.po at 3.15 · python/python-docs-fa Expand file tree/ Copy pathinstrumentation.poMore file actions 708 lines (609 loc) · 37.4 KB / Copy pathinstrumentation.poFile metadata and controls708 lines (609 loc) · 37.4 KB 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 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487 488 489 490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533 534 535 536 537 538 539 540 541 542 543 544 545 546 547 548 549 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 566 567 568 569 570 571 572 573 574 575 576 577 578 579 580 581 582 583 584 585 586 587 588 589 590 591 592 593 594 595 596 597 598 599 600 601 602 603 604 605 606 607 608 609 610 611 612 613 614 615 616 617 618 619 620 621 622 623 624 625 626 627 628 629 630 631 632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 654 655 656 657 658 659 660 661 662 663 664 665 666 667 668 669 670 671 672 673 674 675 676 677 678 679 680 681 682 683 684 685 686 687 688 689 690 691 692 693 694 695 696 697 698 699 700 701 702 703 704 705 706 707 708 # 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: # Danial Behzadi <[email protected]>, 2025 # Parham Forati, 2025 # Rafael Fontenelle <[email protected]>, 2025 # Revisto <[email protected]>, 2025 # Sepehr Rasouli <[email protected]>, 2026 # msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2026-11-08 04:10+0000\n" "PO-Revision-Date: 2021-06-28 00:53+0000\n" "Last-Translator: Sepehr Rasouli <[email protected]>, 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 "Instrumenting CPython with DTrace and SystemTap" msgstr "ابزارسازی CPython با DTrace و SystemTap" msgid "DTrace and SystemTap are monitoring tools, each providing a way to inspect what the processes on a computer system are doing. They both use domain-specific languages allowing a user to write scripts which:" msgstr "DTrace و SystemTap ابزارهای پایش هستند که هر کدام راهی برای بررسی کارهایی که فرایندهای یک سیستم کامپیوتری انجام می‌دهند، فراهم می‌کنند. هر دوی آن‌ها از زبان‌های خاص‌منظوره استفاده می‌کنند که به کاربر امکان می‌دهند اسکریپت‌هایی بنویسد که:" msgid "filter which processes are to be observed" msgstr "فیلتر کردن فرایندهایی که باید مشاهده شوند" msgid "gather data from the processes of interest" msgstr "جمع‌آوری داده‌ها از فرآیندهای مورد نظر" msgid "generate reports on the data" msgstr "تولید گزارش درباره‌ی داده‌ها" msgid "As of Python 3.6, CPython can be built with embedded \"markers\", also known as \"probes\", that can be observed by a DTrace or SystemTap script, making it easier to monitor what the CPython processes on a system are doing." msgstr "از پایتون 3.6 به بعد، می‌توان CPython را با نشانگرهای تعبیه‌شده‌ای ساخت که با نام «پروب‌ها» (probes) نیز شناخته می‌شوند و می‌توان آن‌ها را با یک اسکریپت DTrace یا SystemTap مشاهده کرد؛ این امر پایش آنچه را که فرآیندهای CPython بر روی یک سیستم انجام می‌دهند، آسان‌تر می‌کند." msgid "DTrace markers are implementation details of the CPython interpreter. No guarantees are made about probe compatibility between versions of CPython. DTrace scripts can stop working or work incorrectly without warning when changing CPython versions." msgstr "نشانگرهای DTrace جزئیات پیاده‌سازی مفسر CPython هستند. هیچ تضمینی درباره‌ی سازگاری پروب (probe) بین نسخه‌های CPython داده نمی‌شود. اسکریپت‌های DTrace ممکن است هنگام تغییر نسخه‌های CPython بدون هشدار از کار بیفتند یا نادرست کار کنند." msgid "Enabling the static markers" msgstr "فعال‌سازی نشانگرهای ایستا" msgid "macOS comes with built-in support for DTrace. On Linux, in order to build CPython with the embedded markers for SystemTap, the SystemTap development tools must be installed." msgstr "macOS دارای پشتیبانی توکار از DTrace است. در لینوکس، برای ساخت CPython با نشانگرهای تعبیه‌شده برای SystemTap، باید ابزارهای توسعه SystemTap نصب‌شده باشند." msgid "On a Linux machine, this can be done via::" msgstr "در یک ماشین لینوکسی، این کار را می‌توان از این طریق انجام داد::" msgid "$ yum install systemtap-sdt-devel" msgstr "$ yum install systemtap-sdt-devel" msgid "or::" msgstr "یا::" msgid "$ sudo apt-get install systemtap-sdt-dev" msgstr "$ sudo apt-get install systemtap-sdt-dev" msgid "CPython must then be :option:`configured with the --with-dtrace option <--with-dtrace>`:" msgstr "سپس CPython باید :option:`با گزینه --with-dtrace پیکربندی شود <--with-dtrace>`:" msgid "checking for --with-dtrace... yes" msgstr "بررسی برای --with-dtrace... بله" msgid "On macOS, you can list available DTrace probes by running a Python process in the background and listing all probes made available by the Python provider::" msgstr "در macOS، می‌توانید پروب‌های DTrace در دسترس را با اجرای یک فرایند پایتون در پس‌زمینه و فهرست کردن تمام پروب‌هایی که فراهم‌کننده پایتون در دسترس قرار داده است، فهرست کنید::" msgid "" "$ python3.6 -q &\n" "$ sudo dtrace -l -P python$! # or: dtrace -l -m python3.6\n" "\n" " ID PROVIDER MODULE FUNCTION NAME\n" "29564 python18035 python3.6 _PyEval_EvalFrameDefault function-entry\n" "29565 python18035 python3.6 dtrace_function_entry function-entry\n" "29566 python18035 python3.6 _PyEval_EvalFrameDefault function-return\n" "29567 python18035 python3.6 dtrace_function_return function-return\n" "29568 python18035 python3.6 collect gc-done\n" "29569 python18035 python3.6 collect gc-start\n" "29570 python18035 python3.6 _PyEval_EvalFrameDefault line\n" "29571 python18035 python3.6 maybe_dtrace_line line" msgstr "" "$ python3.6 -q &\n" "$ sudo dtrace -l -P python$! # or: dtrace -l -m python3.6\n" "\n" " ID PROVIDER MODULE FUNCTION NAME\n" "29564 python18035 python3.6 _PyEval_EvalFrameDefault function-entry\n" "29565 python18035 python3.6 dtrace_function_entry function-entry\n" "29566 python18035 python3.6 _PyEval_EvalFrameDefault function-return\n" "29567 python18035 python3.6 dtrace_function_return function-return\n" "29568 python18035 python3.6 collect gc-done\n" "29569 python18035 python3.6 collect gc-start\n" "29570 python18035 python3.6 _PyEval_EvalFrameDefault line\n" "29571 python18035 python3.6 maybe_dtrace_line line" msgid "On Linux, you can verify if the SystemTap static markers are present in the built binary by seeing if it contains a \".note.stapsdt\" section." msgstr "در لینوکس، می‌توانید با بررسی اینکه آیا دودویی ساخته‌شده شامل بخش \".note.stapsdt\" است، وجود نشانگرهای ایستای SystemTap را تأیید کنید." msgid "" "$ readelf -S ./python | grep .note.stapsdt\n" "[30] .note.stapsdt NOTE 0000000000000000 00308d78" msgstr "" "$ readelf -S ./python | grep .note.stapsdt\n" "[30] .note.stapsdt NOTE 0000000000000000 00308d78" msgid "If you've built Python as a shared library (with the :option:`--enable-shared` configure option), you need to look instead within the shared library. For example::" msgstr "اگر پایتون را به‌عنوان یک کتابخانه اشتراکی (با گزینه‌ی پیکربندی :option:`--enable-shared`) ساخته‌اید، باید به‌جای آن درون کتابخانه اشتراکی را بررسی کنید. برای مثال::" msgid "" "$ readelf -S libpython3.3dm.so.1.0 | grep .note.stapsdt\n" "[29] .note.stapsdt NOTE 0000000000000000 00365b68" msgstr "" "$ readelf -S libpython3.3dm.so.1.0 | grep .note.stapsdt\n" "[29] .note.stapsdt NOTE 0000000000000000 00365b68" msgid "Sufficiently modern readelf can print the metadata::" msgstr "readelf به‌اندازه کافی جدید می‌تواند فراداده را چاپ کند::" msgid "" "$ readelf -n ./python\n" "\n" "Displaying notes found at file offset 0x00000254 with length 0x00000020:\n" " Owner Data size Description\n" " GNU 0x00000010 NT_GNU_ABI_TAG (ABI version tag)\n" " OS: Linux, ABI: 2.6.32\n" "\n" "Displaying notes found at file offset 0x00000274 with length 0x00000024:\n" " Owner Data size Description\n" " GNU 0x00000014 NT_GNU_BUILD_ID (unique build ID bitstring)\n" " Build ID: df924a2b08a7e89f6e11251d4602022977af2670\n" "\n" "Displaying notes found at file offset 0x002d6c30 with length 0x00000144:\n" " Owner Data size Description\n" " stapsdt 0x00000031 NT_STAPSDT (SystemTap probe descriptors)\n" " Provider: python\n" " Name: gc__start\n" " Location: 0x00000000004371c3, Base: 0x0000000000630ce2, Semaphore: 0x00000000008d6bf6\n" " Arguments: -4@%ebx\n" " stapsdt 0x00000030 NT_STAPSDT (SystemTap probe descriptors)\n" " Provider: python\n" " Name: gc__done\n" " Location: 0x00000000004374e1, Base: 0x0000000000630ce2, Semaphore: 0x00000000008d6bf8\n" " Arguments: -8@%rax\n" " stapsdt 0x00000045 NT_STAPSDT (SystemTap probe descriptors)\n" " Provider: python\n" " Name: function__entry\n" " Location: 0x000000000053db6c, Base: 0x0000000000630ce2, Semaphore: 0x00000000008d6be8\n" " Arguments: 8@%rbp 8@%r12 -4@%eax\n" " stapsdt 0x00000046 NT_STAPSDT (SystemTap probe descriptors)\n" " Provider: python\n" " Name: function__return\n" " Location: 0x000000000053dba8, Base: 0x0000000000630ce2, Semaphore: 0x00000000008d6bea\n" " Arguments: 8@%rbp 8@%r12 -4@%eax" msgstr "" "$ readelf -n ./python\n" "\n" "Displaying notes found at file offset 0x00000254 with length 0x00000020:\n" " Owner Data size Description\n" " GNU 0x00000010 NT_GNU_ABI_TAG (ABI version tag)\n" " OS: Linux, ABI: 2.6.32\n" "\n" "Displaying notes found at file offset 0x00000274 with length 0x00000024:\n" " Owner Data size Description\n" " GNU 0x00000014 NT_GNU_BUILD_ID (unique build ID bitstring)\n" " Build ID: df924a2b08a7e89f6e11251d4602022977af2670\n" "\n" "Displaying notes found at file offset 0x002d6c30 with length 0x00000144:\n" " Owner Data size Description\n" " stapsdt 0x00000031 NT_STAPSDT (SystemTap probe descriptors)\n" " Provider: python\n" " Name: gc__start\n" " Location: 0x00000000004371c3, Base: 0x0000000000630ce2, Semaphore: 0x00000000008d6bf6\n" " Arguments: -4@%ebx\n" " stapsdt 0x00000030 NT_STAPSDT (SystemTap probe descriptors)\n" " Provider: python\n" " Name: gc__done\n" " Location: 0x00000000004374e1, Base: 0x0000000000630ce2, Semaphore: 0x00000000008d6bf8\n" " Arguments: -8@%rax\n" " stapsdt 0x00000045 NT_STAPSDT (SystemTap probe descriptors)\n" " Provider: python\n" " Name: function__entry\n" " Location: 0x000000000053db6c, Base: 0x0000000000630ce2, Semaphore: 0x00000000008d6be8\n" " Arguments: 8@%rbp 8@%r12 -4@%eax\n" " stapsdt 0x00000046 NT_STAPSDT (SystemTap probe descriptors)\n" " Provider: python\n" " Name: function__return\n" " Location: 0x000000000053dba8, Base: 0x0000000000630ce2, Semaphore: 0x00000000008d6bea\n" " Arguments: 8@%rbp 8@%r12 -4@%eax" msgid "The above metadata contains information for SystemTap describing how it can patch strategically placed machine code instructions to enable the tracing hooks used by a SystemTap script." msgstr "فراداده‌ی بالا شامل اطلاعاتی برای SystemTap است که توضیح می‌دهد چگونه می‌تواند دستورالعمل‌های کد ماشین را که به‌طور راهبردی قرار داده شده‌اند وصله کند تا قلاب‌های ردگیری (tracing hooks) مورد استفاده‌ی یک اسکریپت SystemTap فعال شوند." msgid "Static DTrace probes" msgstr "پروب‌های ایستای DTrace" msgid "The following example DTrace script can be used to show the call/return hierarchy of a Python script, only tracing within the invocation of a function called \"start\". In other words, import-time function invocations are not going to be listed:" msgstr "می‌توان از اسکریپت نمونه DTrace زیر برای نمایش سلسله‌مراتب فراخوانی/بازگشت یک اسکریپت پایتون استفاده کرد، به‌طوری‌که فقط درون فراخوانی تابعی به نام \"start\" ردگیری انجام می‌شود. به بیان دیگر، فراخوانی‌های تابع در زمان ایمپورت فهرست نخواهند شد:" msgid "" "self int indent;\n" "\n" "python$target:::function-entry\n" "/copyinstr(arg1) == \"start\"/\n" "{\n" " self->trace = 1;\n" "}\n" "\n" "python$target:::function-entry\n" "/self->trace/\n" "{\n" " printf(\"%d\\t%*s:\", timestamp, 15, probename);\n" " printf(\"%*s\", self->indent, \"\");\n" " printf(\"%s:%s:%d\\n\", basename(copyinstr(arg0)), copyinstr(arg1), arg2);\n" " self->indent++;\n" "}\n" "\n" "python$target:::function-return\n" "/self->trace/\n" "{\n" " self->indent--;\n" " printf(\"%d\\t%*s:\", timestamp, 15, probename);\n" " printf(\"%*s\", self->indent, \"\");\n" " printf(\"%s:%s:%d\\n\", basename(copyinstr(arg0)), copyinstr(arg1), arg2);\n" "}\n" "\n" "python$target:::function-return\n" "/copyinstr(arg1) == \"start\"/\n" "{\n" " self->trace = 0;\n" "}" msgstr "" "self int indent;\n" "\n" "python$target:::function-entry\n" "/copyinstr(arg1) == \"start\"/\n" "{\n" " self->trace = 1;\n" "}\n" "\n" "python$target:::function-entry\n" "/self->trace/\n" "{\n" " printf(\"%d\\t%*s:\", timestamp, 15, probename);\n" " printf(\"%*s\", self->indent, \"\");\n" " printf(\"%s:%s:%d\\n\", basename(copyinstr(arg0)), copyinstr(arg1), arg2);\n" " self->indent++;\n" "}\n" "\n" "python$target:::function-return\n" "/self->trace/\n" "{\n" " self->indent--;\n" " printf(\"%d\\t%*s:\", timestamp, 15, probename);\n" " printf(\"%*s\", self->indent, \"\");\n" " printf(\"%s:%s:%d\\n\", basename(copyinstr(arg0)), copyinstr(arg1), arg2);\n" "}\n" "\n" "python$target:::function-return\n" "/copyinstr(arg1) == \"start\"/\n" "{\n" " self->trace = 0;\n" "}" msgid "It can be invoked like this::" msgstr "می‌توان آن را به این صورت فراخوانی کرد::" msgid "$ sudo dtrace -q -s call_stack.d -c \"python3.6 script.py\"" msgstr "$ sudo dtrace -q -s call_stack.d -c \"python3.6 script.py\"" msgid "The output looks like this:" msgstr "خروجی به این شکل است:" msgid "" "156641360502280 function-entry:call_stack.py:start:23\n" "156641360518804 function-entry: call_stack.py:function_1:1\n" "156641360532797 function-entry: call_stack.py:function_3:9\n" "156641360546807 function-return: call_stack.py:function_3:10\n" "156641360563367 function-return: call_stack.py:function_1:2\n" "156641360578365 function-entry: call_stack.py:function_2:5\n" "156641360591757 function-entry: call_stack.py:function_1:1\n" "156641360605556 function-entry: call_stack.py:function_3:9\n" "156641360617482 function-return: call_stack.py:function_3:10\n" "156641360629814 function-return: call_stack.py:function_1:2\n" "156641360642285 function-return: call_stack.py:function_2:6\n" "156641360656770 function-entry: call_stack.py:function_3:9\n" "156641360669707 function-return: call_stack.py:function_3:10\n" "156641360687853 function-entry: call_stack.py:function_4:13\n" "156641360700719 function-return: call_stack.py:function_4:14\n" "156641360719640 function-entry: call_stack.py:function_5:18\n" "156641360732567 function-return: call_stack.py:function_5:21\n" "156641360747370 function-return:call_stack.py:start:28" msgstr "" "156641360502280 function-entry:call_stack.py:start:23\n" "156641360518804 function-entry: call_stack.py:function_1:1\n" "156641360532797 function-entry: call_stack.py:function_3:9\n" "156641360546807 function-return: call_stack.py:function_3:10\n" "156641360563367 function-return: call_stack.py:function_1:2\n" "156641360578365 function-entry: call_stack.py:function_2:5\n" "156641360591757 function-entry: call_stack.py:function_1:1\n" "156641360605556 function-entry: call_stack.py:function_3:9\n" "156641360617482 function-return: call_stack.py:function_3:10\n" "156641360629814 function-return: call_stack.py:function_1:2\n" "156641360642285 function-return: call_stack.py:function_2:6\n" "156641360656770 function-entry: call_stack.py:function_3:9\n" "156641360669707 function-return: call_stack.py:function_3:10\n" "156641360687853 function-entry: call_stack.py:function_4:13\n" "156641360700719 function-return: call_stack.py:function_4:14\n" "156641360719640 function-entry: call_stack.py:function_5:18\n" "156641360732567 function-return: call_stack.py:function_5:21\n" "156641360747370 function-return:call_stack.py:start:28" msgid "Static SystemTap markers" msgstr "نشانگرهای ایستای SystemTap" msgid "The low-level way to use the SystemTap integration is to use the static markers directly. This requires you to explicitly state the binary file containing them." msgstr "روش سطح پایین برای استفاده از یکپارچه‌سازی SystemTap، استفاده مستقیم از نشانگرهای ایستا است. این کار مستلزم آن است که پرونده دودویی حاوی آن‌ها را به‌صراحت مشخص کنید." msgid "For example, this SystemTap script can be used to show the call/return hierarchy of a Python script:" msgstr "برای مثال، می‌توان از این اسکریپت SystemTap برای نمایش سلسله‌مراتب فراخوانی/بازگشت یک اسکریپت پایتون استفاده کرد:" msgid "" "probe process(\"python\").mark(\"function__entry\") {\n" " filename = user_string($arg1);\n" " funcname = user_string($arg2);\n" " lineno = $arg3;\n" "\n" " printf(\"%s => %s in %s:%d\\\\n\",\n" " thread_indent(1), funcname, filename, lineno);\n" "}\n" "\n" "probe process(\"python\").mark(\"function__return\") {\n" " filename = user_string($arg1);\n" " funcname = user_string($arg2);\n" " lineno = $arg3;\n" "\n" " printf(\"%s <= %s in %s:%d\\\\n\",\n" " thread_indent(-1), funcname, filename, lineno);\n" "}" msgstr "" "probe process(\"python\").mark(\"function__entry\") {\n" " filename = user_string($arg1);\n" " funcname = user_string($arg2);\n" " lineno = $arg3;\n" "\n" " printf(\"%s => %s in %s:%d\\\\n\",\n" " thread_indent(1), funcname, filename, lineno);\n" "}\n" "\n" "probe process(\"python\").mark(\"function__return\") {\n" " filename = user_string($arg1);\n" " funcname = user_string($arg2);\n" " lineno = $arg3;\n" "\n" " printf(\"%s <= %s in %s:%d\\\\n\",\n" " thread_indent(-1), funcname, filename, lineno);\n" "}" msgid "" "$ stap \\\n" " show-call-hierarchy.stp \\\n" " -c \"./python test.py\"" msgstr "" "$ stap \\\n" " show-call-hierarchy.stp \\\n" " -c \"./python test.py\"" msgid "" "11408 python(8274): => __contains__ in Lib/_abcoll.py:362\n" "11414 python(8274): => __getitem__ in Lib/os.py:425\n" "11418 python(8274): => encode in Lib/os.py:490\n" "11424 python(8274): <= encode in Lib/os.py:493\n" "11428 python(8274): <= __getitem__ in Lib/os.py:426\n" "11433 python(8274): <= __contains__ in Lib/_abcoll.py:366" msgstr "" "11408 python(8274): => __contains__ in Lib/_abcoll.py:362\n" "11414 python(8274): => __getitem__ in Lib/os.py:425\n" "11418 python(8274): => encode in Lib/os.py:490\n" "11424 python(8274): <= encode in Lib/os.py:493\n" "11428 python(8274): <= __getitem__ in Lib/os.py:426\n" "11433 python(8274): <= __contains__ in Lib/_abcoll.py:366" msgid "where the columns are:" msgstr "که ستون‌ها عبارت‌اند از:" msgid "time in microseconds since start of script" msgstr "زمان بر حسب میکروثانیه از آغاز اسکریپت" msgid "name of executable" msgstr "نام پرونده اجرایی" msgid "PID of process" msgstr "شناسه فرایند (PID)" msgid "and the remainder indicates the call/return hierarchy as the script executes." msgstr "و بخش باقی‌مانده سلسله‌مراتب فراخوانی/بازگشت را در حین اجرای اسکریپت نشان می‌دهد." msgid "For a :option:`--enable-shared` build of CPython, the markers are contained within the libpython shared library, and the probe's dotted path needs to reflect this. For example, this line from the above example:" msgstr "برای ساخت CPython با :option:`--enable-shared`، نشانگرها درون کتابخانه‌ی اشتراکی libpython قرار دارند و مسیر نقطه‌دار پروب (probe) باید این موضوع را منعکس کند. برای مثال، این خط از مثال بالا:" msgid "probe process(\"python\").mark(\"function__entry\") {" msgstr "probe process(\"python\").mark(\"function__entry\") {" msgid "should instead read:" msgstr "در عوض باید این‌گونه خوانده شود:" msgid "probe process(\"python\").library(\"libpython3.6dm.so.1.0\").mark(\"function__entry\") {" msgstr "probe process(\"python\").library(\"libpython3.6dm.so.1.0\").mark(\"function__entry\") {" msgid "(assuming a :ref:`debug build <debug-build>` of CPython 3.6)" msgstr "(با فرض :ref:`ساخت اشکال‌زدایی <debug-build>` از CPython 3.6)" msgid "Available static markers" msgstr "نشانگرهای ایستای در دسترس" msgid "This marker indicates that execution of a Python function has begun. It is only triggered for pure-Python (bytecode) functions." msgstr "این نشانگر نشان می‌دهد که اجرای یک تابع پایتون آغاز شده است. این نشانگر فقط برای توابع پایتون خالص (bytecode) فعال می‌شود." msgid "The filename, function name, and line number are provided back to the tracing script as positional arguments, which must be accessed using ``$arg1``, ``$arg2``, ``$arg3``:" msgstr "نام پرونده، نام تابع و شماره خط به اسکریپت ردگیری به‌عنوان آرگومان‌های جایگاهی بازگردانده می‌شوند، که باید با استفاده از ``$arg1``، ``$arg2`` و ``$arg3`` به آن‌ها دسترسی یافت:" msgid "``$arg1`` : ``(const char *)`` filename, accessible using ``user_string($arg1)``" msgstr "``$arg1`` : ``(const char *)`` نام پرونده، قابل دسترسی با استفاده از ``user_string($arg1)``" msgid "``$arg2`` : ``(const char *)`` function name, accessible using ``user_string($arg2)``" msgstr "``$arg2`` : ``(const char *)`` نام تابع، قابل دسترسی با ``user_string($arg2)``" msgid "``$arg3`` : ``int`` line number" msgstr "``$arg3`` : ``int`` شماره‌ی خط" msgid "This marker is the converse of :c:func:`!function__entry`, and indicates that execution of a Python function has ended (either via ``return``, or via an exception). It is only triggered for pure-Python (bytecode) functions." msgstr "این نشانگر، معکوس :c:func:`!function__entry` است و نشان می‌دهد که اجرای یک تابع پایتون به پایان رسیده است (چه از طریق ``return`` و چه از طریق یک استثنا). این نشانگر فقط برای توابع پایتون خالص (بایت‌کد) فعال می‌شود." msgid "The arguments are the same as for :c:func:`!function__entry`" msgstr "آرگومان‌ها همانند :c:func:`!function__entry` هستند" msgid "This marker indicates a Python line is about to be executed. It is the equivalent of line-by-line tracing with a Python profiler. It is not triggered within C functions." msgstr "این نشانگر نشان می‌دهد که یک خط پایتون در آستانه‌ی اجراست. این معادل ردگیری خط‌به‌خط با یک پروفایل‌گیر پایتون (Python profiler) است. این نشانگر درون توابع C فعال نمی‌شود." msgid "The arguments are the same as for :c:func:`!function__entry`." msgstr "آرگومان‌ها همان آرگومان‌های :c:func:`!function__entry` هستند." msgid "Fires when the Python interpreter starts a garbage collection cycle. ``arg0`` is the generation to scan, like :func:`gc.collect`." msgstr "هنگامی که مفسر پایتون یک چرخه‌ی زباله‌روبی را آغاز می‌کند، رخ می‌دهد. ``arg0`` نسلی است که باید پویش شود، مانند :func:`gc.collect`." msgid "Fires when the Python interpreter finishes a garbage collection cycle. ``arg0`` is the number of collected objects." msgstr "هنگامی که مفسر پایتون یک چرخه زباله‌روبی را به پایان می‌رساند، راه‌اندازی می‌شود. ``arg0`` تعداد اشیاء جمع‌آوری‌شده است." msgid "Fires before :mod:`importlib` attempts to find and load the module. ``arg0`` is the module name." msgstr "پیش از تلاش :mod:`importlib` برای یافتن و بارگذاری ماژول، شلیک می‌شود. ``arg0`` نام ماژول است." msgid "Fires after :mod:`importlib`'s find_and_load function is called. ``arg0`` is the module name, ``arg1`` indicates if module was successfully loaded." msgstr "پس از فراخوانی تابع find_and_load در :mod:`importlib` رخ می‌دهد. ``arg0`` نام ماژول است و ``arg1`` نشان می‌دهد که آیا ماژول با موفقیت بارگذاری شده است." msgid "Fires when :func:`sys.audit` or :c:func:`PySys_Audit` is called. ``arg0`` is the event name as C string, ``arg1`` is a :c:type:`PyObject` pointer to a tuple object." msgstr "هنگامی که :func:`sys.audit` یا :c:func:`PySys_Audit` فراخوانی شود، رخ می‌دهد. ``arg0`` نام رویداد به‌صورت یک رشته C است، و ``arg1`` یک اشاره‌گر :c:type:`PyObject` به یک شیء تاپل است." msgid "C Entry Points" msgstr "نقاط ورود C" msgid "To simplify triggering of DTrace markers, Python's C API comes with a number of helper functions that mirror each static marker. On builds of Python without DTrace enabled, these do nothing." msgstr "برای ساده‌سازی فعال‌سازی نشانگرهای DTrace، C API پایتون شامل تعدادی تابع کمکی است که با هر نشانگر ایستا متناظر هستند. در ساخت‌های پایتون که DTrace در آن‌ها فعال نیست، این توابع هیچ کاری انجام نمی‌دهند." msgid "In general, it is not necessary to call these yourself, as Python will do it for you." msgstr "به‌طور کلی، لازم نیست این‌ها را خودتان فراخوانی کنید، زیرا پایتون این کار را برای شما انجام خواهد داد." msgid "C API Function" msgstr "تابع API C" msgid "Static Marker" msgstr "نشانگر ایستا" msgid "Notes" msgstr "یادداشت‌ها" msgid ":c:func:`!line`" msgstr ":c:func:`!line`" msgid ":c:func:`!function__entry`" msgstr ":c:func:`!function__entry`" msgid ":c:func:`!function__return`" msgstr ":c:func:`!function__return`" msgid ":c:func:`!gc__start`" msgstr ":c:func:`!gc__start`" msgid ":c:func:`!gc__done`" msgstr ":c:func:`!gc__done`" msgid ":c:func:`!instance__new__start`" msgstr ":c:func:`!instance__new__start`" msgid "Not used by Python" msgstr "توسط پایتون استفاده نمی‌شود" msgid ":c:func:`!instance__new__done`" msgstr ":c:func:`!instance__new__done`" msgid ":c:func:`!instance__delete__start`" msgstr ":c:func:`!instance__delete__start`" msgid ":c:func:`!instance__delete__done`" msgstr ":c:func:`!instance__delete__done`" msgid ":c:func:`!import__find__load__start`" msgstr ":c:func:`!import__find__load__start`" msgid ":c:func:`!import__find__load__done`" msgstr ":c:func:`!import__find__load__done`" msgid ":c:func:`!audit`" msgstr ":c:func:`!audit`" msgid "C Probing Checks" msgstr "بررسی‌های کاوشی C" msgid "All calls to ``PyDTrace`` functions must be guarded by a call to one of these functions. This allows Python to minimize performance impact when probing is disabled." msgstr "همه فراخوانی‌های توابع ``PyDTrace`` باید با فراخوانی یکی از این توابع محافظت شوند. این امر به پایتون امکان می‌دهد هنگام غیرفعال بودن پایش (probing)، تأثیر بر کارایی را به حداقل برساند." msgid "On builds without DTrace enabled, these functions do nothing and return ``0``." msgstr "در ساخت‌هایی که DTrace در آن‌ها فعال نیست، این توابع هیچ کاری انجام نمی‌دهند و ``0`` را برمی‌گردانند." msgid "SystemTap Tapsets" msgstr "Tapsetهای SystemTap" msgid "The higher-level way to use the SystemTap integration is to use a \"tapset\": SystemTap's equivalent of a library, which hides some of the lower-level details of the static markers." msgstr "روش سطح بالاتر برای استفاده از یکپارچه‌سازی SystemTap، استفاده از یک «tapset» است: معادل یک کتابخانه در SystemTap، که برخی از جزئیات سطح پایین‌تر نشانگرهای ایستا را می‌پوشاند." msgid "Here is a tapset file, based on a non-shared build of CPython:" msgstr "در اینجا یک پرونده‌ی tapset، بر پایه‌ی یک ساخت غیراشتراکی از CPython، آمده است:" #, fuzzy #| msgid "" #| "/*\n" #| " Provide a higher-level wrapping around the function__entry and\n" #| " function__return markers:\n" #| " \\*/\n" #| "probe python.function.entry = process(\"python\").mark(\"function__entry\")\n" #| "{\n" #| " filename = user_string($arg1);\n" #| " funcname = user_string($arg2);\n" #| " lineno = $arg3;\n" #| " frameptr = $arg4\n" #| "}\n" #| "probe python.function.return = process(\"python\").mark(\"function__return\")\n" #| "{\n" #| " filename = user_string($arg1);\n" #| " funcname = user_string($arg2);\n" #| " lineno = $arg3;\n" #| " frameptr = $arg4\n" #| "}" msgid "" "/*\n" " Provide a higher-level wrapping around the function__entry and\n" " function__return markers:\n" " */\n" "probe python.function.entry = process(\"python\").mark(\"function__entry\")\n" "{\n" " filename = user_string($arg1);\n" " funcname = user_string($arg2);\n" " lineno = $arg3;\n" " frameptr = $arg4\n" "}\n" "probe python.function.return = process(\"python\").mark(\"function__return\")\n" "{\n" " filename = user_string($arg1);\n" " funcname = user_string($arg2);\n" " lineno = $arg3;\n" " frameptr = $arg4\n" "}" msgstr "" "/*\n" " Provide a higher-level wrapping around the function__entry and\n" " function__return markers:\n" " \\*/\n" "probe python.function.entry = process(\"python\").mark(\"function__entry\")\n" "{\n" " filename = user_string($arg1);\n" " funcname = user_string($arg2);\n" " lineno = $arg3;\n" " frameptr = $arg4\n" "}\n" "probe python.function.return = process(\"python\").mark(\"function__return\")\n" "{\n" " filename = user_string($arg1);\n" " funcname = user_string($arg2);\n" " lineno = $arg3;\n" " frameptr = $arg4\n" "}" msgid "If this file is installed in SystemTap's tapset directory (e.g. ``/usr/share/systemtap/tapset``), then these additional probepoints become available:" msgstr "اگر این پرونده در پوشه‌ی tapset متعلق به SystemTap نصب شده باشد (برای مثال ``/usr/share/systemtap/tapset``)، آنگاه این نقاط پروب (probepoints) اضافی در دسترس قرار می‌گیرند:" msgid "This probe point indicates that execution of a Python function has begun. It is only triggered for pure-Python (bytecode) functions." msgstr "این نقطه پروب (probe point) نشان می‌دهد که اجرای یک تابع پایتون آغاز شده است. این فقط برای توابع پایتون خالص (بایت‌کد) فعال می‌شود." #, fuzzy #| msgid "This probe point is the converse of ``python.function.return``, and indicates that execution of a Python function has ended (either via ``return``, or via an exception). It is only triggered for pure-Python (bytecode) functions." msgid "This probe point is the converse of ``python.function.entry``, and indicates that execution of a Python function has ended (either via ``return``, or via an exception). It is only triggered for pure-Python (bytecode) functions." msgstr "این نقطه‌ی پروب (probe point)، نقطه‌ی مقابل ``python.function.return`` است و نشان می‌دهد که اجرای یک تابع پایتون به پایان رسیده است (چه از طریق ``return`` و چه از طریق یک استثنا). این نقطه فقط برای توابع پایتون خالص (bytecode) فعال می‌شود." msgid "Examples" msgstr "مثال‌ها" msgid "This SystemTap script uses the tapset above to more cleanly implement the example given above of tracing the Python function-call hierarchy, without needing to directly name the static markers:" msgstr "این اسکریپت SystemTap از tapset بالا استفاده می‌کند تا مثال ارائه‌شده در بالا برای ردگیری سلسله‌مراتب فراخوانی تابع پایتون را به‌صورت تمیزتری پیاده‌سازی کند، بدون نیاز به نام‌گذاری مستقیم نشانگرهای ایستا:" msgid "" "probe python.function.entry\n" "{\n" " printf(\"%s => %s in %s:%d\\n\",\n" " thread_indent(1), funcname, filename, lineno);\n" "}\n" "\n" "probe python.function.return\n" "{\n" " printf(\"%s <= %s in %s:%d\\n\",\n" " thread_indent(-1), funcname, filename, lineno);\n" "}" msgstr "" "probe python.function.entry\n" "{\n" " printf(\"%s => %s in %s:%d\\n\",\n" " thread_indent(1), funcname, filename, lineno);\n" "}\n" "\n" "probe python.function.return\n" "{\n" " printf(\"%s <= %s in %s:%d\\n\",\n" " thread_indent(-1), funcname, filename, lineno);\n" "}" msgid "The following script uses the tapset above to provide a top-like view of all running CPython code, showing the top 20 most frequently entered bytecode frames, each second, across the whole system:" msgstr "اسکریپت زیر از tapset بالا برای ارائه نمایی مشابه top از تمام کدهای CPython در حال اجرا استفاده می‌کند و هر ثانیه، ۲۰ فریم بایت‌کد با بیشترین تعداد ورود در سراسر سیستم را نشان می‌دهد:" #, fuzzy #| msgid "" #| "global fn_calls;\n" #| "\n" #| "probe python.function.entry\n" #| "{\n" #| " fn_calls[pid(), filename, funcname, lineno] += 1;\n" #| "}\n" #| "\n" #| "probe timer.ms(1000) {\n" #| " printf(\"\\033[2J\\033[1;1H\") /* clear screen \\*/\n" #| " printf(\"%6s %80s %6s %30s %6s\\n\",\n" #| " \"PID\", \"FILENAME\", \"LINE\", \"FUNCTION\", \"CALLS\")\n" #| " foreach ([pid, filename, funcname, lineno] in fn_calls- limit 20) {\n" #| " printf(\"%6d %80s %6d %30s %6d\\n\",\n" #| " pid, filename, lineno, funcname,\n" #| " fn_calls[pid, filename, funcname, lineno]);\n" #| " }\n" #| " delete fn_calls;\n" #| "}" msgid "" "global fn_calls;\n" "\n" "probe python.function.entry\n" "{\n" " fn_calls[pid(), filename, funcname, lineno] += 1;\n" "}\n" "\n" "probe timer.ms(1000) {\n" " printf(\"\\033[2J\\033[1;1H\") /* clear screen */\n" " printf(\"%6s %80s %6s %30s %6s\\n\",\n" " \"PID\", \"FILENAME\", \"LINE\", \"FUNCTION\", \"CALLS\")\n" " foreach ([pid, filename, funcname, lineno] in fn_calls- limit 20) {\n" " printf(\"%6d %80s %6d %30s %6d\\n\",\n" " pid, filename, lineno, funcname,\n" " fn_calls[pid, filename, funcname, lineno]);\n" " }\n" " delete fn_calls;\n" "}" msgstr "" "global fn_calls;\n" "\n" "probe python.function.entry\n" "{\n" " fn_calls[pid(), filename, funcname, lineno] += 1;\n" "}\n" "\n" "probe timer.ms(1000) {\n" " printf(\"\\033[2J\\033[1;1H\") /* clear screen \\*/\n" " printf(\"%6s %80s %6s %30s %6s\\n\",\n" " \"PID\", \"FILENAME\", \"LINE\", \"FUNCTION\", \"CALLS\")\n" " foreach ([pid, filename, funcname, lineno] in fn_calls- limit 20) {\n" " printf(\"%6d %80s %6d %30s %6d\\n\",\n" " pid, filename, lineno, funcname,\n" " fn_calls[pid, filename, funcname, lineno]);\n" " }\n" " delete fn_calls;\n" "}" #~ msgid "author" #~ msgstr "نویسنده" #~ msgid "David Malcolm" #~ msgstr "دیوید مالکوم" #~ msgid "Łukasz Langa" #~ msgstr "Łukasz Langa" |
| You are visitor 01402520 — GeezerVison does not store the pages you look up. Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required. |