'\" t
'\"macro stdmacro
.\"
.\" Copyright (c) 2000 Silicon Graphics, Inc.  All Rights Reserved.
.\"
.\" This program is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License as published by the
.\" Free Software Foundation; either version 2 of the License, or (at your
.\" option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful, but
.\" WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
.\" or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
.\" for more details.
.\"
.\"
.TH PMDBG 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
pmdbg \- گزارش گزینه‌های اشکال‌زدایی Performance Co-Pilot
.SH "خلاصه دستور (SYNOPSIS)"
\f3pmdbg\f1
[\f3\-l\f1]
.SH "توضیحات (DESCRIPTION)"
مؤلفه‌های Performance Co-Pilot (PCP) از یک سازوکار سراسری برای کنترل خروجی‌های تشخیصی و اشکال‌زدایی استفاده می‌کنند.
.PP
دستور
.B pmdbg
تمامی گزینه‌های اشکال‌زدایی موجود را به همراه نام گزینه و توضیحی کوتاه درباره آن نمایش می‌دهد.
.PP
گزینه
.B \-l
هیچ عملی انجام نمی‌دهد و تنها برای سازگاری با نسخه‌های قدیمی‌تر
.B pmdbg
گنجانده شده است.
.PP
بیشتر برنامه‌هایی که از قابلیت‌های PCP بهره می‌برند، از نحو خط فرمان
\f3\-D\f1 \f2name\f1[,\f2name\f1 ...]
برای فعال‌سازی کنترل اشکال‌زدایی بر اساس نام گزینه‌های اشکال‌زدایی مورد نظر پشتیبانی می‌کنند.
.PP
همچنین، مقدار اولیه پرچم‌های کنترل اشکال‌زدایی می‌تواند از طریق متغیر محیطی
.B $PCP_DEBUG
به صورت فهرستی از نام گزینه‌ها که با کاما از هم جدا شده‌اند تنظیم شود، به شرطی که برنامه‌ها برای پردازش گزینه‌ها و آرگومان‌های خط فرمان از
.BR pmGetOptions (3)
استفاده کنند.
اگر از هر دو سازوکار استفاده شود، تأثیر آن‌ها تجمعی خواهد بود؛ یعنی پرچم‌های نهایی حاصل ترکیب مقادیر تنظیم‌شده از طریق
.B $PCP_DEBUG
و گزینه‌های خط فرمان
.B \-D
خواهد بود.
.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند \fBPCP_\fP برای پارامتریک‌سازی نام فایل‌ها و دایرکتوری‌های مورد استفاده PCP به کار می‌روند.
در هر نصب، فایل
\fI/etc/pcp.conf\fP
شامل مقادیر محلی این متغیرها است.
متغیر \fB$PCP_CONF\fP می‌تواند برای مشخص کردن فایل پیکربندی جایگزین استفاده شود، همان‌طور که در
\fBpcp.conf\fP(5)
شرح داده شده است.
.SH "سازگاری (COMPATIBILITY)"
پیش از PCP 7.0، گزینه‌های اشکال‌زدایی در یک حالت دوگانه نگهداری می‌شدند: یک عدد صحیح کدگذاری‌شده دودویی به سبک قدیمی (به همراه نام ماکرو برای برنامه‌نویسان) و یک نام رشته‌ای نویسه‌ای به سبک جدید برای هر گزینه اشکال‌زدایی.
.PP
در PCP 7.0، پشتیبانی از سبک قدیمی متوقف شد.
.PP
جدول زیر معادل‌های مربوط به گزینه‌های اشکال‌زدایی را که در هر دو سبک قدیم و جدید وجود داشتند مستند می‌کند.
.TS
box center;
c   s   s | c
l | r | r | l.
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
.TE
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1),
.BR PMAPI (3),
.BR pmClearDebug (3),
.BR pmGetDebug (3),
.BR pmGetOptions (3),
.BR pmSetDebug (3),
.BR pcp.conf (5)
و
.BR pcp.env (5).