| 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
| 1.4.0 | Sequoia PGP |