.\" Created from Texinfo source by yat2m 1.61-unknown
.TH GPG-WKS-CLIENT 1 2025-02-19 "GnuPG 2.4.9" "GNU Privacy Guard 2.4"
.SH "نام (NAME)"
gpg\-wks\-client \- سرویس‌گیرنده پروتکل خدمات وب کلید (Web Key Service)
.SH "خلاصه دستور (SYNOPSIS)"
.B gpg\-wks\-client
.RI [ گزینه‌ها ]
.B \-\-supported
.I user-id
.br
.B gpg\-wks\-client
.RI [ گزینه‌ها ]
.B \-\-check
.I user-id
.br
.B gpg\-wks\-client
.RI [ گزینه‌ها ]
.B \-\-create
.I fingerprint
.I user-id
.br
.B gpg\-wks\-client
.RI [ گزینه‌ها ]
.B \-\-receive
.br
.B gpg\-wks\-client
.RI [ گزینه‌ها ]
.B \-\-read
.br
.B gpg\-wks\-client
.RI [ گزینه‌ها ]
.B \-\-mirror
.br
.B gpg\-wks\-client
.RI [ گزینه‌ها ]
.B \-\-install\-key
.br
.B gpg\-wks\-client
.RI [ گزینه‌ها ]
.B \-\-remove\-key
.br
.B gpg\-wks\-client
.RI [ گزینه‌ها ]
.B \-\-print\-wkd\-hash
.br
.B gpg\-wks\-client
.RI [ گزینه‌ها ]
.B \-\-print\-wkd\-url

