نام (NAME)

wkd-exporter - صادرکنندهٔ WKD (دایرکتوری کلید وب)

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

wkd-exporter [--domain] [--append] [--direct] [-h|--help] <WELL_KNOWN>

توضیحات (DESCRIPTION)

صادرکنندهٔ WKD.

یک جاکلیدی (keyring) داده‌شدهٔ OpenPGP را به ساختار دایرکتوری مورد نیاز مشخصات دایرکتوری کلید وب (Web Key Directory) صادر می‌کند.

گزینه‌ها (OPTIONS)

--domain <DOMAIN>

فقط دامنهٔ زیر را صادر می‌کند (می‌تواند چندین بار مشخص شود).

به‌طور پیش‌فرض همهٔ دامنه‌ها صادر می‌شوند، اما در صورت مشخص شدن این گزینه تنها دامنه‌های انتخاب‌شده صادر خواهند شد.

--append

الحاق گواهی‌های ورودی به مواردی که از پیش در `.well-known` وجود دارند.

اگر چندین گواهی حاوی local-part یکسان دارید و می‌خواهید همگی بخشی از خروجی WKD باشند، این گزینه را فعال کنید.

توجه داشته باشید که اجرای دوبارهٔ همین فرایند با append و همان دایرکتوری `.well-known`، گواهی‌های آنجا را تکراری خواهد کرد.

--direct <DIRECT>

انتخاب حالت مستقیم (direct) دایرکتوری کلید وب (WKD) همراه با فیلتر برای این تک‌دامنه

-h, --help

چاپ راهنما (مشاهدهٔ خلاصه‌ای با '-h')

<WELL_KNOWN>

دایرکتوری well-known که خروجی فرایند صدور در آن قرار خواهد گرفت

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

در صورت موفقیت، برنامه مقدار 0 را برمی‌گرداند.

در صورت شکست، کدهای خروج زیر استفاده می‌شوند:

2

پردازش داده‌های OpenPGP ناموفق بود.

3

خواندن یا نوشتن فایل‌ها ناموفق بود.

مثال‌ها (EXAMPLES)

برای استقرارهای بزرگ‌تر، استفاده از حالت پیشرفته (advanced) با یک فیلتر دامنه توصیه می‌شود:

```sh
$ DIR=$(mktemp -d)
$ gpg --export | wkd-exporter --append --domain archlinux.org $DIR
$ tree $DIR | head
/tmp/tmp.ZaHdlAQGRw
└── openpgpkey
└── archlinux.org
├── hu
│   ├── 46yqwra65to1p94e9ebafpucymkwsi7f
│   ├── 9drt4xorn699rkbj5xyq7ykoc1z5nnof
│   ├── 9hy3wi4ewwiicomnjmhewifn6d1gi87i
│   ├── 9sh859e31bn46hmfxyftn3ymop5ewdkz
│   ├── b9qi357oeysqibkxmmh3hanrppd6nj9p
│   ├── btfkn1ht1kzda3e9495fe4sjznkygui4
```

برای استقرارهای کوچک‌تر، حالت مستقیم (direct) ممکن است مناسب‌تر باشد:

```sh
$ DIR=$(mktemp -d)
$ gpg --export | wkd-exporter --append --direct metacode.biz $DIR
$ tree $DIR | head
/tmp/tmp.cxEBeXnwdv
└── openpgpkey
├── hu
│ └── gebusffkx9g581i6ch4t3ewgwd6dctmp
└── policy
```

ثبت وقایع (logging) را می‌توان با استفاده از متغیر محیطی `RUST_LOG` فعال کرد (برای نمونه `RUST_LOG=wkd_exporter=debug` ثبت وقایع را در سطح اشکال‌زدایی فعال می‌کند).
خطاها بدون توجه به سطح گزارش‌گیری، همیشه ثبت می‌شوند و وضعیت خروج، نوع خطا را مشخص می‌کند.

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

لطفاً تمام باگ‌ها را به https://gitlab.archlinux.org/archlinux/wkd-exporter گزارش دهید

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

Wiktor Kwapisiewicz <wiktor@metacode.biz>

کپی‌رایت و تکثیر (COPYRIGHT)

MIT OR Apache-2.0