.TH SQ 1 1.4.0 "Sequoia PGP" "User Commands"
.SH "نام (NAME)"
sq\-keyring\-filter \- تجمیع کلیدها در یک دسته‌کلید با اعمال فیلتر
.SH "خلاصه دستور (SYNOPSIS)"
.br
\fBsq keyring filter\fR [\fIOPTIONS\fR] \fIFILE\fR
.SH "توضیحات (DESCRIPTION)"
تجمیع کلیدها در یک دسته‌کلید با اعمال فیلتر.
.PP
این دستور می‌تواند برای فیلتر کردن کلیدها بر اساس شروط (predicates) داده‌شده استفاده شود؛ برای مثال اینکه آیا شناسه‌ی کاربری (user ID) آن‌ها شامل نشانی ایمیلی با دامنه‌ای خاص است یا خیر. علاوه بر این، کلیدها می‌توانند هرس شوند تا فقط شامل مؤلفه‌های منطبق با شروط باشند.
.PP
اگر هیچ فیلتری ارائه نشود، همه‌چیز مطابقت داده می‌شود.
.PP
اگر چندین شرط تعیین شود، آن‌ها با یکدیگر «یا» (OR) می‌شوند؛ بدین معنا که اگر کلیدی با هر یک از شروط مطابقت داشته باشد، برگزیده می‌شود. برای الزام به برقراری همه‌ی شروط، چندین بار اجرای این دستور را به‌صورت زنجیره‌ای (پایپ) متصل کنید. برای الگو گرفتن، بخش «مثال‌ها (EXAMPLES)» را ببینید.
.PP
نکته: این دستور آزمایشی تلقی می‌شود و ممکن است در نسخه‌های بعدی دستخوش تغییر شود. برای تأیید این موضوع، باید هنگام فراخوانی این دستور، پرچم `\-\-experimental` را مشخص کنید.
.PP


.SH "گزینه‌ها (OPTIONS)"
.SS "گزینه‌های زیردستور (Subcommand options)"
.TP
\fB\-\-cert\fR=\fIFINGERPRINT|KEYID\fR
تطبیق بر اساس اثرانگشت گواهی و شناسه‌های کلید (Key ID)
.IP
تطبیق بر روی کلیدهای اصلی، شامل گواهی‌هایی که با اثرانگشت یا شناسه کلید داده‌شده مطابقت دارند.
.TP
\fB\-\-domain\fR=\fIFQDN\fR
تطبیق بر اساس FQDN دامنه ایمیل
.IP
شناسه‌های کاربری را به نام و نشانی ایمیل تجزیه کرده و با حساسیت به حروف کوچک و بزرگ، تطابق دقیق را روی دامنه نشانی ایمیل بررسی می‌کند.
.TP
\fB\-\-email\fR=\fIADDRESS\fR
تطبیق بر اساس ADDRESS ایمیل
.IP
شناسه‌های کاربری را به نام و نشانی ایمیل تجزیه کرده و با حساسیت به حروف کوچک و بزرگ، تطابق دقیق را روی نشانی ایمیل بررسی می‌کند.
.TP
\fB\-\-experimental\fR
پذیرش صریح برای استفاده از یک ویژگی آزمایشی
.IP
این دستور آزمایشی در نظر گرفته می‌شود و ممکن است در نسخه‌های آینده تغییر کند. به منظور تأیید این موضوع، باید هنگام اجرای این دستور پرچم `\-\-experimental` را مشخص کنید.
.IP
در آینده ممکن است این دستور را پایدار کنیم. در این صورت، دیگر نیازی به `\-\-experimental` نخواهد بود و بدون نمایش پیام نادیده گرفته می‌شود.

