SQ(1)                            User Commands                           SQ(1)

نام (NAME)
       sq-key-userid-add - افزودن یک شناسه کاربری به کلید

خلاصه دستور (SYNOPSIS)
       sq key userid add [گزینه‌ها]

توضیحات (DESCRIPTION)
       افزودن یک شناسه کاربری.

       یک شناسه کاربری می‌تواند شامل یک نام مانند `Juliet` یا یک نشانی رایانامه
       مانند `<juliet@example.org>` باشد. از نظر تاریخی، معمولاً یک نام و یک
       نشانی رایانامه در قالب یک شناسه کاربری واحد مانند `Juliet
       <juliet@example.org>` با هم ترکیب می‌شدند. با این حال، شناسه‌های کاربری
       که شامل اطلاعات گوناگون مانند نام و نشانی رایانامه هستند، ارزیابی و
       پردازش دشوارتری دارند؛ بنابراین امروزه استفاده از شناسه‌های کاربری مجزا
       برای نام و نشانی رایانامه ترجیح داده می‌شود.

       دستور `sq key userid add` به زمان مرجع تعیین‌شده توسط آرگومان سطح بالای
       `--time` احترام می‌گذارد. این دستور زمان ایجاد امضای اتصال (binding
       signature) شناسه کاربری را بر روی زمان مشخص‌شده تنظیم می‌کند.



گزینه‌ها (OPTIONS)
   گزینه‌های زیردستور (Subcommand options)
       --allow-non-canonical-userids
              عدم رد شناسه‌های کاربری که در قالب متعارف نیستند

              شناسه‌های کاربری متعارف به شکل `Name (Comment)
              <localpart@example.org>` هستند.

       --cert=FINGERPRINT|KEYID
              افزودن شناسه کاربری به کلید دارای اثر انگشت یا شناسه کلید
              مشخص‌شده

       --cert-email=EMAIL
              افزودن شناسه کاربری به کلیدی که یکی از شناسه‌های کاربری آن شامل
              نشانی رایانامه مشخص‌شده باشد

       --cert-file=PATH
              افزودن شناسه کاربری به کلید خوانده‌شده از PATH

       --cert-userid=USERID
              افزودن شناسه کاربری به کلید با شناسه کاربری مشخص‌شده

       --email=ADDRESS
              افزودن یک نشانی رایانامه به عنوان شناسه کاربری به کلید

       --name=NAME
              افزودن یک نام به عنوان شناسه کاربری به کلید

       --output=FILE
              نوشتن در FILE مشخص‌شده

              اگر مشخص نشود و گواهی از مخزن گواهی‌ها خوانده شده باشد، گواهی
              اصلاح‌شده به مخزن گواهی‌ها وارد (import) می‌شود. اگر مشخص نشود و
              گواهی از یک فایل خوانده شده باشد، گواهی اصلاح‌شده در خروجی
              استاندارد نوشته می‌شود.

       --userid=USERID
              افزودن یک شناسه کاربری به کلید

              این شناسه کاربری می‌تواند نام و نشانی رایانامه را ترکیب کند،
              می‌تواند به صورت اختیاری شامل یک یادداشت باشد، یا در صورت ارائه
              گزینه `--allow-non-canonical-userids` حتی دارای ساختاری آزاد
              باشد. با این حال، شناسه‌های کاربری شامل اطلاعات گوناگون مانند نام
              و نشانی رایانامه، تحلیل و پردازش دشوارتری دارند؛ بنابراین امروزه
              استفاده از شناسه‌های کاربری متمایز برای نام و نشانی رایانامه
              ترجیح داده می‌شود.

              در صورت تردید، استفاده از `--name` و `--email` ترجیح دارد.


   گزینه‌های عمومی (Global options)
       برای مشاهده توضیحات گزینه‌های عمومی به sq(1) مراجعه کنید.

مثال‌ها (EXAMPLES)
       # افزودن یک شناسه کاربری جدید به کلید Alice.

              sq key userid add --cert \
                     EB28F26E2739A4870ECC47726F0073F60FD0CBF0 --name Alice \
                     --email alice@work.example.com

همچنین ببینید (SEE ALSO)
       sq(1), sq-key(1), sq-key-userid(1).

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

نسخه (VERSION)
       1.4.0

Sequoia PGP                          1.4.0                               SQ(1)