.TH KEYBOXD 8 "مارس ۲۰۲۲" "kbxutil (GnuPG) 2.4.1" "دستورات مدیریت سیستم" .SH "نام (NAME)" keyboxd \- مدیریت کلیدهای عمومی برای GnuPG .SH "خلاصه دستور (SYNOPSIS)" .B keyboxd [\fIگزینه‌ها\fR] [\fIدستور\fR] .SH "توضیحات (DESCRIPTION)" دستور \fBkeyboxd\fR یک سرویس مدیریت کلید عمومی برای GnuPG است. .SH "دستورات (COMMANDS)" دستورات از گزینه‌ها متمایز نیستند، به جز این واقعیت که تنها یک دستور مجاز است. .TP .B \-\-version چاپ نسخه برنامه و اطلاعات مجوز انتشار (لایسنس). .TP .B \-\-help چاپ پیام راهنما که گزینه‌های پرکاربرد خط فرمان را خلاصه می‌کند. .TP .B \-\-server اجرا در حالت سرور و انتظار برای دریافت دستورات روی .BR stdin . حالت پیش‌فرض، ایجاد یک سوکت و شنود دستورات روی آن است. این حالت تنها برای آزمایش استفاده می‌شود. .TP .B \-\-daemon اجرا در حالت دیمن در پس‌زمینه و شنود دستورات روی یک سوکت. این روشی است که .B keyboxd در صورت نیاز توسط سایر مؤلفه‌های GnuPG راه‌اندازی می‌شود. برای راه‌اندازی اجباری .B keyboxd عموماً بهتر است از دستور .B gpgconf \-\-launch keyboxd استفاده شود. .TP .B \-\-supervised اجرا در پیش‌زمینه، ارسال لاگ‌ها به stderr، و شنود روی توصیف‌گر فایل ۳، که باید از پیش به یک سوکت شنود مقید شده باشد. این حالت هنگام اجرا تحت systemd یا سایر طرح‌های مشابه نظارت بر فرایند مفید است. این گزینه در ویندوز پشتیبانی نمی‌شود. .SH "گزینه‌ها (OPTIONS)" توجه داشته باشید که تمامی گزینه‌های بلند به استثنای .B \-\-options و .B \-\-homedir را می‌توان پس از حذف دو خط‌تیره ابتدایی در فایل پیکربندی نیز قرار داد. .TP .B \-\-options \fIfile\fR خواندن پیکربندی از .I file به جای فایل پیکربندی پیش‌فرض به ازای هر کاربر. فایل پیکربندی پیش‌فرض \(oq\fIkeyboxd.conf\fR\(cq نام دارد و انتظار می‌رود در دایرکتوری خانگی باشد. .TP .B \-\-homedir \fIdir\fR تنظیم نام دایرکتوری خانگی روی .IR dir . این گزینه تنها زمانی مؤثر است که در خط فرمان استفاده شود. پیش‌فرض، دایرکتوری با نام \(oq\fI.gnupg\fR\(cq مستقیماً در زیر دایرکتوری خانگی کاربر است، مگر اینکه متغیر محیطی .B GNUPGHOME تنظیم شده باشد که در این صورت مقدار آن استفاده خواهد شد. انواع متعددی از داده‌ها در این دایرکتوری ذخیره می‌شوند. .TP .B \-v .TP .B \-\-verbose نمایش اطلاعات اضافی در حین اجرا. می‌توانید با ارسال چندین گزینه پرگویی به .BR keyboxd ، مانند .BR \-vv ، میزان پرگویی (اطلاعات خروجی) را افزایش دهید. .TP .B \-\-log\-file \fIfile\fR الحاق تمامی خروجی‌های لاگ به .IR file . این گزینه برای مشاهده آنچه این سرویس در عمل انجام می‌دهد بسیار مفید است. برای ثبت لاگ در یک سوکت از \(oq\fIsocket://\fR\(cq استفاده کنید. .TP .B \-\-debug\-level \fIlevel\fR انتخاب سطح اشکال‌زدایی برای بررسی مشکلات. مقدار .I level می‌تواند یک مقدار عددی یا یک کلمه کلیدی باشد: .RS .TP .B none بدون هیچ‌گونه اشکال‌زدایی. مقداری کمتر از ۱ می‌تواند به جای این کلمه کلیدی استفاده شود. .TP .B basic برخی پیام‌های اشکال‌زدایی پایه. مقداری بین ۱ تا ۲ می‌تواند به جای این کلمه کلیدی استفاده شود. .TP .B advanced پیام‌های اشکال‌زدایی با جزئیات بیشتر. مقداری بین ۳ تا ۵ می‌تواند به جای این کلمه کلیدی استفاده شود. .TP .B expert پیام‌هایی با جزئیات بیشتر. مقداری بین ۶ تا ۸ می‌تواند به جای این کلمه کلیدی استفاده شود. .TP .B guru تمامی پیام‌های اشکال‌زدایی ممکن. مقداری بزرگ‌تر از ۸ می‌تواند به جای این کلمه کلیدی استفاده شود. ایجاد فایل‌های ردگیری درهم‌سازی (هش) تنها در صورتی فعال می‌شود که از این کلمه کلیدی استفاده شود. .RE .PP نحوه نگاشت این پیام‌ها به فلگ‌های واقعی اشکال‌زدایی مشخص نشده است و ممکن است در نگارش‌های جدیدتر این برنامه تغییر کند. با این حال، آن‌ها با دقت انتخاب شده‌اند تا بیشترین کمک را در اشکال‌زدایی ارائه دهند. .TP .B \-\-debug \fIflags\fR تنظیم فلگ‌های اشکال‌زدایی. این گزینه تنها برای اشکال‌زدایی مفید است و رفتار آن ممکن است در نسخه‌های جدیدتر تغییر کند. تمامی فلگ‌ها با یکدیگر OR منطقی می‌شوند و می‌توانند با ساختار نحوی C (مانند 0x0042) یا به صورت فهرستی از نام‌های فلگ که با کاما جدا شده‌اند مشخص شوند. برای دریافت فهرستی از تمامی فلگ‌های پشتیبانی‌شده، می‌توان از تک‌واژه "help" استفاده کرد. .TP .B \-\-debug\-all مشابه با .B \-\-debug=0xffffffff .SH "فایل‌ها (FILES)" سرویس Keyboxd از یک فایل پیکربندی استفاده می‌کند که عملکرد آن را کنترل می‌نماید. به طور پیش‌فرض، همه آن‌ها را می‌توان در دایرکتوری خانگی فعلی یافت (ببینید: [گزینه .BR \-\-homedir ]). .TP .B keyboxd.conf این فایل، فایل پیکربندی استانداردی است که توسط .B keyboxd هنگام راه‌اندازی خوانده می‌شود. این فایل می‌تواند شامل هر گزینه بلند معتبری باشد؛ دو خط‌تیره ابتدایی نباید وارد شوند و گزینه نباید مخفف شود. این فایل همچنین پس از دریافت یک سیگنال .B SIGHUP خوانده می‌شود، اگرچه همه گزینه‌ها در عمل مؤثر نخواهند بود. این نام پیش‌فرض را می‌توان در خط فرمان تغییر داد (ببینید: [گزینه .BR \-\-options ]). باید از این فایل نسخه پشتیبان تهیه کنید. .TP .B pubring.db این فایل یک پایگاه‌داده در قالب SQLite برای محتوای کلیدهای عمومی است. باید از این فایل نسخه پشتیبان تهیه کنید. .SH "گزارش باگ‌ها (REPORTING BUGS)" لطفاً باگ‌ها را به گزارش دهید. .SH "کپی‌رایت (COPYRIGHT)" کپی‌رایت \(co 2022 بنیاد نرم‌افزار آزاد (Free Software Foundation, Inc.) .br مجوز GPLv3+: گنو GPL نسخه ۳ یا بالاتر .PP این یک نرم‌افزار آزاد است: شما در ویرایش و بازتوزیع آن آزاد هستید. هیچ‌گونه ضمانتی وجود ندارد، تا حدی که قانون اجازه می‌دهد. .PP این صفحه راهنما توسط .B NIIBE Yutaka برای توزیع دبیان (اما قابل استفاده توسط دیگران) با استفاده از صفحه راهنمای dirmngr ایجاد شده است.