.TH SQ 1 1.4.0 "Sequoia PGP" "User Commands"
.SH "نام (NAME)"
sq\-pki\-lookup \- جستجوی گواهی‌های مرتبط با یک شناسه کاربری (User ID)
.SH "خلاصه دستور (SYNOPSIS)"
.br
\fBsq pki lookup\fR [\fIOPTIONS\fR]  
.SH "توضیحات (DESCRIPTION)"
جستجوی گواهی‌های مرتبط با یک شناسه کاربری (User ID).
.PP
پیوندهای (bindings) احرازهویت‌شده (جفت‌های شناسه کاربری و گواهی) را که در آن‌ها شناسه کاربری با مقدار مشخص‌شده مطابقت دارد، شناسایی می‌کند.
.PP
اگر هیچ پیوندی نتواند تا سطح مشخص‌شده احراز هویت شود (به‌طور پیش‌فرض: احرازهویت کامل، یعنی مقدار اعتماد ۱۲۰)، خطایی بازگردانده می‌شود.
.PP
اگر پیوندی بتواند به‌طور جزئی احراز هویت شود (یعنی مقدار اعتماد آن بیشتر از ۰ باشد)، آن پیوند نمایش داده می‌شود، حتی اگر میزان اعتماد کمتر از آستانه مشخص‌شده باشد.
.PP

.SH "گزینه‌ها (OPTIONS)"
.SS "گزینه‌های زیرفرمان"
.TP
\fB\-\-amount\fR=\fIAMOUNT\fR
میزان اعتماد مورد نیاز.
.IP
مقدار ۱۲۰ نشان‌دهنده احراز هویت کامل است؛ مقادیر کمتر از ۱۲۰ بیانگر احراز هویت جزئی هستند. هنگامی که `\-\-certification\-network` مشخص شود، این مقدار به‌طور پیش‌فرض ۱۲۰۰ خواهد بود؛ یعنی این دستور تلاش می‌کند ۱۰ مسیر پیدا کند.
.TP
\fB\-\-certification\-network\fR
شبکه را به عنوان یک شبکه صدور گواهی (certification network) در نظر می‌گیرد.
.IP
به‌طور معمول، سازوکار احراز هویت با شبکه «وب اعتماد» (Web of Trust) مانند یک شبکه احراز هویت رفتار می‌کند که در آن گواهی‌کردن تنها به این معناست که پیوند صحیح است، نه اینکه هدف باید به عنوان یک معرف مورد اعتماد (trusted introducer) تلقی شود. در یک شبکه صدور گواهی، با اهداف گواهی‌ها به عنوان معرف‌های مورد اعتماد با عمق نامحدود رفتار می‌شود و هرگونه عبارت باقاعده (regular expression) نادیده گرفته می‌شود. نکته: مقدار اعتماد بدون تغییر باقی می‌ماند. بیشتر الگوریتم‌های موسوم به مسیریابی PGP به این شکل کار می‌کنند.
.TP
\fB\-\-email\fR=\fIEMAIL\fR
یافتن گواهی‌هایی که می‌توانند برای آدرس ایمیل مشخص‌شده احراز هویت شوند.
.IP
اگر یک شناسه کاربری با آدرس ایمیل مشخص‌شده برای آن گواهی قابل احراز هویت باشد، گواهی بازگردانده می‌شود.
.IP
برای جستجوی گواهی‌ای با شناسه کاربری که صرفاً شامل آدرس ایمیل مشخص‌شده باشد، از `\-\-userid <EMAIL>` استفاده کنید.
.TP
\fB\-\-gossip\fR
همه گواهی‌ها را به عنوان ریشه‌های اعتماد غیرقابل‌اتکا در نظر می‌گیرد.
.IP
این گزینه برای آگاهی از دیدگاه دیگران درباره یک گواهی (یعنی شایعه، حرف دیگران یا gossip) مفید است. به عبارت دیگر، این گزینه مسیرهای دلخواهی را به سمت یک گواهی خاص پیدا می‌کند.
.IP
گاسیپ (Gossip) در شناسایی راه‌های جایگزین برای احراز هویت یک گواهی کارآمد است. برای مثال، تصور کنید Ed می‌خواهد گواهی Laura را احراز هویت کند، اما درخواست مستقیم از او دشوار یا ناممکن است. Ed متوجه می‌شود که Micah گواهی Laura را تأیید کرده است، اما Ed هنوز گواهی Micah را احراز هویت نکرده است. اگر Ed مایل باشد به Micah به عنوان یک معرف مورد اعتماد اتکا کند، و احراز هویت گواهی Micah آسان‌تر از احراز هویت گواهی Laura باشد، در این صورت Ed روش آسان‌تری برای احراز هویت گواهی Laura پیدا کرده است.
.IP
از نسخه 1.1.0 پایدار است.
.TP
\fB\-\-show\-paths\fR
نمایش دلیل احرازهویت‌شدن یک پیوند.
.IP
به‌طور پیش‌فرض، فقط میزان احراز هویت پیوندِ بین شناسه کاربری و گواهی (مقداری بین ۰ و ۱۲۰) نمایش داده می‌شود. این گزینه خروجی را تغییر می‌دهد تا با نمایش مسیرها از ریشه‌های اعتماد تا پیوندها، نحوه محاسبه آن مقدار را نیز نشان دهد.
.TP
\fB\-\-unusable\fR
نمایش پیوندهایی که غیرقابل‌استفاده هستند.
.IP
به‌طور معمول، گواهی‌ها و پیوندهای غیرقابل‌استفاده نمایش داده نمی‌شوند. این گزینه پیوندها را در نظر می‌گیرد، حتی اگر به دلیل معتبر نبودن طبق شیوه‌نامه (policy)، باطل‌شدن یا فعال نبودنِ خودشان (یا گواهی‌ها)، غیرقابل‌استفاده باشند.
.IP
این گزینه تنها همراه با `\-\-gossip` معنی پیدا می‌کند، زیرا پیوندهای غیرقابل‌استفاده همچنان احرازهویت‌نشده در نظر گرفته می‌شوند.
.IP
از نسخه 1.1.0 پایدار است.
.TP
\fB\-\-userid\fR=\fIUSERID\fR
یافتن گواهی‌هایی که می‌توانند برای شناسه کاربری مشخص‌شده احراز هویت شوند.
.IP
شناسه کاربری مشخص‌شده نیازی به خودامضاشدن (self-signed) ندارد.
.SS "گزینه‌های عمومی"
برای توضیحات گزینه‌های عمومی، \fBsq\fR(1) را ببینید.
.SH "مثال‌ها (EXAMPLES)"
.PP

.PP
جستجوی گواهی‌هایی که می‌توانند برای شناسه کاربری داده‌شده احراز هویت شوند:
.PP
.nf
.RS
sq pki lookup \-\-userid "Alice <alice@example.org>"
.RE
.PP
.fi

.PP
جستجوی گواهی‌هایی که دارای شناسه کاربری با آدرس ایمیل مشخص‌شده هستند و آن شناسه کاربری می‌تواند احراز هویت شود:
.PP
.nf
.RS
sq pki lookup \-\-email alice@example.org
.RE
.fi
.SH "همچنین ببینید (SEE ALSO)"
.nh
\fBsq\fR(1), \fBsq\-pki\fR(1).
.hy
.PP
برای مشاهده مستندات کامل به <https://book.sequoia\-pgp.org> مراجعه کنید.
.SH "نسخه (VERSION)"
1.4.0