SQ(1) User Commands SQ(1) نام (NAME) sq-key-revoke - ابطال یک گواهی خلاصه دستور (SYNOPSIS) sq key revoke [گزینه‌ها] توضیحات (DESCRIPTION) یک گواهی را باطل می‌کند. یک گواهی ابطال برای یک گواهی ایجاد می‌کند. اگر `--revoker` یا `--revoker-file` ارائه شده باشد، از آن کلید برای ایجاد گواهی ابطال استفاده می‌شود. اگر آن کلید با گواهی‌ای که در حال باطل شدن است متفاوت باشد، این کار منجر به یک ابطال شخص ثالث (third-party revocation) خواهد شد. این حالت معمولاً تنها زمانی مفید است که مالک گواهی، آن کلید را به عنوان باطل‌کننده تعیین‌شده (designated revoker) مشخص کرده باشد. دستور `sq key revoke` از زمان مرجع تعیین‌شده توسط آرگومان سطح بالای `--time` پیروی می‌کند. در صورت تنظیم، هنگام تعیین اینکه چه کلیدهایی معتبر هستند، به جای زمان فعلی از زمان مشخص‌شده استفاده می‌کند و زمان ایجاد گواهی ابطال را نیز به جای زمان فعلی، روی زمان مرجع تنظیم می‌کند. گزینه‌ها (OPTIONS) گزینه‌های زیردستور (Subcommand options) --cert=FINGERPRINT|KEYID باطل کردن کلید دارای اثرانگشت یا شناسه کلید مشخص‌شده --cert-email=EMAIL باطل کردن کلیدی که یکی از شناسه‌های کاربری آن شامل آدرس ایمیل مشخص‌شده است --cert-file=PATH باطل کردن کلید خوانده‌شده از PATH --cert-userid=USERID باطل کردن کلید دارای شناسه کاربری مشخص‌شده --message=MESSAGE یک متن توضیحی کوتاه این متن به مشاهده‌کنندهٔ گواهی ابطال نشان داده می‌شود و دلیل باطل شدن گواهی را توضیح می‌دهد. برای نمونه، اگر آلیس کلید جدیدی ایجاد کرده باشد، یک گواهی ابطال از نوع `superseded` برای کلید قدیمی خود ایجاد می‌کند و ممکن است پیام `I've created a new certificate, $FINGERPRINT, please use that in the future.` را در آن قرار دهد. --output=FILE نوشتن در FILE مشخص‌شده در صورت عدم تعیین، و اگر گواهی از مخزن گواهی‌ها خوانده شده باشد، گواهی تغییریافته را به مخزن گواهی وارد (import) می‌کند. در صورت عدم تعیین، و اگر گواهی از یک فایل خوانده شده باشد، گواهی تغییریافته را در stdout می‌نویسد. --reason=REASON دلیل ابطال اگر دلیل ابطال در گذشته رخ داده است، باید آن را با استفاده از آرگومان `--time` مشخص کنید. این به پیاده‌سازی‌های OpenPGP اجازه می‌دهد تا با دقت بیشتری درباره داده‌ها و مواردی که اعتبارشان به اعتبار این گواهی وابسته است، تصمیم‌گیری کنند. [مقادیر ممکن: compromised، superseded، retired، unspecified] --revoker=FINGERPRINT|KEYID استفاده از کلید با اثرانگشت یا شناسه کلید مشخص‌شده برای ایجاد گواهی ابطال گواهی ابطال را با استفاده از کلید مشخص‌شده امضا می‌کند. به‌طور پیش‌فرض، از گواهی در حال ابطال استفاده می‌شود. با استفاده از این گزینه، ایجاد ابطال شخص ثالث امکان‌پذیر است. --revoker-email=EMAIL استفاده از کلیدی که شناسه کاربری آن شامل آدرس ایمیل مشخص‌شده است برای ایجاد گواهی ابطال گواهی ابطال را با استفاده از کلید مشخص‌شده امضا می‌کند. به‌طور پیش‌فرض، از گواهی در حال ابطال استفاده می‌شود. با استفاده از این گزینه، ایجاد ابطال شخص ثالث امکان‌پذیر است. --revoker-file=PATH خواندن کلید از PATH برای ایجاد گواهی ابطال گواهی ابطال را با استفاده از کلید مشخص‌شده امضا می‌کند. به‌طور پیش‌فرض، از گواهی در حال ابطال استفاده می‌شود. با استفاده از این گزینه، ایجاد ابطال شخص ثالث امکان‌پذیر است. --revoker-userid=USERID استفاده از کلید با شناسه کاربری مشخص‌شده برای ایجاد گواهی ابطال گواهی ابطال را با استفاده از کلید مشخص‌شده امضا می‌کند. به‌طور پیش‌فرض، از گواهی در حال ابطال استفاده می‌شود. با استفاده از این گزینه، ایجاد ابطال شخص ثالث امکان‌پذیر است. --signature-notation NAME VALUE افزودن یک نشانه‌گذاری (notation) به امضا نام یک نشانه‌گذاریِ تعریف‌شده توسط کاربر باید به شکل `name@a.domain.you.control.org` باشد. اگر نام نشانه‌گذاری با یک `!` شروع شود، آنگاه نشانه‌گذاری به عنوان حیاتی (critical) علامت‌گذاری می‌شود. اگر مصرف‌کنندهٔ امضا یک نشانه‌گذاری حیاتی را متوجه نشود، از امضا صرف‌نظر خواهد کرد. این نشانه‌گذاری به عنوان خوانا برای انسان (human readable) علامت‌گذاری می‌شود. گزینه‌های عمومی (Global options) برای مشاهدهٔ توضیحات گزینه‌های عمومی، sq(1) را ببینید. مثال‌ها (EXAMPLES) باطل کردن کلید آلیس، با قید اینکه یک گواهی جدید وجود دارد. sq key revoke --cert EB28F26E2739A4870ECC47726F0073F60FD0CBF0 \ --reason superseded --message \ "My new cert is C5999E8191BF7B503653BE958B1F7910D01F86E5" باطل کردن کلید، با اعلام اینکه داده‌های کلید مخفی افشا شده و به خطر افتاده است (compromised). sq key revoke --cert EB28F26E2739A4870ECC47726F0073F60FD0CBF0 \ --reason compromised --message \ "Computer attacked, secret key material compromised" همچنین ببینید (SEE ALSO) sq(1), sq-key(1). برای مستندات کامل، به مراجعه کنید. نسخه (VERSION) 1.4.0 Sequoia PGP 1.4.0 SQ(1)