.TH "GPG-CHECK-PATTERN" "1" "2025-02-19" "GnuPG 2.4.9" "GNU Privacy Guard 2.4"
.SH "نام (NAME)"
gpg-check-pattern \- بررسی و اعتبارسنجی گذرواژه استاندارد در برابر فایل الگو
.SH "خلاصه دستور (SYNOPSIS)"
.B gpg\-check\-pattern
[\fIگزینه‌ها\fR]
.I patternfile

.SH "توضیحات (DESCRIPTION)"
دستور
\fBgpg\-check\-pattern\fP
یک عبارت عبور (passphrase) ارائه‌شده در ورودی استاندارد (stdin) را در برابر یک فایل الگوی مشخص‌شده بررسی می‌کند.
.PP
فایل الگو سطرمحور است و خطوط توضیحات در
\fIاولین\fP
ستون با نویسه
.B #
آغاز می‌شوند. خطوط خالی و خطوطی که فقط شامل فاصله‌های خالی هستند نادیده گرفته می‌شوند. سطرهای اصلی الگو می‌توانند به صورت الگوی رشته‌ای دقیق (verbatim) باشند و همان‌طور که هستند مطابقت داده شوند (فاصله‌های انتهایی نادیده گرفته می‌شوند) یا به صورت عبارت‌های منظم گسترده (extended regular expressions) باشند که با یک
.B /
یا
.B !/
در ستون اول مشخص شده و با یک
.B /
دیگر یا انتهای سطر خاتمه می‌یابند. اگر یک عبارت منظم با
.B !/
شروع شود، نتیجه تطابق معکوس می‌شود. به‌طور پیش‌فرض تمام مقایسه‌ها بدون توجه به بزرگی و کوچکی حروف (case-insensitive) انجام می‌شوند.
.PP
سطرهای برچسب (Tag lines) می‌توانند برای کنترل بیشتر عملکرد این ابزار مورد استفاده قرار گیرند. برچسب‌هایی که در حال حاضر تعریف شده‌اند عبارتند از:

.TP
.B [icase]
تغییر به مقایسه بدون توجه به بزرگی و کوچکی حروف برای تمام الگوهای بعدی. این حالت پیش‌فرض است.

.TP
.B [case]
تغییر به مقایسه حساس به بزرگی و کوچکی حروف برای تمام الگوهای بعدی.

.TP
.B [reject]
تغییر به حالت رد کردن (reject mode). این حالت پیش‌فرض است.

.TP
.B [accept]
تغییر به حالت پذیرش (accept mode).
.PP
در آینده ممکن است برچسب‌های بیشتری اضافه شوند و بنابراین توصیه می‌شود که یک رشته الگوی ساده را با براکت باز شروع نکنید. برچسب‌ها باید دقیقاً در یک سطر جداگانه و بدون هیچ فاصله‌ای در سمت چپ یا هرگونه نویسه غیرفاصله‌ای در سمت راست قرار گیرند.
.PP
در حالت رد کردن (reject mode)، برنامه با اولین تطابق، با کد خروج ۱ (شکست) خارج می‌شود. اگر در انتهای فهرست الگوها حالت رد کردن همچنان فعال باشد، برنامه با کد خروج ۰ (موفقیت) خارج می‌شود.
.PP
در حالت پذیرش (accept mode)، از بلوک‌های الگو استفاده می‌شود. یک بلوک با الگوی بعدی پس از یک برچسب "accept" آغاز می‌شود و با آخرین الگوی قبل از برچسب "accept" یا "reject" بعدی یا در انتهای فهرست الگوها خاتمه می‌یابد. اگر تمام الگوهای درون یک بلوک مطابقت داشته باشند، برنامه با کد خروج ۰ (موفقیت) خارج می‌شود. اگر هر الگویی در یک بلوک مطابقت نداشته باشد، بلوک الگوی بعدی ارزیابی می‌شود. اگر در انتهای فهرست الگوها حالت پذیرش همچنان فعال باشد، برنامه با کد خروج ۱ (شکست) خارج می‌شود.

.SH "گزینه‌ها (OPTIONS)"
.TP
.B \-\-verbose
فعال‌سازی خروجی اطلاعاتی بیشتر و باجزئیات.

.TP
.B \-\-check
فقط اجرای بررسی نحوی (syntax check) روی فایل الگو.

.TP
.B \-\-null
ورودی به صورت جداشده با نویسه پوچ یا تهی (null delimited) در نظر گرفته می‌شود.

.SH "همچنین ببینید (SEE ALSO)"
.BR gpg\-agent (1)
.PP
مستندات کامل این ابزار در قالب یک راهنمای Texinfo نگهداری می‌شود. اگر GnuPG و برنامه info به درستی در سامانه شما نصب شده باشند، دستور
.PP
.RS 2
.nf
info gnupg
.fi
.RE
.PP
باید دسترسی شما را به راهنمای کامل شامل ساختار منو و نمایه فراهم کند.