'\" t
.\"     Title: repo-add
.\"    Author: [بخش "نویسندگان" را ببینید]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 2026-05-06
.\"    Manual: راهنمای Pacman
.\"    Source: Pacman 7.1.0
.\"  Language: Persian
.\"
.TH "REPO\-ADD" "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)"
repo-add \- ابزار نگهداری پایگاه داده بسته‌ها
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fIrepo\-add\fR [options] <path\-to\-db> <package> [<package> \&...]
.sp
\fIrepo\-remove\fR [options] <path\-to\-db> <packagename> [<packagename> \&...]
.SH "توضیحات (DESCRIPTION)"
.sp
دستورهای \fIrepo\-add\fR و \fIrepo\-remove\fR دو اسکریپت برای کمک به ساخت پایگاه داده بسته‌ها برای بسته‌های ساخته‌شده با \fBmakepkg\fR(8) و نصب‌شده با \fBpacman\fR(8) هستند\&.
.sp
دستور \fIrepo\-add\fR پایگاه داده بسته‌ها را با خواندن یک فایل بستهٔ ساخته‌شده به‌روزرسانی می‌کند\&. می‌توان چندین بسته را برای افزودن در خط فرمان مشخص کرد\&.
.sp
اگر یک فایل \(lq\&.sig\(rq متناظر در کنار فایل بسته پیدا شود، امضا به‌طور خودکار درون پایگاه داده تعبیه خواهد شد\&.
.sp
دستور \fIrepo\-remove\fR پایگاه داده بسته‌ها را با حذف نام بستهٔ مشخص‌شده در خط فرمان به‌روزرسانی می‌کند\&. می‌توان چندین بسته را برای حذف در خط فرمان مشخص کرد\&.
.sp
یک پایگاه داده بسته یک فایل tar است که به‌طور اختیاری فشرده شده است\&. پسوندهای معتبر شامل \(lq\&.db\(rq به همراه یکی از پسوندهای بایگانی \(lq\&.tar\(rq، \(lq\&.tar\&.bz2\(rq، \(lq\&.tar\&.gz\(rq، \(lq\&.tar\&.lrz\(rq، \(lq\&.tar\&.lz\(rq، \(lq\&.tar\&.lz4\(rq، \(lq\&.tar\&.lzo\(rq، \(lq\&.tar\&.xz\(rq، \(lq\&.tar\&.zst\(rq یا \(lq\&.tar\&.Z\(rq می‌باشند\&. نیازی نیست فایل از قبل وجود داشته باشد، اما تمام شاخه‌های والد باید وجود داشته باشند\&.
.SH "گزینه‌های عمومی (COMMON OPTIONS)"
.PP
\fB\-q, \-\-quiet\fR
.RS 4
اجبار برنامه به بی‌صدا بودن و اجرای خاموش، به جز در مورد پیام‌های هشدار و خطا\&.
.RE
.PP
\fB\-s, \-\-sign\fR
.RS 4
تولید فایل امضای PGP با استفاده از GnuPG\&. این گزینه دستور
gpg \-\-detach\-sign
را روی پایگاه داده تولیدشده اجرا می‌کند تا در صورت دردسترس بودن عامل GPG، یک فایل امضای جداگانه بسازد\&. فایل امضا همان نام کامل فایل پایگاه داده به همراه پسوند \(lq\&.sig\(rq خواهد بود\&.
.RE
.PP
\fB\-k, \-\-key\fR <key>
.RS 4
مشخص کردن کلید مورد استفاده هنگام امضای بسته‌ها\&. این مورد را می‌توان با استفاده از متغیر محیطی GPGKEY نیز مشخص کرد\&. در صورت عدم تعیین در هر دو مکان، از کلید پیش‌فرض دسته‌کلید استفاده خواهد شد\&.
.RE
.PP
\fB\-v, \-\-verify\fR
.RS 4
تأیید امضای PGP پایگاه داده پیش از به‌روزرسانی آن\&. اگر امضا نامعتبر باشد، خطایی صادر شده و به‌روزرسانی انجام نمی‌شود\&.
.RE
.PP
\fB\-\-nocolor\fR
.RS 4
حذف رنگ از خروجی
\fIrepo\-add\fR
و
\fIrepo\-remove\fR\&.
.RE
.PP
\fB\-R, \-\-remove\fR
.RS 4
حذف فایل‌های قدیمی بسته از دیسک هنگام به‌روزرسانی یا حذف مدخل آن‌ها در پایگاه داده\&.
.RE
.PP
\fB\-w, \-\-wait\-for\-lock\fR
.RS 4
انتظار برای به‌دست آوردن فایل قفل\&. اگر تنظیم نشده باشد، در صورت عدم موفقیت در گرفتن قفل، دستور با کد خروج ۲ شکست می‌خورد\&. اگر تنظیم شود، تا زمان موفقیت برای گرفتن قفل تلاش مجدد خواهد کرد\&.
.RE
.SH "گزینه‌های REPO\-ADD (REPO\-ADD OPTIONS)"
.PP
\fB\-n, \-\-new\fR
.RS 4
تنها افزودن بسته‌هایی که از قبل در پایگاه داده وجود ندارند\&. در صورت تشخیص بسته‌های موجود، هشدار چاپ می‌شود اما دوباره اضافه نخواهند شد\&.
.RE
.PP
\fB\-p, \-\-prevent\-downgrade\fR
.RS 4
اگر نگارش جدیدتری از قبل وجود داشته باشد، بسته را به پایگاه داده اضافه نکن
.RE
.PP
\fB\-\-include\-sigs\fR
.RS 4
گنجاندن امضاهای PGP بسته در پایگاه داده مخزن (در صورت دردسترس بودن)
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
\fIrepo\-add\fR foo\&.db\&.tar\&.xz <pkg1> [<pkg2> \&...]
.sp
این دستور دو پایگاه دادهٔ جداگانه ایجاد می‌کند؛ یک پایگاه دادهٔ کوچک‌تر \(lqfoo\&.db\&.tar\&.xz\(rq که توسط pacman استفاده می‌شود و یک پایگاه دادهٔ بزرگ‌تر شامل فهرست فایل‌های بسته \(lqfoo\&.files\&.tar\&.xz\(rq برای استفاده توسط سایر ابزارها\&. اگرچه pacman می‌تواند از پایگاه دادهٔ بزرگ‌تر نیز استفاده کند (در صورتی که با پسوند db\&.tar* تغییر نام داده شود)، در حال حاضر مزیت اضافه‌ای در برابر بارگیری بزرگ‌تر وجود ندارد\&.
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBmakepkg\fR(8), \fBpacman\fR(8)
.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 <allan@archlinux\&.org>
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Andrew Gregory <andrew\&.gregory\&.8@gmail\&.com>
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Morgan Adamiec <morganamilo@archlinux\&.org>
.RE
.sp
مشارکت‌کنندگان عمده پیشین:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Judd Vinet <jvinet@zeroflux\&.org>
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Aurelien Foret <aurelien@archlinux\&.org>
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Aaron Griffin <aaron@archlinux\&.org>
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Dan McGee <dan@archlinux\&.org>
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Xavier Chantry <shiningxc@gmail\&.com>
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Nagy Gabor <ngaba@bibl\&.u\-szeged\&.hu>
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Dave Reisner <dreisner@archlinux\&.org>
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Eli Schwartz <eschwartz@archlinux\&.org>
.RE
.sp
برای مشارکت‌کنندگان دیگر، از git shortlog \-s روی مخزن pacman\&.git استفاده کنید\&.