PMDBG(1) General Commands Manual PMDBG(1)

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

pmdbg [-l]

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

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

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

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

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

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

پیش از 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

PCPIntro(1), PMAPI(3), pmClearDebug(3), pmGetDebug(3), pmGetOptions(3), pmSetDebug(3), pcp.conf(5) و pcp.env(5).

PCP Performance Co-Pilot