نام (NAME)

keyart - تولید هنر اسکی (ASCII art) از یک کلید OpenPGP

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

keyart [-c|--color] [-l|--longid] [-f|--fingerprint HEX [-f|--fingerprint HEX ...]] [-k|--keyring KEYRING [-k|--keyring KEYRING ...]] [KEYID ...]

توضیحات (DESCRIPTION)

keyart یک نمایش هنر اسکی (ASCII art) از کلیدهای عمومی OpenPGP تولید می‌کند. این هنر یک پیاده‌سازی از الگوریتم «اسقف مست» (Drunken Bishop) نوشتهٔ Dirk Loss است. مستندات مربوط به این الگوریتم را می‌توان در مسیر /usr/share/doc/signing-party/keyart/ یا مسیر مناسب توزیع شما یافت.

دستور keyart از چاپ هنر اسکی در هر دو حالت متن ساده (پیش‌فرض) و رنگ‌های ANSI پشتیبانی می‌کند. در حالت رنگی ANSI از یک «نقشه حرارتی» (heat map) استفاده می‌شود که در آن رنگ‌های سرد (آبی) نشان‌دهنده خانه‌هایی از اتاق هستند که اسقف مست به‌ندرت از آن‌ها عبور کرده است و رنگ‌های گرم (قرمز) نشان‌دهنده خانه‌هایی هستند که اسقف مست مرتباً از آن‌ها بازدید کرده است. نسبت رنگ به نویسهٔ چاپ‌شده ۱:۱ است.

شناسه‌های KEYID همان شناسه کلیدها هستند (اثر انگشت، keyid، شناسه کاربری و غیره؛ برای جزئیات به gpg(1) مراجعه کنید). اگر هیچ KEYID مشخص نشود، keyart برای تمامی کلیدهای یافت‌شده یک نمایش هنر اسکی تولید می‌کند.

گزینه‌ها (OPTIONS)

-c | --color

چاپ هنر اسکی با استفاده از رنگ‌های ANSI در ترمینال.

-l | --longid

چاپ شناسه بلند ۱۶ نویسه‌ای یک کلید OpenPGP در نشان پاورقی. حالت پیش‌فرض چاپ شناسه کوتاه ۸ نویسه‌ای است. اگر گزینهٔ «-f | --fingerprint HEX» داده شده باشد، این گزینه بدون اخطار نادیده گرفته می‌شود.

-f | --fingerprint HEX

هر رشتهٔ هگزادسیمال دلخواه با هر طولی. می‌تواند یک چکسام هگزادسیمال MD5، SHA1، SHA2 یا SHA3 باشد. برای مقایسه و تحلیل تداخل‌ها و تصادم‌های احتمالی با کلیدهای موجود مفید است. این گزینه می‌تواند چندین بار تکرار شود.

-k | --keyring KEYRING

یک فایل کلید عمومی یا دسته‌کلید (keyring) متعلق به OpenPGP که مقادیر KEYID باید از آن استخراج شوند. اگر این گزینه ارائه نشود، مقادیر KEYID از دسته‌کلید پیش‌فرض GnuPG (معمولاً ~/.gnupg/pubring.gpg) یافت می‌شوند؛ اگر چندین بار تکرار شود، مقادیر KEYRING ارائه‌شده به عنوان منابع متوالی استفاده خواهند شد.

-h | --help

چاپ پیام راهنما و خروج.

محیط (ENVIRONMENT)

HOME

تنظیم دایرکتوری خانگی پیش‌فرض.

GNUPGBIN

تعیین باینری gpg. پیش‌فرض: "gpg".

GNUPGHOME

تنظیم دایرکتوری کاری پیش‌فرض برای gpg. پیش‌فرض: "~/.gnupg".

وضعیت خروج (EXIT STATUS)

0

دستور keyart با موفقیت اجرا شد.

1

برنامه gpg(1) یا gpg2(1) نصب نشده است.

2

رشته هگزادسیمال ارائه‌شده مضربی از ۸ بایت نیست.

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

gpg(1)

نویسندگان (AUTHORS)

keyart و مستندات آن توسط Aaron Toponce <aaron.toponce@gmail.com> نوشته شده است.