'\"macro stdmacro
.\"
.\" Copyright (c) 2018,2025 Red Hat.
.\"
.\" 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 PMJSON 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pmjson\f1 \- ابزار استخراج و نمایش JSON در Performance Co-Pilot
.SH "خلاصه دستور (SYNOPSIS)"
\f3pmjson\f1
[\f3\-mnpqyV?\f1]
[\f3\-D\f1 \f2debug\f1]
[\f3\-i\f1 \f2infile\f1]
[\f3\-o\f1 \f2outfile\f1]
.SH "توضیحات (DESCRIPTION)"
ابزار
.B pmjson
برای پردازش و تغییر متون قالب‌بندی‌شده با JSON (JavaScript Object Notation) که در Performance Co-Pilot (جعبه‌ابزار PCP) به کار می‌روند، استفاده می‌شود.
این ابزار در صورت دریافت ورودی معتبر JSON، می‌تواند خروجی‌هایی با قالب کمینه (فشرده) یا خوانا برای انسان تولید کند.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های خط فرمان موجود عبارتند از:
.TP 5
\fB\-i\fR \fIinfile\fR, \fB\-\-in\fR=\fIinfile\fR
ورودی با قالب JSON در
.I infile
\- مسیر فایلی که ورودی باید از آن خوانده شود.
اگر این گزینه مشخص نشود،
.B pmjson
از جریان ورودی استاندارد خواهد خواند.
.TP
\fB\-m\fR, \fB\-\-minimal\fR
تولید خروجی JSON با حذف تمام فاصله‌های خالی زائد از رشته JSON حاصل.
.TP
\fB\-o\fR \fIoutfile\fR, \fB\-\-out\fR=\fIoutfile\fR
خروجی قالب‌بندی‌شده در
.IR outfile
تعیین‌شده نوشته می‌شود.
اگر این گزینه مشخص نشود،
.B pmjson
در جریان خروجی استاندارد خواهد نوشت.
.TP
\fB\-n\fR, \fB\-\-not-pretty\fR
تولید خروجی JSON در قالبی خام و تک‌رنگ (پیش‌فرض در حالتی که خروجی به یک فایل فرستاده می‌شود).
.TP
\fB\-p\fR, \fB\-\-pretty\fR
تولید خروجی JSON در قالبی خوانا برای انسان (پیش‌فرض در حالتی که خروجی به یک ترمینال فرستاده می‌شود).
.TP
\fB\-q\fR, \fB\-\-quiet\fR
تنها معتبر بودن ورودی به عنوان JSON را بررسی می‌کند و هیچ خروجی‌ای تولید نمی‌شود.
.TP
\fB\-V\fR, \fB\-\-version\fR
نمایش شماره نسخه و خروج.
.TP
\fB\-y\fR, \fB\-\-yaml\fR
تولید خروجی مشابه YAML؛ قالبی خوانا برای انسان با نشانه‌گذاری‌های نحوی کمتر نسبت به JSON.
.TP
\fB\-?\fR, \fB\-\-help\fR
نمایش پیام راهنما و خروج.
.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند \fBPCP_\fP برای تعیین نام فایل‌ها و دایرکتوری‌های مورد استفاده توسط PCP به کار می‌روند.
در هر نصب، فایل \fI/etc/pcp.conf\fP حاوی مقادیر محلی برای این متغیرها است.
متغیر \fB$PCP_CONF\fP ممکن است برای تعیین یک فایل پیکربندی جایگزین استفاده شود، همان‌طور که در \fBpcp.conf\fP(5) شرح داده شده است.
.SH "گزینه‌های اشکال‌زدایی (DEBUGGING OPTIONS)"
گزینه
.B \-D
یا
.B \-\-debug
چاپ پیام‌های تشخیصی اضافی را در
.I stderr
برای کمک به ریشه‌یابی مشکلات فعال می‌کند، اگرچه این اطلاعات گاهی مبهم است و در وهله اول به منظور راهنمایی توسعه‌دهندگان در نظر گرفته شده تا کاربران نهایی.
.I debug
یک فهرست جدا شده با کاما از گزینه‌های اشکال‌زدایی است؛ از
.BR pmdbg (1)
همراه با گزینه
.B \-l
برای به‌دست آوردن فهرستی از گزینه‌های اشکال‌زدایی موجود و معانی آن‌ها استفاده کنید.
.SH "همچنین ببینید (SEE ALSO)"
.BR PMWEBAPI (3),
.BR pcp.conf (5)
و
.BR pcp.env (5).

.\" control lines for scripts/man-spell
.\" +ok+ YAML