.TP
\fB\-\-key\fR=\fIFINGERPRINT|KEYID\fR
تطبیق بر اساس اثرانگشت و شناسه‌های کلید/(زیرکلید)
.IP
تطبیق بر روی کلیدهای اصلی و زیرکلیدها، شامل گواهی‌هایی که با اثرانگشت یا شناسه کلید داده‌شده مطابقت دارند.
.TP
\fB\-\-name\fR=\fINAME\fR
تطبیق بر اساس NAME
.IP
شناسه‌های کاربری را به نام و ایمیل تجزیه کرده و با حساسیت به حروف کوچک و بزرگ، تطابق دقیق را روی نام بررسی می‌کند.
.TP
\fB\-\-output\fR=\fIFILE\fR
نوشتن در FILE یا در صورت عدم ذکر، در خروجی استاندارد (stdout)
.IP
[پیش‌فرض: \fB\-\fR]
.TP
\fB\-\-prune\-certs\fR
حذف مؤلفه‌های گواهی که با فیلتر مطابقت ندارند
.TP
\fB\-\-to\-cert\fR
تبدیل هر کلید موجود در ورودی به گواهی
.IP
تبدیل کلید به گواهی، محتوای کلید محرمانه را از کلید حذف کرده و در نتیجه آن را به یک گواهی تبدیل می‌کند.
.TP
\fB\-\-userid\fR=\fIUSERID\fR
تطبیق بر اساس USERID
.IP
تطبیق دقیق بر روی شناسه کاربری، با حساسیت به حروف کوچک و بزرگ.
.TP
 \fIFILE\fR
خواندن از FILE یا در صورت عدم ذکر، از ورودی استاندارد (stdin)
.SS "گزینه‌های عمومی (Global options)"
برای مشاهده توضیحات مربوط به گزینه‌های عمومی، \fBsq\fR(1) را ببینید.
.SH "مثال‌ها (EXAMPLES)"
.PP

.PP
تبدیل تمامی کلیدها به گواهی (یعنی حذف هرگونه اطلاعات کلید محرمانه).
.PP
.nf
.RS
sq keyring filter \-\-experimental \-\-to\-cert certs.pgp
.RE
.PP
.fi

.PP
دریافت تمامی گواهی‌های دارای شناسه کاربری روی example.org.
.PP
.nf
.RS
sq keyring filter \-\-experimental \-\-domain=example.org \\
.RE
.RS
.RS
certs.pgp
.RE
.RE
.PP
.fi

.PP
دریافت تمامی گواهی‌های دارای شناسه کاربری روی example.org یا example.net.
.PP
.nf
.RS
sq keyring filter \-\-experimental \-\-domain=example.org \\
.RE
.RS
.RS
\-\-domain=example.net certs.pgp
.RE
.RE
.PP
.fi

.PP
دریافت تمامی گواهی‌هایی که نام شناسه کاربری آن‌ها با Romeo مطابقت دارد.
.PP
.nf
.RS
sq keyring filter \-\-experimental \-\-name=Romeo certs.pgp
.RE
.PP
.fi

.PP
دریافت تمامی گواهی‌هایی با شناسه کاربری به نام Romeo روی example.org.
.PP
.nf
.RS
sq keyring filter \-\-experimental \-\-domain=example.org \\
.RE
.RS
.RS
certs.pgp \\
.RE
.RE
.RS
.RS
| sq keyring filter \-\-experimental \-\-name=Romeo
.RE
.RE
.PP
.fi

.PP
دریافت تمام گواهی‌های دارای شناسه کاربری روی example.org، با حذف (هرس کردن) سایر
شناسه‌های کاربری.
.PP
.nf
.RS
sq keyring filter \-\-experimental \-\-domain=example.org \\
.RE
.RS
.RS
\-\-prune\-certs certs.pgp
.RE
.RE
.fi
.SH "همچنین ببینید (SEE ALSO)"
.nh
\fBsq\fR(1), \fBsq\-keyring\fR(1).
.hy
.PP
برای مشاهده مستندات کامل، <https://book.sequoia\-pgp.org> را ببینید.
.SH "نسخه (VERSION)"
1.4.0