.TH SQ 1 1.4.0 "Sequoia PGP" "User Commands"
.SH "نام (NAME)"
sq\-key\-userid \- مدیریت شناسه‌های کاربری
.SH "خلاصه دستور (SYNOPSIS)"
.br
\fBsq key userid add\fR [\fIOPTIONS\fR]  
.br
\fBsq key userid revoke\fR [\fIOPTIONS\fR]  
.SH "توضیحات (DESCRIPTION)"
مدیریت شناسه‌های کاربری (User IDs).
.PP
افزودن شناسه‌های کاربری به یک کلید، یا ابطال آن‌ها.
.PP

.SH "زیردستورها (SUBCOMMANDS)"
.SS "sq key userid add"
افزودن یک شناسهٔ کاربری.
.PP
یک شناسهٔ کاربری می‌تواند حاوی یک نام، مانند `Juliet`، یا یک نشانی رایانامه، مانند `<juliet@example.org>` باشد. از نظر تاریخی، نام و نشانی رایانامه معمولاً در یک شناسهٔ کاربری واحد ترکیب می‌شدند، مانند `Juliet <juliet@example.org>`. با این حال، تحلیل شناسه‌های کاربری که شامل اطلاعات متفاوتی مانند نام و نشانی رایانامه هستند دشوارتر است؛ بنابراین امروزه استفاده از شناسه‌های کاربری مجزا برای نام و نشانی رایانامه ترجیح داده می‌شود.
.PP
دستور `sq key userid add` از زمان مرجع تعیین‌شده توسط آرگومان سطح بالای `\-\-time` تبعیت می‌کند. این دستور زمان ایجاد امضای پیونددهندهٔ (binding signature) شناسهٔ کاربری را روی زمان مشخص‌شده تنظیم می‌کند.
.PP


.SS "sq key userid revoke"
ابطال یک شناسهٔ کاربری.
.PP
یک گواهی ابطال برای شناسهٔ کاربری ایجاد می‌کند.
.PP
اگر `\-\-revoker` یا `\-\-revoker\-file` مشخص شده باشد، از آن کلید برای ایجاد گواهی ابطال استفاده می‌شود. اگر آن کلید با گواهی‌ای که در حال ابطال است متفاوت باشد، این عمل به ابطال شخص ثالث (third\-party revocation) منجر خواهد شد. این حالت معمولاً تنها در صورتی مفید است که مالک گواهی، کلید مزبور را به عنوان باطل‌کنندهٔ تعیین‌شده (designated revoker) مشخص کرده باشد.
.PP
برای ابطال یک شناسهٔ کاربری، گواهی باید تحت شیوه‌نامهٔ (policy) فعلی معتبر باشد. اگر گواهی تحت شیوه‌نامهٔ فعلی معتبر نیست، ابطال کل گواهی یا تصحیح آن را با استفاده از `sq cert lint` پس از تأیید یکپارچگی گواهی مد نظر قرار دهید. اگر گواهی تحت شیوه‌نامهٔ فعلی معتبر باشد، اما شناسهٔ کاربری‌ای که می‌خواهید ابطال کنید معتبر نباشد، همچنان می‌توانید با استفاده از `\-\-add\-userid` آن شناسهٔ کاربری را ابطال کنید.
.PP
دستور `sq key userid revoke` از زمان مرجع تعیین‌شده توسط آرگومان سطح بالای `\-\-time` تبعیت می‌کند. در صورت تنظیم شدن، هنگام تعیین کلیدهای معتبر، به جای زمان فعلی از زمان مشخص‌شده استفاده می‌کند و زمان ایجاد گواهی ابطال را نیز به جای زمان فعلی روی زمان مرجع تنظیم می‌نماید.
.PP


.SH "مثال‌ها (EXAMPLES)"
.SS "sq key userid add"
.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
.PP
.SS "sq key userid revoke"
.PP

.PP
از رده خارج کردن یک شناسهٔ کاربری در کلید Alice.
.PP
.nf
.RS
sq key userid revoke \-\-cert \\
.RE
.RS
.RS
EB28F26E2739A4870ECC47726F0073F60FD0CBF0 \-\-userid \\
.RE
.RE
.RS
.RS
"Alice <alice@example.org>" \-\-reason retired \-\-message \\
.RE
.RE
.RS
.RS
"No longer at example.org."
.RE
.RE
.fi
.SH "همچنین ببینید (SEE ALSO)"
.nh
\fBsq\fR(1), \fBsq\-key\fR(1), \fBsq\-key\-userid\-add\fR(1), \fBsq\-key\-userid\-revoke\fR(1).
.hy
.PP
برای مستندات کامل، <https://book.sequoia\-pgp.org> را ببینید.
.SH "نسخه (VERSION)"
1.4.0