PMDBG(1)                    General Commands Manual                   PMDBG(1)

نام (NAME)
       pmdbg - گزارش گزینه‌های اشکال‌زدایی Performance Co-Pilot

خلاصه دستور (SYNOPSIS)
       pmdbg [-l]

توضیحات (DESCRIPTION)
       مؤلفه‌های Performance Co-Pilot (PCP) از یک سازوکار سراسری برای کنترل
       خروجی‌های تشخیصی و اشکال‌زدایی استفاده می‌کنند.

       دستور pmdbg تمامی گزینه‌های اشکال‌زدایی موجود را به همراه نام گزینه و
       توضیحی کوتاه درباره آن نمایش می‌دهد.

       گزینه -l هیچ عملی انجام نمی‌دهد و تنها برای سازگاری با نسخه‌های قدیمی‌تر
       pmdbg گنجانده شده است.

       بیشتر برنامه‌هایی که از قابلیت‌های PCP بهره می‌برند، از نحو خط فرمان -D
       name[,name ...] برای فعال‌سازی کنترل اشکال‌زدایی بر اساس نام گزینه‌های
       اشکال‌زدایی مورد نظر پشتیبانی می‌کنند.

       همچنین، مقدار اولیه پرچم‌های کنترل اشکال‌زدایی می‌تواند از طریق متغیر
       محیطی $PCP_DEBUG به صورت فهرستی از نام گزینه‌ها که با کاما از هم جدا
       شده‌اند تنظیم شود، به شرطی که برنامه‌ها برای پردازش گزینه‌ها و آرگومان‌های
       خط فرمان از pmGetOptions(3) استفاده کنند.  اگر از هر دو سازوکار استفاده
       شود، تأثیر آن‌ها تجمعی خواهد بود؛ یعنی پرچم‌های نهایی حاصل ترکیب مقادیر
       تنظیم‌شده از طریق $PCP_DEBUG و گزینه‌های خط فرمان -D خواهد بود.

محیط PCP (PCP ENVIRONMENT)
       متغیرهای محیطی با پیشوند PCP_ برای پارامتریک‌سازی نام فایل‌ها و
       دایرکتوری‌های مورد استفاده PCP به کار می‌روند.  در هر نصب، فایل
       /etc/pcp.conf شامل مقادیر محلی این متغیرها است.  متغیر $PCP_CONF
       می‌تواند برای مشخص کردن فایل پیکربندی جایگزین استفاده شود، همان‌طور که در
       pcp.conf(5) شرح داده شده است.

سازگاری (COMPATIBILITY)
       پیش از PCP 7.0، گزینه‌های اشکال‌زدایی در یک حالت دوگانه نگهداری می‌شدند:
       یک عدد صحیح کدگذاری‌شده دودویی به سبک قدیمی (به همراه نام ماکرو برای
       برنامه‌نویسان) و یک نام رشته‌ای نویسه‌ای به سبک جدید برای هر گزینه
       اشکال‌زدایی.

       در PCP 7.0، پشتیبانی از سبک قدیمی متوقف شد.

       جدول زیر معادل‌های مربوط به گزینه‌های اشکال‌زدایی را که در هر دو سبک قدیم
       و جدید وجود داشتند مستند می‌کند.

           ┌────────────────────────────────────────────────┬─────────────┐
           │                   Old Style                    │  New Style  │
           ├──────────────────────┬────────────┬────────────┼─────────────┤
           │Symbolic Name         │       Mask │      Value │ Name        │
           ├──────────────────────┼────────────┼────────────┼─────────────┤
           │DBG_TRACE_PDU         │ 0x00000001 │          1 │ pdu         │
           │DBG_TRACE_FETCH       │ 0x00000002 │          2 │ fetch       │
           │DBG_TRACE_PROFILE     │ 0x00000004 │          4 │ profile     │
           │DBG_TRACE_VALUE       │ 0x00000008 │          8 │ value       │
           │DBG_TRACE_CONTEXT     │ 0x00000010 │         16 │ context     │
           │DBG_TRACE_INDOM       │ 0x00000020 │         32 │ indom       │
           │DBG_TRACE_PDUBUF      │ 0x00000040 │         64 │ pdubuf      │
           │DBG_TRACE_LOG         │ 0x00000080 │        128 │ log         │
           │DBG_TRACE_LOGMETA     │ 0x00000100 │        256 │ logmeta     │
           │DBG_TRACE_OPTFETCH    │ 0x00000200 │        512 │ optfetch    │
           │DBG_TRACE_AF          │ 0x00000400 │       1024 │ af          │
           │DBG_TRACE_APPL0       │ 0x00000800 │       2048 │ appl0       │
           │DBG_TRACE_APPL1       │ 0x00001000 │       4096 │ appl1       │
           │DBG_TRACE_APPL2       │ 0x00002000 │       8192 │ appl2       │
           │DBG_TRACE_PMNS        │ 0x00004000 │      16384 │ pmns        │
           │DBG_TRACE_LIBPMDA     │ 0x00008000 │      32768 │ libpmda     │
           │DBG_TRACE_TIMECONTROL │ 0x00001000 │      65536 │ timecontrol │
           │DBG_TRACE_PMC         │ 0x00002000 │     131072 │ pmc         │
           │DBG_TRACE_DERIVE      │ 0x00004000 │     262144 │ derive      │
           │DBG_TRACE_LOCK        │ 0x00008000 │     524288 │ lock        │
           │DBG_TRACE_INTERP      │ 0x00010000 │    1048576 │ interp      │
           │DBG_TRACE_CONFIG      │ 0x00020000 │    2097152 │ config      │
           │DBG_TRACE_PMAPI       │ 0x00040000 │    4194304 │ pmapi       │
           │DBG_TRACE_FAULT       │ 0x00080000 │    8388608 │ fault       │
           │DBG_TRACE_AUTH        │ 0x00100000 │   16777216 │ auth        │
           │DBG_TRACE_DISCOVERY   │ 0x00200000 │   33554432 │ discovery   │
           │DBG_TRACE_ATTR        │ 0x00400000 │   67108864 │ attr        │
           │DBG_TRACE_HTTP        │ 0x00800000 │  134217728 │ http        │
           │DBG_TRACE_DESPERATE   │ 0x04000000 │ 1073741824 │ desperate   │
           └──────────────────────┴────────────┴────────────┴─────────────┘
همچنین ببینید (SEE ALSO)
       PCPIntro(1), PMAPI(3), pmClearDebug(3), pmGetDebug(3), pmGetOptions(3),
       pmSetDebug(3), pcp.conf(5) و pcp.env(5).

Performance Co-Pilot                  PCP                             PMDBG(1)