.\" Generated by scdoc 1.11.5
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "apk\-add" "8" "2026\-08\-31"
.PP
.SH "نام (NAME)"
apk-add \- افزودن یا به‌روزرسانی محدودیت‌ها در \fIworld\fR و اعمال تغییرات
.PP
.SH "خلاصه دستور (SYNOPSIS)"
.PP
\fBapk add\fR [<\fIگزینه‌ها\fR>.\&.\&.\&] [\fIمحدودیت‌ها\fR|\fIفایل\fR].\&.\&.\&
.PP
.SH "توضیحات (DESCRIPTION)"
.PP
دستور \fBapk add\fR محدودیت‌های داده‌شده را به \fIworld\fR می‌افزاید یا به‌روزرسانی می‌کند (نگاه کنید به \fBapk\-world\fR(5)) و تغییرات را روی دیسک اعمال می‌نماید.\& این کار معمولاً شامل نصب بسته‌های جدید است، اما ممکن است باعث ایجاد تغییرات دیگری نیز در بسته‌های نصب‌شده شود.\&
.PP
برای ارتقای بسته‌های تکی بدون تغییر دادن \fIworld\fR از \fBapk\-fix\fR(8) استفاده کنید.\&
.PP
به‌طور پیش‌فرض \fBapk\fR تلاش می‌کند مجموعه‌ای از بسته‌ها را انتخاب کند تا تمامی محدودیت‌ها برآورده شوند.\& این بدان معناست که در صورت وجود وابستگی‌های مستقیم یا ضمنی به نسخه قدیمی‌تر، ممکن است برخی بسته‌ها در نسخه‌ای قدیمی‌تر نگه داشته شوند.\&
.PP
اگر یک \fIفایل\fR اضافه شود، محدودیتی بر اساس هش هویت بسته اضافه خواهد شد.\& این محدودیت تضمین می‌کند که دقیقاً همان فایل نصب و نگهداری شود.\& برای ارتقا یا تنزل نسخه بعدی به نسخه موجود در مخزن، از \fBapk upgrade \-\-available\fR استفاده کنید.\&
.PP
.SH "گزینه‌ها (OPTIONS)"
.PP
دستور \fBapk add\fR از گزینه‌های commit توضیح داده‌شده در \fBapk\fR(8) و همچنین گزینه‌های زیر پشتیبانی می‌کند:
.PP
\fB\-\-initdb\fR
.RS 4
راه‌اندازی اولیه یک پایگاه‌داده جدید بسته.\&
.PP
.RE
\fB\-\-latest\fR, \fB\-l\fR
.RS 4
همیشه جدیدترین بسته بر اساس نسخه انتخاب شود.\& با این حال، نسخه‌های مد نظر بر اساس پین‌کردن بسته (package pinning) هستند.\& این گزینه در درجه اول روش اکتشافی (heuristic) پیش‌فرض را لغو می‌کند و در صورتی که همه وابستگی‌ها برآورده نشوند، باعث نمایش خطا خواهد شد.\&
.PP
.RE
\fB\-\-no\-chown\fR
.RS 4
نام مستعار منسوخ‌شده برای \-\-usermode.\&
.PP
.RE
\fB\-\-upgrade\fR, \fB\-u\fR
.RS 4
ارتقای \fIبسته‌ها\fR و وابستگی‌های آن‌ها.\& به‌طور معمول \fBapk add\fR از تغییر بسته‌های نصب‌شده خودداری می‌کند، مگر آنکه توسط \fIبسته‌ها\fRی جدید اضافه‌شده یا وابستگی‌های آن‌ها نیاز باشد.\& این گزینه اولویت پیش‌فرض را به ارتقای بسته به جدیدترین نسخه قابل نصب تغییر می‌دهد.\&
.PP
.RE
\fB\-\-usermode\fR
.RS 4
ایجاد پایگاه‌داده حالت کاربری با \-\-initdb.\& در حالت کاربری، apk به شکلی عمل می‌کند که نیازی به دسترسی ریشه (root) نباشد.\& در حال حاضر این حالت شامل موارد زیر است:
.PD 0
.IP \(bu 4
بررسی اجرای دستور به عنوان کاربر غیرریشه
.IP \(bu 4
تغییر ندادن مالک یا گروه فایل
.IP \(bu 4
تنظیم نکردن ویژگی‌های توسعه‌یافته سیستمی (xattrs)
.PD
.PP
این به این معناست که فرآیند نصب ممکن است عملکرد کاملی نداشته باشد.\& با این حال، این حالت برای مقاصد آزمایشی یا ایجاد chroot که در آن برنامه‌های خاصی می‌توانند به صورت غیرریشه اجرا شوند، مفید است.\&
.PP
.RE
\fB\-\-virtual\fR, \fB\-t\fR \fINAME\fR
.RS 4
ایجاد بسته مجازی \fINAME\fR با وابستگی‌های داده‌شده.\& این بسته جدید به جای \fIworld\fR، \fIبسته‌ها\fR را به عنوان وابستگی دریافت خواهد کرد.\& در نهایت \fINAME\fR به \fIworld\fR افزوده می‌شود.\& یک مشخص‌کننده نسخه اختیاری برای بسته مجازی را می‌توان از طریق ساختار \fINAME\fR=\fIVERSION\fR تعیین کرد.\& مقدار پیش‌فرض نسخه، یک نسخه ترکیبی بر مبنای زمان است.\&
.PP
می‌توان از این گزینه استفاده کرد تا اطمینان حاصل شود مجموعه‌ای از بسته‌ها نصب می‌شوند، و سپس بعداً این تغییر موقت با \fBapk\-del\fR(8) \fINAME\fR بدون حذف بسته‌هایی که پیش‌تر نصب شده بودند، لغو گردد.\&
.RE