.TH keylookup 1 "" Jun-2002 ""
.\" manual page (c) 2000, 2001, 2002 Christian Kurz, Peter Palfrader

.SH "نام (NAME)"
.LP
keylookup \- واکشی و وارد کردن کلیدهای GnuPG از سرورهای کلید

.SH "خلاصه دستور (SYNOPSIS)"
\fBkeylookup\fP [\fIoptions\fP] \fIsearch-string\fP

.SH "توضیحات (DESCRIPTION)"
.LP
دستور \fBkeylookup\fR یک پوشش پیرامون gpg \-\-search است که به شما امکان جستجوی کلیدها را در سرور کلید (keyserver) می‌دهد. این ابزار فهرستی از کلیدهای منطبق را به کاربر نمایش داده و به او اجازه می‌دهد کلیدهای مورد نظر را برای وارد کردن به جاکلیدی (keyring) GnuPG انتخاب کند.

برای جستجو و وارد کردن واقعی کلیدها، خودِ GnuPG فراخوانی می‌شود.

.SH "گزینه‌ها (OPTIONS)"
.IP "\fB\-\-keyserver\fP=\fIkeyserver\fP" 8
سرور کلید مورد استفاده را مشخص می‌کند. اگر هیچ سرور کلیدی مشخص نشده باشد، فایل تنظیمات GnuPG برای یافتن یک سرور کلید پیش‌فرض پیمایش می‌شود. در صورتی که سرور کلیدی یافت نشود، \fBkeylookup\fP متوقف خواهد شد.

.IP "\fB\-\-port\fP=\fIport\fP" 8
استفاده از درگاهی به غیر از 11371.

.IP "\fB\-\-frontend\fP=\fIfrontend\fP" 8
دستور \fBkeylookup\fP از نمایش نتایج جستجو با ۳ رابط کاربری (frontend) مختلف پشتیبانی می‌کند. هر دو رابط \fBwhiptail\fP و \fBdialog\fP تعاملی هستند و به کاربر اجازه می‌دهند کلیدها را برای وارد کردن انتخاب کند. رابط سوم، یعنی \fBplain\fP غیرتعاملی بوده و فقط کلیدها را در خروجی استاندارد (STDOUT) چاپ می‌کند. در این صورت کاربر باید خودش GnuPG را فراخوانی کند.

در صورت موجود بودن، \fB/usr/bin/dialog\fP حالت پیش‌فرض است. اگر موجود نباشد ولی \fB/usr/bin/whiptail\fP نصب باشد، از آن استفاده می‌شود. اگر هیچ‌کدام در دسترس نباشند، برنامه به حالت \fBplain\fP بازمی‌گردد.

.IP "\fB\-\-importall\fP" 8
به جای پرسش از کاربر برای انتخاب کلیدها، تمام کلیدهای منطبق با \fIsearch-string\fP را وارد می‌کند. در صورت استفاده از این گزینه، نیازی به رابط کاربری نخواهد بود.

.IP "\fB\-\-honor\-http\-proxy\fP" 8
همانند GnuPG، برنامه \fBkeylookup\fP تنها در صورتی از متغیر محیطی \fBhttp_proxy\fP تبعیت می‌کند که این گزینه داده شده باشد. اگر این گزینه داده نشده باشد اما فایل تنظیمات GnuPG شما شامل آن باشد، \fBkeylookup\fP از آن استفاده خواهد کرد.

.IP "\fB\-\-help\fP" 8
نمایش یک پیام راهنمای کوتاه و خروج موفقیت‌آمیز.

.SH "محیط (ENVIRONMENT)"

.IP "HOME" 10 
برای یافتن دایرکتوری خانگی پیش‌فرض استفاده می‌شود.

.IP "GNUPGHOME" 10 
در صورت تنظیم، این دایرکتوری به جای "~/.gnupg" استفاده می‌شود.

.IP "GNUPGBIN" 10
در صورت تنظیم، به جای "gpg" به عنوان باینری gpg استفاده می‌شود.

.IP "http_proxy" 10 
تنها زمانی اعمال می‌شود که گزینه \-\-honor\-http\-proxy تنظیم شده باشد یا honor\-http\-proxy در فایل پیکربندی GnuPG مشخص شده باشد.

.SH "مثال‌ها (EXAMPLES)"

.IP "keylookup Christian Kurz"
سرور کلید پیش‌فرض شما را برای کلیدهای Christian پرس‌وجو می‌کند و به شما امکان می‌دهد در صورت وجود رابط dialog، آن‌ها را به جاکلیدی خود وارد کنید.

.IP "keylookup \-\-honor\-http\-proxy \-\-frontend plain wk@gnupg"
دوباره از سرور کلید پیش‌فرض پرس‌وجو می‌کند، اما این بار در صورت تعریف متغیر محیطی http_proxy از آن استفاده کرده و کلیدهای wk@gnupg (Werner Koch) را در STDOUT چاپ می‌کند.

.IP "keylookup \-\-keyserver pgp.mit.edu Peter Palfrader"
سرور کلید pgp.mit.edu را برای کلیدهای Peter پرس‌وجو می‌کند و آن‌ها را برای وارد کردن در dialog نمایش می‌دهد.

.SH "فایل‌ها (FILES)"

.IP "~/.gnupg/options"  10
فایل تنظیمات GnuPG که در صورت وجود، \fBkeylookup\fP مقادیر keyserver و honor\-http\-proxy را از آن دریافت می‌کند.

.SH "همچنین ببینید (SEE ALSO)"

\fBgpg\fP(1)

.SH "گزارش باگ‌ها (BUGS)"

.LP
لطفاً باگ‌ها را با استفاده از سامانه ردیابی باگ دبیان در https://bugs.debian.org گزارش دهید.

.SH "نویسندگان (AUTHORS)"

.LP
Christian Kurz <shorty@debian.org>
.br
Peter Palfrader <peter@palfrader.org>