.SH "توضیحات (DESCRIPTION)"
دستور \fBgpg\-wks\-client\fP برای ارسال درخواست‌ها به یک ارائه‌دهنده سرویس کلید وب (Web Key Service یا WKS) استفاده می‌شود. این کار معمولاً به منظور بارگذاری یک کلید در یک دایرکتوری کلید وب (Web Key Directory یا WKD) انجام می‌گیرد.
.PP
با دستور \fB\-\-supported\fP فراخواننده می‌تواند بررسی کند که آیا یک وبگاه از سرویس کلید وب پشتیبانی می‌کند یا خیر. آرگومان این دستور، یک نشانی دلخواه در دامنه‌ای است که باید آزموده شود؛ به عنوان مثال
\(oq\fIfoo@example.net\fP\(cq.
در صورت پشتیبانی از سرویس کلید وب، این دستور وضعیت موفقیت را بازمی‌گرداند. این عملیات در حالت بی‌صدا اجرا می‌شود؛ برای دریافت خروجی تشخیصی از گزینه
.B \-\-verbose
استفاده کنید. همچنین برای شکلی دیگر از خروجی این دستور، گزینه
.B \-\-with\-colons
را ببینید.
.PP
با دستور \fB\-\-check\fP فراخواننده می‌تواند بررسی کند که آیا برای یک نشانی ایمیل مشخص، کلیدی وجود دارد یا خیر. اگر کلید در دسترس باشد، دستور با موفقیت بازمی‌گردد.
.PP
دستور \fB\-\-create\fP برای ارسال یک درخواست انتشار در دایرکتوری کلید وب به کار می‌رود. آرگومان‌های آن، اثر انگشت (fingerprint) کلید و شناسه کاربری (user id) مورد نظر برای انتشار هستند. خروجی این دستور، یک ایمیل با قالب‌بندی صحیح همراه با تمامی سرآیندهای استاندارد است. این ایمیل می‌تواند به
.BR sendmail (8)
یا هر ابزار دیگری جهت ارسال واقعی تحویل داده شود. در صورت نصب بودن
.BR sendmail (8)
می‌توان از گزینه
.B \-\-send
برای ارسال مستقیم درخواست ایجادشده استفاده کرد. اگر ارائه‌دهنده یک شناسه کاربری «تنها صندوق پستی» (mailbox-only) درخواست کند و چنین شناسه‌ای یافت نشود،
\fBgpg\-wks\-client\fP
یک شناسه کاربری اضافی را امتحان خواهد کرد.
.PP
دستورات \fB\-\-receive\fP و \fB\-\-read\fP برای پردازش ایمیل‌های تاییدیه‌ای که از طرف ارائه‌دهنده سرویس ارسال شده‌اند استفاده می‌شوند. اولی انتظار یک پیام رمزگذاری‌شده MIME را دارد و دومی یک پیام از پیش رمزگشایی‌شده MIME را می‌پذیرد. نتیجه این دستورات ایمیل دیگری است که می‌تواند به همان شیوه ایمیل ایجادشده با
\fB\-\-create\fP
ارسال شود.
.PP
دستور \fB\-\-install\-key\fP یک کلید را به طور دستی در یک پوشه محلی (گزینه
.B \-C
را ببینید) که نمایانگر ساختار یک WKD است نصب می‌کند. آرگومان‌های آن شامل فایلی حاوی بلوک کلید و شناسه کاربری جهت نصب هستند. اگر آرگومان نخست شبیه به یک اثر انگشت باشد، کلید از جاکلیدی (keyring) فعلی برداشته می‌شود؛ برای اجبار به استفاده از فایل، پیشوند "./" را به ابتدای آرگومان نخست اضافه کنید. اگر هیچ آرگومانی داده نشود، پارامترها از ورودی استاندارد (\fBstdin\fP) خوانده می‌شوند؛ قالب مورد انتظار، خطوطی شامل اثر انگشت و صندوق پستی (mailbox) است که با یک فاصله از هم جدا شده‌اند. دستور
\fB\-\-remove\-key\fP
یک کلید را از آن دایرکتوری حذف می‌کند و تنها آرگومان آن یک شناسه کاربری است.
.PP
دستور \fB\-\-mirror\fP مشابه \fB\-\-install\-key\fP است، اما کلیدها را از کارساز LDAP که برای Dirmngr پیکربندی شده است دریافت می‌کند. اگر هیچ آرگومانی ارائه نشود، تمام کلیدها و شناسه‌های کاربری نصب می‌شوند. اگر آرگومان‌هایی مشخص شوند، به عنوان نام دامنه در نظر گرفته می‌شوند تا کلیدهای قابل نصب را محدود کنند. از گزینه
.B \-\-blacklist
می‌توان برای محدود کردن بیشتر کلیدهای قابل نصب استفاده کرد.
.PP
دستور \fB\-\-print\-wkd\-hash\fP شناسه‌های شناسه کاربری WKD و صندوق‌های پستی متناظر را از شناسه‌های کاربری داده‌شده در خط فرمان یا ورودی استاندارد (\fBstdin\fP، یک شناسه کاربری در هر سطر) چاپ می‌کند.
.PP
دستور \fB\-\-print\-wkd\-url\fP نشانی‌های وب (URL) مورد استفاده برای دریافت کلید برای شناسه‌های کاربری مشخص‌شده از WKD را چاپ می‌کند. در اینجا قالب ترجیح داده‌شده امروزی با زیردامنه‌ها استفاده می‌شود.
.PP
تمامی دستورات را می‌توان بدون دو خط تیره ابتدایی نیز مشخص کرد.

.SH "گزینه‌ها (OPTIONS)"
دستور \fBgpg\-wks\-client\fP گزینه‌های زیر را می‌شناسد:

.TP
.B  \-\-send
ارسال مستقیم ایمیل‌های ایجادشده با استفاده از دستور \fBsendmail\fP. این گزینه نیازمند نصب بودن آن دستور است.

.TP
.B  \-\-with\-colons
این گزینه در حال حاضر تنها بر روی دستور \fB\-\-supported\fP اثر می‌گذارد. در صورت استفاده از آن، تمام آرگومان‌های خط فرمان به عنوان نام دامنه در نظر گرفته شده و برای پشتیبانی از WKD بررسی می‌شوند. قالب خروجی به ازای هر دامنه یک سطر با فیلدهای جداشده توسط دو‌نقطه (:) است. فیلدهای مشخص‌شده در حال حاضر عبارتند از (نسخه‌های آینده ممکن است فیلدهای بیشتری را تعریف کنند):

.RS

.TP
.B  1 \- domain
این نام دامنه است. گرچه نقل‌قول (quoting) برای نام‌های دامنه معتبر الزامی نیست، این فیلد به روش استاندارد C نقل‌قول می‌شود.

.TP
.B  2 \- WKD
اگر مقدار true باشد، دامنه از دایرکتوری کلید وب (Web Key Directory) پشتیبانی می‌کند.

.TP
.B  3 \- WKS
اگر مقدار true باشد، دامنه از پروتکل سرویس کلید وب (Web Key Service) برای بارگذاری کلیدها در دایرکتوری پشتیبانی می‌کند.

.TP
.B  4 \- error\-code
این مورد ممکن است شامل یک کد gpg-error برای توصیف خطاهای خاص باشد. از \(oqgpg\-error CODE\(cq برای شرح و توضیح کد استفاده کنید.

.TP
.B  5 \- protocol\-version
حداقل نسخه پروتکل پشتیبانی‌شده توسط کارساز.

.TP
.B  6 \- auth\-submit
فلگ auth-submit برگرفته از فایل خط‌مشی (policy file) کارساز.

.TP
.B  7 \- mailbox\-only
فلگ mailbox-only برگرفته از فایل خط‌مشی (policy file) کارساز.
.RE

.TP
.B  \-\-output \fIfile\fP
.TQ
.B  \-o
نوشتن ایمیل ایجادشده در \fIfile\fP به جای خروجی استاندارد (\fBstdout\fP). توجه داشته باشید که مقدار \fB\-\fP برای \fIfile\fP معادل نوشتن در خروجی استاندارد است. اگر از این گزینه به همراه دستور \fB\-\-check\fP استفاده شود و کلیدی پیدا شده باشد، در فایل مشخص‌شده نوشته می‌شود.

.TP
.B  \-\-status\-fd \fIn\fP
نوشتن رشته‌های وضعیت ویژه در توصیف‌کننده فایل (file descriptor) شماره \fIn\fP. این برنامه فقط پیام‌های وضعیت SUCCESS یا FAILURE را بازمی‌گرداند که زمانی مفید است که فراخواننده از روش انشعاب دوگانه (double fork) استفاده می‌کند و نمی‌تواند به راحتی کد خروج فرآیند را دریافت کند.

.TP
.B  \-C \fIdir\fP
.TQ
.B  \-\-directory \fIdir\fP
استفاده از \fIdir\fP به عنوان دایرکتوری سطح بالا برای دستورات \fB\-\-mirror\fP، \fB\-\-install\-key\fP و \fB\-\-remove\-key\fP. مقدار پیش‌فرض \(oq\fIopenpgpkey\fP\(cq است.

.TP
.B  \-\-blacklist \fIfile\fP
این گزینه برای مستثنی کردن برخی از نشانی‌های ایمیل از یک عملیات آینه‌سازی (mirror) استفاده می‌شود. قالب \fIfile\fP یک نشانی ایمیل (فقط addrspec، به عنوان مثال "postel@isi.edu") در هر سطر است. خطوط خالی و خطوطی که با '#' شروع می‌شوند نادیده گرفته می‌شوند.

.TP
.B  \-\-add\-revocs
.TQ
.B  \-\-no\-add\-revocs
در صورت فعال بودن، گواهی‌های ابطال (revocation certificates) مربوط به همان addrspec مورد استفاده در WKD را به کلید ضمیمه می‌کند. نسخه‌های مدرن gpg قادر به درون‌ریزی و اعمال آن‌ها برای کلیدهای موجود هستند. توجه داشته باشید که هنگام استفاده با دستور \fB\-\-mirror\fP، گواهی‌های ابطال در جاکلیدی محلی جستجو می‌شوند و نه در دایرکتوری LDAP. مقدار پیش‌فرض \fB\-\-add\-revocs\fP است.

.TP
.B  \-\-verbose
فعال‌سازی خروجی اطلاعاتی بیشتر و دقیق‌تر.

.TP
.B  \-\-quiet
غیرفعال‌سازی تقریباً تمام خروجی‌های اطلاعاتی.

.TP
.B  \-\-version
چاپ نسخه برنامه و خروج.

.TP
.B  \-\-help
نمایش یک صفحه راهنمای خلاصه و خروج.

.P

.SH "مثال‌ها (EXAMPLES)"
برای استفاده از این خدمات با سرویس‌گیرندگانی که فاقد پشتیبانی یکپارچه داخلی هستند، می‌توان از سازوکار mailcap استفاده کرد. به سادگی عبارات زیر را:
.RS 2
.nf
application/vnd.gnupg.wks; \[rs]
  /usr/bin/gpg\-wks\-client \-v \-\-read \-\-send; \[rs]
  needsterminal; \[rs]
  description=WKS message
.fi
.RE
در فایل \(oq\fI/etc/mailcap\fP\(cq قرار دهید. این کار فرض می‌کند که /usr/lib/sendmail در سیستم نصب شده است. با این پیکربندی، هر برنامه ایمیل واقعی، gpg-wks-client را برای پیام‌های دریافت‌شده از یک سرویس کلید وب اجرا خواهد کرد.

.SH "همچنین ببینید (SEE ALSO)"
.BR gpg\-wks\-server (1)