.TH SQ 1 1.4.0 "Sequoia PGP" "User Commands"
.SH "نام (NAME)"
sq\-key\-userid\-add \- افزودن یک شناسه کاربری به کلید
.SH "خلاصه دستور (SYNOPSIS)"
.br
\fBsq key userid add\fR [\fIگزینه‌ها\fR]
.SH "توضیحات (DESCRIPTION)"
افزودن یک شناسه کاربری.
.PP
یک شناسه کاربری می‌تواند شامل یک نام مانند `Juliet` یا یک نشانی رایانامه مانند `<juliet@example.org>` باشد. از نظر تاریخی، معمولاً یک نام و یک نشانی رایانامه در قالب یک شناسه کاربری واحد مانند `Juliet <juliet@example.org>` با هم ترکیب می‌شدند. با این حال، شناسه‌های کاربری که شامل اطلاعات گوناگون مانند نام و نشانی رایانامه هستند، ارزیابی و پردازش دشوارتری دارند؛ بنابراین امروزه استفاده از شناسه‌های کاربری مجزا برای نام و نشانی رایانامه ترجیح داده می‌شود.
.PP
دستور `sq key userid add` به زمان مرجع تعیین‌شده توسط آرگومان سطح بالای `\-\-time` احترام می‌گذارد. این دستور زمان ایجاد امضای اتصال (binding signature) شناسه کاربری را بر روی زمان مشخص‌شده تنظیم می‌کند.
.PP


.SH "گزینه‌ها (OPTIONS)"
.SS "گزینه‌های زیردستور (Subcommand options)"
.TP
\fB\-\-allow\-non\-canonical\-userids\fR
عدم رد شناسه‌های کاربری که در قالب متعارف نیستند
.IP
شناسه‌های کاربری متعارف به شکل `Name (Comment) <localpart@example.org>` هستند.
.TP
\fB\-\-cert\fR=\fIFINGERPRINT|KEYID\fR
افزودن شناسه کاربری به کلید دارای اثر انگشت یا شناسه کلید مشخص‌شده
.TP
\fB\-\-cert\-email\fR=\fIEMAIL\fR
افزودن شناسه کاربری به کلیدی که یکی از شناسه‌های کاربری آن شامل نشانی رایانامه مشخص‌شده باشد
.TP
\fB\-\-cert\-file\fR=\fIPATH\fR
افزودن شناسه کاربری به کلید خوانده‌شده از PATH
.TP
\fB\-\-cert\-userid\fR=\fIUSERID\fR
افزودن شناسه کاربری به کلید با شناسه کاربری مشخص‌شده
.TP
\fB\-\-email\fR=\fIADDRESS\fR
افزودن یک نشانی رایانامه به عنوان شناسه کاربری به کلید
.TP
\fB\-\-name\fR=\fINAME\fR
افزودن یک نام به عنوان شناسه کاربری به کلید
.TP
\fB\-\-output\fR=\fIFILE\fR
نوشتن در FILE مشخص‌شده
.IP
اگر مشخص نشود و گواهی از مخزن گواهی‌ها خوانده شده باشد، گواهی اصلاح‌شده به مخزن گواهی‌ها وارد (import) می‌شود. اگر مشخص نشود و گواهی از یک فایل خوانده شده باشد، گواهی اصلاح‌شده در خروجی استاندارد نوشته می‌شود.
.TP
\fB\-\-userid\fR=\fIUSERID\fR
افزودن یک شناسه کاربری به کلید
.IP
این شناسه کاربری می‌تواند نام و نشانی رایانامه را ترکیب کند، می‌تواند به صورت اختیاری شامل یک یادداشت باشد، یا در صورت ارائه گزینه
`\-\-allow\-non\-canonical\-userids`
حتی دارای ساختاری آزاد باشد. با این حال، شناسه‌های کاربری شامل اطلاعات گوناگون مانند نام و نشانی رایانامه، تحلیل و پردازش دشوارتری دارند؛ بنابراین امروزه استفاده از شناسه‌های کاربری متمایز برای نام و نشانی رایانامه ترجیح داده می‌شود.
.IP
در صورت تردید، استفاده از `\-\-name` و `\-\-email` ترجیح دارد.

.SS "گزینه‌های عمومی (Global options)"
برای مشاهده توضیحات گزینه‌های عمومی به \fBsq\fR(1) مراجعه کنید.
.SH "مثال‌ها (EXAMPLES)"
.PP

.PP
# افزودن یک شناسه کاربری جدید به کلید Alice.
.PP
.nf
.RS
sq key userid add \-\-cert \\
.RE
.RS
.RS
EB28F26E2739A4870ECC47726F0073F60FD0CBF0 \-\-name Alice \\
.RE
.RE
.RS
.RS
\-\-email alice@work.example.com
.RE
.RE
.fi
.SH "همچنین ببینید (SEE ALSO)"
.nh
\fBsq\fR(1), \fBsq\-key\fR(1), \fBsq\-key\-userid\fR(1).
.hy
.PP
برای مستندات کامل به <https://book.sequoia\-pgp.org> مراجعه کنید.
.SH "نسخه (VERSION)"
1.4.0