نام (NAME)

keyboxd - مدیریت کلیدهای عمومی برای GnuPG

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

keyboxd [گزینه‌ها] [دستور]

توضیحات (DESCRIPTION)

دستور keyboxd یک سرویس مدیریت کلید عمومی برای GnuPG است.

دستورات (COMMANDS)

دستورات از گزینه‌ها متمایز نیستند، به جز این واقعیت که تنها یک دستور مجاز است.

--version: چاپ نسخه برنامه و اطلاعات مجوز انتشار (لایسنس).
--help: چاپ پیام راهنما که گزینه‌های پرکاربرد خط فرمان را خلاصه می‌کند.
--server: اجرا در حالت سرور و انتظار برای دریافت دستورات روی stdin. حالت پیش‌فرض، ایجاد یک سوکت و شنود دستورات روی آن است. این حالت تنها برای آزمایش استفاده می‌شود.
--daemon: اجرا در حالت دیمن در پس‌زمینه و شنود دستورات روی یک سوکت. این روشی است که keyboxd در صورت نیاز توسط سایر مؤلفه‌های GnuPG راه‌اندازی می‌شود. برای راه‌اندازی اجباری keyboxd عموماً بهتر است از دستور gpgconf --launch keyboxd استفاده شود.
--supervised: اجرا در پیش‌زمینه، ارسال لاگ‌ها به stderr، و شنود روی توصیف‌گر فایل ۳، که باید از پیش به یک سوکت شنود مقید شده باشد. این حالت هنگام اجرا تحت systemd یا سایر طرح‌های مشابه نظارت بر فرایند مفید است. این گزینه در ویندوز پشتیبانی نمی‌شود.

گزینه‌ها (OPTIONS)

توجه داشته باشید که تمامی گزینه‌های بلند به استثنای --options و --homedir را می‌توان پس از حذف دو خط‌تیره ابتدایی در فایل پیکربندی نیز قرار داد.

--options file: خواندن پیکربندی از file به جای فایل پیکربندی پیش‌فرض به ازای هر کاربر. فایل پیکربندی پیش‌فرض ‘keyboxd.conf’ نام دارد و انتظار می‌رود در دایرکتوری خانگی باشد.
--homedir dir: تنظیم نام دایرکتوری خانگی روی dir. این گزینه تنها زمانی مؤثر است که در خط فرمان استفاده شود. پیش‌فرض، دایرکتوری با نام ‘.gnupg’ مستقیماً در زیر دایرکتوری خانگی کاربر است، مگر اینکه متغیر محیطی GNUPGHOME تنظیم شده باشد که در این صورت مقدار آن استفاده خواهد شد. انواع متعددی از داده‌ها در این دایرکتوری ذخیره می‌شوند.
-v
--verbose: نمایش اطلاعات اضافی در حین اجرا. می‌توانید با ارسال چندین گزینه پرگویی به keyboxd، مانند -vv، میزان پرگویی (اطلاعات خروجی) را افزایش دهید.
--log-file file: الحاق تمامی خروجی‌های لاگ به file. این گزینه برای مشاهده آنچه این سرویس در عمل انجام می‌دهد بسیار مفید است. برای ثبت لاگ در یک سوکت از ‘socket://’ استفاده کنید.
--debug-level level: انتخاب سطح اشکال‌زدایی برای بررسی مشکلات. مقدار level می‌تواند یک مقدار عددی یا یک کلمه کلیدی باشد:

none: بدون هیچ‌گونه اشکال‌زدایی. مقداری کمتر از ۱ می‌تواند به جای این کلمه کلیدی استفاده شود.
basic: برخی پیام‌های اشکال‌زدایی پایه. مقداری بین ۱ تا ۲ می‌تواند به جای این کلمه کلیدی استفاده شود.
advanced: پیام‌های اشکال‌زدایی با جزئیات بیشتر. مقداری بین ۳ تا ۵ می‌تواند به جای این کلمه کلیدی استفاده شود.
expert: پیام‌هایی با جزئیات بیشتر. مقداری بین ۶ تا ۸ می‌تواند به جای این کلمه کلیدی استفاده شود.
guru: تمامی پیام‌های اشکال‌زدایی ممکن. مقداری بزرگ‌تر از ۸ می‌تواند به جای این کلمه کلیدی استفاده شود. ایجاد فایل‌های ردگیری درهم‌سازی (هش) تنها در صورتی فعال می‌شود که از این کلمه کلیدی استفاده شود.

نحوه نگاشت این پیام‌ها به فلگ‌های واقعی اشکال‌زدایی مشخص نشده است و ممکن است در نگارش‌های جدیدتر این برنامه تغییر کند. با این حال، آن‌ها با دقت انتخاب شده‌اند تا بیشترین کمک را در اشکال‌زدایی ارائه دهند.

--debug flags: تنظیم فلگ‌های اشکال‌زدایی. این گزینه تنها برای اشکال‌زدایی مفید است و رفتار آن ممکن است در نسخه‌های جدیدتر تغییر کند. تمامی فلگ‌ها با یکدیگر OR منطقی می‌شوند و می‌توانند با ساختار نحوی C (مانند 0x0042) یا به صورت فهرستی از نام‌های فلگ که با کاما جدا شده‌اند مشخص شوند. برای دریافت فهرستی از تمامی فلگ‌های پشتیبانی‌شده، می‌توان از تک‌واژه "help" استفاده کرد.
--debug-all: مشابه با --debug=0xffffffff

فایل‌ها (FILES)

سرویس Keyboxd از یک فایل پیکربندی استفاده می‌کند که عملکرد آن را کنترل می‌نماید. به طور پیش‌فرض، همه آن‌ها را می‌توان در دایرکتوری خانگی فعلی یافت (ببینید: [گزینه --homedir]).

keyboxd.conf: این فایل، فایل پیکربندی استانداردی است که توسط keyboxd هنگام راه‌اندازی خوانده می‌شود. این فایل می‌تواند شامل هر گزینه بلند معتبری باشد؛ دو خط‌تیره ابتدایی نباید وارد شوند و گزینه نباید مخفف شود. این فایل همچنین پس از دریافت یک سیگنال SIGHUP خوانده می‌شود، اگرچه همه گزینه‌ها در عمل مؤثر نخواهند بود. این نام پیش‌فرض را می‌توان در خط فرمان تغییر داد (ببینید: [گزینه --options]). باید از این فایل نسخه پشتیبان تهیه کنید.
pubring.db: این فایل یک پایگاه‌داده در قالب SQLite برای محتوای کلیدهای عمومی است. باید از این فایل نسخه پشتیبان تهیه کنید.

گزارش باگ‌ها (REPORTING BUGS)

لطفاً باگ‌ها را به https://dev.gnupg.org گزارش دهید.

کپی‌رایت (COPYRIGHT)

کپی‌رایت © 2022 بنیاد نرم‌افزار آزاد (Free Software Foundation, Inc.)
مجوز GPLv3+: گنو GPL نسخه ۳ یا بالاتر https://gnu.org/licenses/gpl.html

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

این صفحه راهنما توسط NIIBE Yutaka برای توزیع دبیان (اما قابل استفاده توسط دیگران) با استفاده از صفحه راهنمای dirmngr ایجاد شده است.