'\" t
.\"
.\" Copyright (c) 2024 Ken McDonell.  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 PMLOGBASENAME 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pmlogbasename\f1 \- نام پایه یک بایگانی PCP
.SH "خلاصه دستور (SYNOPSIS)"
\f3pmlogbasename\f1
[\f3\-D\f1 \f2debug\f1]
\f2name\f1
.SH "توضیحات (DESCRIPTION)"
دستور
.B pmlogbasename
مقدار
.I name
(معمولاً نام یکی از فایل‌های فیزیکی در یک بایگانی PCP) را دریافت کرده،
هرگونه پسوند فشرده‌سازی و سپس هرگونه پسوند مربوط به اجزای بایگانی PCP را از آن حذف می‌کند
و در نهایت نتیجه (نام پایه بایگانی PCP) را در خروجی استاندارد گزارش می‌دهد.
.PP
پسوندهای فشرده‌سازی شناخته‌شده برای PCP عبارتند از:
.BR .xz ،
.BR .lzma ،
.BR .bz2 ،
.BR .bz ،
.BR .gz ،
.B .Z
و
.BR .z .
.PP
پسوندهای مؤلفه‌های بایگانی PCP عبارتند از:
.BR .meta ،
.B .index
و
.BI . <n>
برای هر عدد صحیح
.IR <n> .
.PP
در بیشتر موارد، این حذف صرفاً متنی است و
بدون بررسی وجود هیچ‌یک از فایل‌های مرتبط انجام می‌شود؛ با این حال اگر
.I name
با الگوی یک نام فایل معتبر برای بایگانی PCP مطابقت نداشته باشد،
خروجی همان
.I name
بدون هیچ‌گونه حذفی خواهد بود.
.PP
تنها استثنا زمانی است که
.I name
به
.I .N
ختم شود که در آن
.I N
دنباله‌ای از ۱ یا چند رقم است؛ در این حالت ابهام رخ می‌دهد.
برای مثال فرض کنید
.I name
برابر با
.B 20241125.05.48
باشد؛ این می‌تواند به این معنی باشد که نام پایه بایگانی واقعاً
.B 20241125.05.48
است، یا اینکه به شماره جلد
.B 48
از نام پایه بایگانی
.B 20241125.05
اشاره دارد.
در حالت اول، فایل \fIname\fB.meta\fR (یا یکی از نسخه‌های فشرده‌شده آن) باید وجود داشته باشد و
.I pmlogbasename
سیستم‌فایل را بررسی می‌کند تا مشخص کند آیا چنین فایلی وجود دارد یا خیر.
.SH "گزینه‌های اشکال‌زدایی (DEBUGGING OPTIONS)"
گزینه
.B \-D
یا
.B \-\-debug
خروجی عیب‌یابی اضافی را روی
.I stderr
فعال می‌کند تا به بررسی و اولویت‌بندی مشکلات کمک کند، هرچند این اطلاعات گاهی پیچیده و مبهم است و
در درجه اول برای راهنمایی توسعه‌دهندگان در نظر گرفته شده است تا کاربران نهایی.
.I debug
فهرستی از گزینه‌های اشکال‌زدایی است که با کاما از هم جدا شده‌اند؛ از
.BR pmdbg (1)
همراه با گزینه
.B \-l
برای به‌دست آوردن فهرستی از گزینه‌های اشکال‌زدایی موجود و معانی آن‌ها استفاده کنید.
.PP
گزینه‌های اشکال‌زدایی مخصوص به
.B pmlogbasename
به شرح زیر است:
.TS
box;
lf(B) | lf(B)
lf(B) | lxf(R) .
گزینه	توضیحات
_
appl0	T{
گزارش نام هر فایلی که وجود دارد و احتمالاً با \fIname\fP مطابقت دارد
T}
_
appl1	T{
گزارش نام هر فایلی که وجود \fBندارد\fP اما هنگام جستجو برای مطابقت با \fIname\fP بررسی شده است
T}
.TE
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1)
و
.BR LOGARCHIVE (5).

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