| SQ(1) | User Commands | SQ(1) |
نام (NAME)
sq-sign - امضای پیامها یا فایلهای داده
خلاصه دستور (SYNOPSIS)
sq sign [OPTIONS] FILE
توضیحات (DESCRIPTION)
پیامها یا فایلهای داده را امضا میکند.
پیامهای امضاشده یا امضاهای جداگانه (detached signatures) ایجاد میکند. امضاهای جداگانه معمولاً برای امضای بستههای نرمافزاری به کار میروند.
عملیات معکوس این دستور `sq verify` است.
دستور `sq sign` به زمان مرجع تعیینشده توسط آرگومان سطح بالای `--time` پایبند است. در صورت تنظیم این مقدار، هنگام بررسی اعتبار کلیدها، به جای زمان کنونی از زمان تعیینشده استفاده میشود و زمان ایجاد امضا نیز به جای زمان کنونی، برابر با زمان مرجع قرار میگیرد.
گزینهها (OPTIONS)
گزینههای زیردستور (Subcommand options)
- --append
- افزودن یک امضا به امضای موجود
- --binary
- تولید خروجی بهصورت دادههای باینری
- --cleartext
- ایجاد پیامی با امضای متنآشکار (cleartext-signed)
- --merge=SIGNED-MESSAGE
- ادغام امضاها از ورودی و SIGNED-MESSAGE
- --message
- ایجاد یک پیام با امضای درونخطی (inline-signed)
- --mode=MODE
- انتخاب حالت امضا
- امضاها میتوانند در حالت باینری (binary) یا متنی (text) ایجاد شوند. حالت متنی کاراکترهای انتهای خطوط را نرمالسازی میکند؛ این کار موجب پایداری بیشتر امضاها در زمان انتقال متن از طریق کانالهایی میشود که ممکن است پایان خطوط را تغییر دهند. در صورت وجود تردید، امضاهای باینری بسازید.
- [پیشفرض: binary]
- [مقادیر ممکن: binary, text]
- --output=FILE
- نوشتن خروجی در FILE، یا در صورت حذف در stdout
- [پیشفرض: -]
- --signature-file=SIG
- ایجاد یک فایل امضای جداگانه (detached signature)
- --signature-notation NAME VALUE
- افزودن یک نشانهگذاری (notation) به امضا
- نام نشانهگذاریِ تعریفشده توسط کاربر باید به شکل `name@a.domain.you.control.org` باشد. اگر نام نشانهگذاری با `!` آغاز شود، به عنوان حیاتی (critical) علامتگذاری میشود. چنانچه پردازشکنندهی امضا یک نشانهگذاری حیاتی را شناسایی نکند، امضا را نادیده خواهد گرفت. این نشانهگذاری به صورت خوانا برای انسان مشخص میشود.
- --signer=FINGERPRINT|KEYID
- ایجاد امضا با استفاده از کلید دارای اثر انگشت یا شناسهی کلید مشخصشده
- --signer-email=EMAIL
- ایجاد امضا با استفاده از کلیدی که شناسه کاربر (user ID) آن حاوی آدرس ایمیل مشخصشده است
- --signer-file=PATH
- ایجاد امضا با استفاده از کلید خواندهشده از PATH
- --signer-self
- امضا با استفاده از کلیدهای امضاکنندهی پیشفرض خودتان
- این گزینه گواهیهای فهرستشده در فایل پیکربندی ذیل `sign.signer-self` را به فهرست کلیدهای امضاکننده اضافه میکند.
- در حال حاضر فهرست کلیدهای مورد نظر برای افزودن خالی است.
- --signer-userid=USERID
- ایجاد امضا با استفاده از کلید دارای شناسهی کاربر مشخصشده
-
FILE - خواندن از FILE، یا در صورت تعیین '-' از stdin
- [پیشفرض: -]
گزینههای عمومی (Global options)
برای مشاهدهی توضیحات گزینههای عمومی به sq(1) مراجعه کنید.
مثالها (EXAMPLES)
ایجاد یک پیام امضاشده:
sq sign --signer-file juliet-secret.pgp --message document.txt
ایجاد یک امضای جداگانه (detached signature):
sq sign --signer-file juliet-secret.pgp \
--signature-file=document.txt.sig document.txt
همچنین ببینید (SEE ALSO)
برای مطالعهی مستندات کامل به https://book.sequoia-pgp.org مراجعه کنید.
نسخه (VERSION)
1.4.0
| 1.4.0 | Sequoia PGP |