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)
       sq(1).

       برای مطالعه‌ی مستندات کامل به <https://book.sequoia-pgp.org> مراجعه
       کنید.

نسخه (VERSION)
       1.4.0

Sequoia PGP                          1.4.0                               SQ(1)