'\" t .\" Title: pacman-key .\" Author: [بخش "نویسندگان" را ببینید] .\" Generator: DocBook XSL Stylesheets vsnapshot .\" Date: 2026-05-06 .\" Manual: راهنمای Pacman .\" Source: Pacman 7.1.0 .\" Language: Persian .\" .TH "PACMAN\-KEY" "8" "2026\-05\-06" "Pacman 7\&.1\&.0" "راهنمای Pacman" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "نام (NAME)" pacman-key \- مدیریت فهرست کلیدهای مورد اعتماد pacman .SH "خلاصه دستور (SYNOPSIS)" .sp \fIpacman\-key\fR [options] operation [targets] .SH "توضیحات (DESCRIPTION)" .sp \fIpacman\-key\fR یک اسکریپت پوششی برای GnuPG است که جهت مدیریت دسته‌کلید pacman به کار می‌رود؛ دسته‌کلید مجموعه‌ای از کلیدهای PGP است که برای بررسی بسته‌ها و پایگاه‌های داده امضاشده استفاده می‌شود\&. این ابزار امکان وارد کردن و صادر کردن کلیدها، دریافت کلیدها از کارگزارهای کلید و به‌روزرسانی پایگاه داده اعتماد کلید را فراهم می‌کند\&. .sp مدیریت پیچیده‌تر دسته‌کلید را می‌توان با استفاده مستقیم از GnuPG همراه با گزینه \fI\-\-homedir\fR که به دسته‌کلید pacman (به‌طور پیش‌فرض در /etc/pacman\&.d/gnupg) اشاره دارد، انجام داد\&. .sp فراخوانی pacman\-key شامل ارائه یک عمل (operation) به همراه گزینه‌ها و هدف‌های احتمالی برای اجرا است\&. بسته به نوع عملیات، یک \fItarget\fR می‌تواند یک شناسه کلید معتبر، نام فایل، یا شاخه باشد\&. .SH "عملیات‌ها (OPERATIONS)" .PP \fB\-a, \-\-add\fR .RS 4 کلید(های) موجود در فایل یا فایل‌های مشخص‌شده را به دسته‌کلید pacman اضافه می‌کند\&. اگر کلیدی از قبل وجود داشته باشد، آن را به‌روزرسانی می‌کند\&. .RE .PP \fB\-d, \-\-delete\fR .RS 4 کلید(های) مشخص‌شده با شناسه(های) کلید تعیین‌شده را از دسته‌کلید pacman حذف می‌کند\&. .RE .PP \fB\-e, \-\-export\fR .RS 4 کلید(های) مشخص‌شده با شناسه(های) کلید تعیین‌شده را به \fIstdout\fR صادر می‌کند\&. اگر هیچ شناسه‌ای مشخص نشود، تمام کلیدها صادر خواهند شد\&. .RE .PP \fB\-\-edit\-key\fR .RS 4 منویی را برای کارهای مدیریت کلید روی شناسه(های) کلید مشخص‌شده نمایش می‌دهد\&. برای تنظیم سطح اعتماد کلیدها کاربرد دارد\&. .RE .PP \fB\-f, \-\-finger\fR .RS 4 اثر انگشت هر شناسه کلید مشخص‌شده، یا تمام کلیدهای شناخته‌شده را در صورتی که هیچ شناسه‌ای مشخص نشده باشد، فهرست می‌کند\&. .RE .PP \fB\-h, \-\-help\fR .RS 4 ترکیب نحوی و گزینه‌های خط فرمان را نمایش می‌دهد\&. .RE .PP \fB\-\-import\fR .RS 4 کلیدها را از pubring\&.gpg در شاخه‌های مشخص‌شده به دسته‌کلید عمومی وارد می‌کند\&. .RE .PP \fB\-\-import\-trustdb\fR .RS 4 مقادیر اعتماد مالک (ownertrust) را از trustdb\&.gpg در شاخه‌های مشخص‌شده به پایگاه داده اعتماد مشترک وارد می‌کند\&. .RE .PP \fB\-\-init\fR .RS 4 اطمینان حاصل می‌کند که دسته‌کلید به‌درستی مقداردهی اولیه شده و مجوزهای دسترسی لازم را دارد\&. .RE .PP \fB\-l, \-\-list\-keys\fR .RS 4 تمام کلیدها یا کلیدهای مشخص‌شده را از دسته‌کلید عمومی فهرست می‌کند\&. .RE .PP \fB\-\-list\-sigs\fR .RS 4 همانند \fI\-\-list\-keys\fR است، اما امضاها نیز فهرست می‌شوند\&. .RE .PP \fB\-\-lsign\-key\fR .RS 4 کلید داده‌شده را به‌صورت محلی امضا می‌کند\&. این کار عمدتاً برای ایجاد ریشه شبکه اعتماد در کلید خصوصی محلی تولیدشده توسط \fI\-\-init\fR استفاده می‌شود\&. .RE .PP \fB\-\-nocolor\fR .RS 4 خروجی رنگی pacman\-key را غیرفعال می‌کند\&. .RE .PP \fB\-r, \-\-recv\-keys\fR .RS 4 معادل \fI\-\-recv\-keys\fR در GnuPG است\&. .RE .PP \fB\-\-refresh\-keys\fR .RS 4 معادل \fI\-\-refresh\-keys\fR در GnuPG است\&. .RE .PP \fB\-\-populate\fR .RS 4 کلیدهای پیش‌فرض را از دسته‌کلیدهای (اختیاری ارائه‌شده) در /usr/share/pacman/keyrings مجدداً بارگذاری می‌کند\&. برای اطلاعات بیشتر، بخش ارائه دسته‌کلید برای وارد کردن (PROVIDING A KEYRING FOR IMPORT) در زیر را ببینید\&. .RE .PP \fB\-u, \-\-updatedb\fR .RS 4 معادل \fI\-\-check\-trustdb\fR در GnuPG است\&. این عملیات می‌تواند همراه با عملیات‌های دیگر مشخص شود\&. .RE .PP \fB\-V, \-\-version\fR .RS 4 نسخه برنامه را نمایش می‌دهد\&. .RE .PP \fB\-v, \-\-verify\fR .RS 4 فرض می‌کند که آرگومان اول یک امضا است و آن را تأیید می‌کند\&. اگر آرگومان دومی ارائه شود، آن فایلی است که باید تأیید شود\&. .sp اگر تنها یک آرگومان داده شده باشد، فرض می‌کند که امضا یک امضای جداگانه (detached) است و با حذف پسوند فایل به دنبال فایل داده متناظر برای بررسی می‌گردد\&. در صورتی که فایل داده متناظری یافت نشود، به روش‌های معنایی GnuPG بازگشته و تلاش می‌کند فایلی با امضای تعبیه‌شده را تأیید کند\&. .RE .SH "گزینه‌ها (OPTIONS)" .PP \fB\-\-config\fR .RS 4 استفاده از یک فایل پیکربندی جایگزین به جای حالت پیش‌فرض /etc/pacman\&.conf\&. .RE .PP \fB\-\-gpgdir\fR .RS 4 تنظیم یک شاخه خانگی جایگزین برای GnuPG\&. در صورت نامشخص بودن، این مقدار از /etc/pacman\&.conf خوانده می‌شود\&. .RE .PP \fB\-\-keyserver\fR .RS 4 استفاده از کارگزار کلید مشخص‌شده در صورتی که عملیات به آن نیاز داشته باشد\&. این گزینه بر هر گزینه keyserver مشخص‌شده در فایل پیکربندی gpg\&.conf اولویت خواهد داشت\&. اجرای \fI\-\-init\fR با این گزینه، در صورت پیکربندی نشدن قبلی، کارگزار کلید پیش‌فرض را تعیین می‌کند\&. .RE .SH "ارائه دسته‌کلید برای وارد کردن (PROVIDING A KEYRING FOR IMPORT)" .sp یک توزیع یا ارائه‌دهنده دیگر مخزن ممکن است بخواهد مجموعه‌ای از کلیدهای PGP را که برای امضای بسته‌ها و پایگاه‌های داده مخزن خود به کار می‌روند ارائه دهد تا بتوان آن‌ها را به‌راحتی به دسته‌کلید pacman وارد کرد\&. این امر با ارائه یک فایل دسته‌کلید PGP به نام foo\&.gpg که حاوی کلیدهای دسته‌کلید foo است در شاخه /usr/share/pacman/keyrings میسر می‌شود\&. .sp به‌طور اختیاری، فایل foo\-trusted می‌تواند ارائه شود که حاوی فهرستی از شناسه‌های کلیدهای مورد اعتماد برای آن دسته‌کلید است\&. این فایل دارای قالبی سازگار با خروجی \fIgpg \-\-export\-ownertrust\fR است\&. این فایل علاوه بر تخصیص مقادیر اعتماد مالک ارائه‌شده، کاربر را مطلع می‌سازد که برای ایجاد یک شبکه اعتماد محلی، لازم است کدام کلیدها را تأیید و امضا کند\&. .sp همچنین به‌طور اختیاری، فایل foo\-revoked می‌تواند ارائه شود که حاوی فهرستی از شناسه‌های کلیدهای باطل‌شده برای آن دسته‌کلید است\&. «باطل‌شده» به صورت «دیگر برای هیچ امضایی معتبر نیست» تعریف می‌شود، بنابراین باید با احتیاط استفاده شود\&. کلیدی که به عنوان باطل‌شده علامت‌گذاری شود، در دسته‌کلید غیرفعال خواهد شد و دیگر معتبر در نظر گرفته نمی‌شود؛ از این رو این مورد همیشه بر وضعیت مورد اعتماد بودن آن در هر دسته‌کلید دیگری اولویت دارد\&. .SH "همچنین ببینید (SEE ALSO)" .sp \fBpacman\fR(8), \fBpacman.conf\fR(5) .sp برای اطلاعات به‌روز در مورد pacman و ابزارهای مرتبط با آن، به وبگاه pacman در https://archlinux\&.org/pacman مراجعه کنید\&. .SH "اشکالات (BUGS)" .sp اشکال؟ حتماً شوخی می‌کنید؛ هیچ اشکالی در این نرم‌افزار وجود ندارد\&. اما اگر احیاناً در اشتباه بودیم، لطفاً با اطلاعات دقیق مانند خط فرمان، ماهیت اشکال و حتی در صورت مفید بودن پایگاه داده بسته، آن را در سامانه پیگیری اشکالات در https://gitlab\&.archlinux\&.org/pacman/pacman/\-/issues گزارش دهید\&. .SH "نویسندگان (AUTHORS)" .sp نگه‌دارندگان فعلی: .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Allan McRae .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Andrew Gregory .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Morgan Adamiec .RE .sp مشارکت‌کنندگان عمده پیشین: .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Judd Vinet .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Aurelien Foret .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Aaron Griffin .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Dan McGee .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Xavier Chantry .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Nagy Gabor .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Dave Reisner .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Eli Schwartz .RE .sp برای مشارکت‌کنندگان دیگر، از git shortlog \-s روی مخزن pacman\&.git استفاده کنید\&.