نام (NAME)

gpg-check-pattern - بررسی و اعتبارسنجی گذرواژه استاندارد در برابر فایل الگو

خلاصه دستور (SYNOPSIS)

gpg-check-pattern [گزینه‌ها] patternfile

توضیحات (DESCRIPTION)

دستور gpg-check-pattern یک عبارت عبور (passphrase) ارائه‌شده در ورودی استاندارد (stdin) را در برابر یک فایل الگوی مشخص‌شده بررسی می‌کند.

فایل الگو سطرمحور است و خطوط توضیحات در اولین ستون با نویسه # آغاز می‌شوند. خطوط خالی و خطوطی که فقط شامل فاصله‌های خالی هستند نادیده گرفته می‌شوند. سطرهای اصلی الگو می‌توانند به صورت الگوی رشته‌ای دقیق (verbatim) باشند و همان‌طور که هستند مطابقت داده شوند (فاصله‌های انتهایی نادیده گرفته می‌شوند) یا به صورت عبارت‌های منظم گسترده (extended regular expressions) باشند که با یک / یا !/ در ستون اول مشخص شده و با یک / دیگر یا انتهای سطر خاتمه می‌یابند. اگر یک عبارت منظم با !/ شروع شود، نتیجه تطابق معکوس می‌شود. به‌طور پیش‌فرض تمام مقایسه‌ها بدون توجه به بزرگی و کوچکی حروف (case-insensitive) انجام می‌شوند.

سطرهای برچسب (Tag lines) می‌توانند برای کنترل بیشتر عملکرد این ابزار مورد استفاده قرار گیرند. برچسب‌هایی که در حال حاضر تعریف شده‌اند عبارتند از:

[icase]

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

[case]

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

[reject]

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

[accept]

تغییر به حالت پذیرش (accept mode).

در آینده ممکن است برچسب‌های بیشتری اضافه شوند و بنابراین توصیه می‌شود که یک رشته الگوی ساده را با براکت باز شروع نکنید. برچسب‌ها باید دقیقاً در یک سطر جداگانه و بدون هیچ فاصله‌ای در سمت چپ یا هرگونه نویسه غیرفاصله‌ای در سمت راست قرار گیرند.

در حالت رد کردن (reject mode)، برنامه با اولین تطابق، با کد خروج ۱ (شکست) خارج می‌شود. اگر در انتهای فهرست الگوها حالت رد کردن همچنان فعال باشد، برنامه با کد خروج ۰ (موفقیت) خارج می‌شود.

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

گزینه‌ها (OPTIONS)

--verbose

فعال‌سازی خروجی اطلاعاتی بیشتر و باجزئیات.

--check

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

--null

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

همچنین ببینید (SEE ALSO)

gpg-agent(1)

مستندات کامل این ابزار در قالب یک راهنمای Texinfo نگهداری می‌شود. اگر GnuPG و برنامه info به درستی در سامانه شما نصب شده باشند، دستور

info gnupg

باید دسترسی شما را به راهنمای کامل شامل ساختار منو و نمایه فراهم کند.