SQ(1) User Commands SQ(1) نام (NAME) sq-keyring-filter - تجمیع کلیدها در یک دسته‌کلید با اعمال فیلتر خلاصه دستور (SYNOPSIS) sq keyring filter [OPTIONS] FILE توضیحات (DESCRIPTION) تجمیع کلیدها در یک دسته‌کلید با اعمال فیلتر. این دستور می‌تواند برای فیلتر کردن کلیدها بر اساس شروط (predicates) داده‌شده استفاده شود؛ برای مثال اینکه آیا شناسه‌ی کاربری (user ID) آن‌ها شامل نشانی ایمیلی با دامنه‌ای خاص است یا خیر. علاوه بر این، کلیدها می‌توانند هرس شوند تا فقط شامل مؤلفه‌های منطبق با شروط باشند. اگر هیچ فیلتری ارائه نشود، همه‌چیز مطابقت داده می‌شود. اگر چندین شرط تعیین شود، آن‌ها با یکدیگر «یا» (OR) می‌شوند؛ بدین معنا که اگر کلیدی با هر یک از شروط مطابقت داشته باشد، برگزیده می‌شود. برای الزام به برقراری همه‌ی شروط، چندین بار اجرای این دستور را به‌صورت زنجیره‌ای (پایپ) متصل کنید. برای الگو گرفتن، بخش «مثال‌ها (EXAMPLES)» را ببینید. نکته: این دستور آزمایشی تلقی می‌شود و ممکن است در نسخه‌های بعدی دستخوش تغییر شود. برای تأیید این موضوع، باید هنگام فراخوانی این دستور، پرچم `--experimental` را مشخص کنید. گزینه‌ها (OPTIONS) گزینه‌های زیردستور (Subcommand options) --cert=FINGERPRINT|KEYID تطبیق بر اساس اثرانگشت گواهی و شناسه‌های کلید (Key ID) تطبیق بر روی کلیدهای اصلی، شامل گواهی‌هایی که با اثرانگشت یا شناسه کلید داده‌شده مطابقت دارند. --domain=FQDN تطبیق بر اساس FQDN دامنه ایمیل شناسه‌های کاربری را به نام و نشانی ایمیل تجزیه کرده و با حساسیت به حروف کوچک و بزرگ، تطابق دقیق را روی دامنه نشانی ایمیل بررسی می‌کند. --email=ADDRESS تطبیق بر اساس ADDRESS ایمیل شناسه‌های کاربری را به نام و نشانی ایمیل تجزیه کرده و با حساسیت به حروف کوچک و بزرگ، تطابق دقیق را روی نشانی ایمیل بررسی می‌کند. --experimental پذیرش صریح برای استفاده از یک ویژگی آزمایشی این دستور آزمایشی در نظر گرفته می‌شود و ممکن است در نسخه‌های آینده تغییر کند. به منظور تأیید این موضوع، باید هنگام اجرای این دستور پرچم `--experimental` را مشخص کنید. در آینده ممکن است این دستور را پایدار کنیم. در این صورت، دیگر نیازی به `--experimental` نخواهد بود و بدون نمایش پیام نادیده گرفته می‌شود. --key=FINGERPRINT|KEYID تطبیق بر اساس اثرانگشت و شناسه‌های کلید/(زیرکلید) تطبیق بر روی کلیدهای اصلی و زیرکلیدها، شامل گواهی‌هایی که با اثرانگشت یا شناسه کلید داده‌شده مطابقت دارند. --name=NAME تطبیق بر اساس NAME شناسه‌های کاربری را به نام و ایمیل تجزیه کرده و با حساسیت به حروف کوچک و بزرگ، تطابق دقیق را روی نام بررسی می‌کند. --output=FILE نوشتن در FILE یا در صورت عدم ذکر، در خروجی استاندارد (stdout) [پیش‌فرض: -] --prune-certs حذف مؤلفه‌های گواهی که با فیلتر مطابقت ندارند --to-cert تبدیل هر کلید موجود در ورودی به گواهی تبدیل کلید به گواهی، محتوای کلید محرمانه را از کلید حذف کرده و در نتیجه آن را به یک گواهی تبدیل می‌کند. --userid=USERID تطبیق بر اساس USERID تطبیق دقیق بر روی شناسه کاربری، با حساسیت به حروف کوچک و بزرگ. FILE خواندن از FILE یا در صورت عدم ذکر، از ورودی استاندارد (stdin) گزینه‌های عمومی (Global options) برای مشاهده توضیحات مربوط به گزینه‌های عمومی، sq(1) را ببینید. مثال‌ها (EXAMPLES) تبدیل تمامی کلیدها به گواهی (یعنی حذف هرگونه اطلاعات کلید محرمانه). sq keyring filter --experimental --to-cert certs.pgp دریافت تمامی گواهی‌های دارای شناسه کاربری روی example.org. sq keyring filter --experimental --domain=example.org \ certs.pgp دریافت تمامی گواهی‌های دارای شناسه کاربری روی example.org یا example.net. sq keyring filter --experimental --domain=example.org \ --domain=example.net certs.pgp دریافت تمامی گواهی‌هایی که نام شناسه کاربری آن‌ها با Romeo مطابقت دارد. sq keyring filter --experimental --name=Romeo certs.pgp دریافت تمامی گواهی‌هایی با شناسه کاربری به نام Romeo روی example.org. sq keyring filter --experimental --domain=example.org \ certs.pgp \ | sq keyring filter --experimental --name=Romeo دریافت تمام گواهی‌های دارای شناسه کاربری روی example.org، با حذف (هرس کردن) سایر شناسه‌های کاربری. sq keyring filter --experimental --domain=example.org \ --prune-certs certs.pgp همچنین ببینید (SEE ALSO) sq(1), sq-keyring(1). برای مشاهده مستندات کامل، را ببینید. نسخه (VERSION) 1.4.0 Sequoia PGP 1.4.0 SQ(1)