.\" 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" "8" "2026\-08\-31"
.PP
.SH "نام (NAME)"
apk \- ابزار مدیریت بسته‌های آلپاین (Alpine Package Keeper)
.PP
.SH "خلاصه دستور (SYNOPSIS)"
.PP
\fBapk\fR [<\fIگزینه‌های سراسری\fR>.\&.\&.\&] \fIدستور\fR [<\fIگزینه‌ها\fR>.\&.\&.\&] [<\fIآرگومان‌ها\fR>.\&.\&.\&]
.PP
.SH "توضیحات (DESCRIPTION)"
.PP
دستور \fBapk\fR بسته‌های نصب‌شده روی سیستم را مدیریت می‌کند.\& مجموعه محدودیت‌های سطح بالا روی بسته‌های سیستم، \fIworld\fR نامیده می‌شود (نگاه کنید به \fBapk\-world\fR(5)).\&
.PP
دستور \fBapk\fR از زیردستورهای متعددی برای پرس‌وجو و مدیریت \fIworld\fR و مخازن بسته‌ها پشتیبانی می‌کند.\&
.PP
تمام دستورات apk که پایگاه داده را تغییر می‌دهند، در /var/log/apk.\&log ثبت می‌شوند.\&
.PP
به‌طور پیش‌فرض apk به صورت غیرتعاملی اجرا می‌شود.\& برای تغییر این رفتار پیش‌فرض به حالت تعاملی، به بخش \fBفایل‌ها (FILES)\fR یا گزینه \fB\-\-interactive\fR مراجعه کنید.\&
.PP
تنها \fIگزینه‌های سراسری\fR باید پیش از \fIدستور\fR مشخص شوند.\& جهت سازگاری با نسخه‌های پیشین، تلاشی برای پردازش گزینه‌های اختصاصی هر اپلت پیش از \fIدستور\fR صورت می‌گیرد، اما این قابلیت منسوخ شده و در آینده حذف خواهد شد.\&
.PP
.SH "دستورات (COMMANDS)"
.PP
هر دستور با جزئیات کامل در صفحه راهنمای اختصاصی خود مستند شده است.\&
.PP
.SS "نصب و حذف بسته (PACKAGE INSTALLATION AND REMOVAL)"
.PP
.TS
l lx
l lx.
T{
\fBapk\-add\fR(8)
T}	T{
افزودن یا تغییر محدودیت‌ها در \fIworld\fR و اعمال تغییرات
T}
T{
\fBapk\-del\fR(8)
T}	T{
حذف محدودیت‌ها از \fIworld\fR و اعمال تغییرات
T}
.TE
.sp 1
.SS "نگهداری سیستم (SYSTEM MAINTENANCE)"
.PP
.TS
l lx
l lx
l lx
l lx.
T{
\fBapk\-fix\fR(8)
T}	T{
تعمیر، نصب مجدد یا ارتقای بسته‌ها بدون تغییر \fIworld\fR
T}
T{
\fBapk\-update\fR(8)
T}	T{
به‌روزرسانی نمایه‌های مخزن
T}
T{
\fBapk\-upgrade\fR(8)
T}	T{
نصب ارتقاهای موجود از مخازن
T}
T{
\fBapk\-cache\fR(8)
T}	T{
مدیریت حافظه موقت (کَش) محلی بسته‌ها
T}
.TE
.sp 1
.SS "پرس‌وجوی اطلاعات بسته (QUERYING PACKAGE INFORMATION)"
.PP
.TS
l lx
l lx
l lx
l lx
l lx
l lx.
T{
\fBapk\-query\fR(8)
T}	T{
پرس‌وجوی اطلاعات درباره بسته‌ها بر اساس معیارهای گوناگون
T}
T{
\fBapk\-list\fR(8)
T}	T{
فهرست کردن بسته‌های منطبق با یک الگو یا معیارهای دیگر
T}
T{
\fBapk\-dot\fR(8)
T}	T{
ترسیم وابستگی‌ها به‌صورت گراف‌های graphviz
T}
T{
\fBapk\-policy\fR(8)
T}	T{
نمایش خط‌مشی مخزن برای بسته‌ها
T}
T{
\fBapk\-search\fR(8)
T}	T{
جستجوی بسته‌ها بر اساس نام یا توضیحات
T}
T{
\fBapk\-info\fR(8)
T}	T{
ارائه اطلاعات دقیق درباره بسته‌ها یا مخازن
T}
.TE
.sp 1
.SS "نگهداری مخزن و بسته (REPOSITORY AND PACKAGE MAINTENANCE)"
.PP
.TS
l lx
l lx
l lx
l lx
l lx
l lx
l lx
l lx.
T{
\fBapk\-mkndx\fR(8)
T}	T{
ایجاد فایل نمایه مخزن (نسخه ۳) از بسته‌ها
T}
T{
\fBapk\-mkpkg\fR(8)
T}	T{
ایجاد بسته (نسخه ۳)
T}
T{
\fBapk\-index\fR(8)
T}	T{
ایجاد فایل نمایه مخزن (نسخه ۲) از بسته‌ها
T}
T{
\fBapk\-fetch\fR(8)
T}	T{
بارگیری بسته‌ها از مخازن به یک دایرکتوری محلی
T}
T{
\fBapk\-manifest\fR(8)
T}	T{
نمایش چکسام‌های محتوای بسته
T}
T{
\fBapk\-extract\fR(8)
T}	T{
استخراج محتویات فایل بسته
T}
T{
\fBapk\-verify\fR(8)
T}	T{
تایید یکپارچگی و امضای بسته
T}
T{
\fBapk\-adbsign\fR(8)
T}	T{
امضا، امضای مجدد یا فشرده‌سازی مجدد بسته‌ها و نمایه‌های نسخه ۳
T}
.TE
.sp 1
.SS "متفرقه (MISCELLANEOUS)"
.PP
.TS
l lx
l lx
l lx
l lx
l lx
l lx
l lx.
T{
\fBapk\-audit\fR(8)
T}	T{
بازرسی سیستم برای یافتن تغییرات
T}
T{
\fBapk\-stats\fR(8)
T}	T{
نمایش آمار درباره مخازن و موارد نصب‌شده
T}
T{
\fBapk\-version\fR(8)
T}	T{
مقایسه نگارش‌های بسته یا اجرای آزمون‌ها روی رشته‌های نگارش
T}
T{
\fBapk\-adbdump\fR(8)
T}	T{
تخلیه فایل‌های نسخه ۳ در قالب نمایش متنی
T}
T{
\fBapk\-adbgen\fR(8)
T}	T{
تولید فایل‌های نسخه ۳ از نمایش متنی
T}
T{
\fBapk\-convdb\fR(8)
T}	T{
تبدیل پایگاه داده نصب‌شده نسخه ۲ به قالب نسخه ۳
T}
T{
\fBapk\-convndx\fR(8)
T}	T{
تبدیل نمایه‌های نسخه ۲ به قالب نسخه ۳
T}
.TE
.sp 1
.SH "نحو گزینه‌ها (OPTION SYNTAX)"
.PP
آرگومان \fIBOOL\fR برای گزینه‌ها برابر با '\&\fByes\fR'\& یا '\&\fBno\fR'\& است.\&
آرگومان \fIAUTO\fR برای گزینه‌ها برابر با '\&\fByes\fR'\&، '\&\fBno\fR'\& یا '\&\fBauto\fR'\& است.\&
مقدار پیش‌فرض برای این آرگومان‌ها وابسته به هر گزینه است.\&
.PP
برای گزینه‌های دارای آرگومان \fIAUTO\fR یا \fIBOOL\fR، آرگومان باید با قالب \fB\-\-option=argument\fR مشخص شود (به این معنی که قالب \fB\-\-option argument\fR پشتیبانی نمی‌شود).\& علاوه بر این، نام‌های مستعار زیر در دسترس هستند:
.RS 4
.PD 0
.IP \(bu 4
\fB\-\-option\fR معادل \fB\-\-option=yes\fR است
.IP \(bu 4
\fB\-\-no\-option\fR معادل \fB\-\-option=no\fR است
.PD
.PP
.RE
.SH "گزینه‌های سراسری (GLOBAL OPTIONS)"
.PP
گزینه‌های زیر برای تمام دستورات در دسترس هستند.\&
.PP
\fB\-\-allow\-untrusted\fR
.RS 4
نصب بسته‌ها با امضای نامعتبر یا بدون امضا.\&
.PP
.RE
\fB\-\-arch\fR \fIARCH\fR
.RS 4
بازنویسی موقت معماری‌ها.\& نخستین \fB\-\-arch\fR داده‌شده به عنوان معماری اصلی استفاده خواهد شد.\& از آن برای تعیین مسیرهایی که نمایه‌های بسته باید از آن‌ها دانلود شوند استفاده می‌شود.\& معماری‌های اضافی، بسته‌های سازگاری را که برای نصب مد نظر قرار می‌گیرند مشخص می‌کنند.\&
.PP
هنگامی که همراه با \-\-root استفاده شود، معماری نیز ذخیره خواهد شد.\&
.PP
.RE
\fB\-\-cache\fR[=\fIBOOL\fR]
.RS 4
در صورت غیرفعال بودن، از استفاده از هرگونه مسیر حافظه موقت (کَش) محلی جلوگیری می‌کند.\&
.PP
.RE
\fB\-\-cache\-dir\fR \fICACHEDIR\fR
.RS 4
بازنویسی موقت دایرکتوری حافظه موقت (کَش).\& با \fICACHEDIR\fR به‌صورت نسبی نسبت به \fIROOT\fR رفتار می‌شود.\&
.PP
.RE
\fB\-\-cache\-max\-age\fR \fIAGE\fR
.RS 4
حداکثر زمان AGE (بر حسب دقیقه) برای نمایه در حافظه موقت پیش از تازه‌سازی آن.\& مقدار \fB0\fR به معنای تازه‌سازی همیشگی است.\&
.PP
.RE
\fB\-\-cache\-packages\fR[=\fIBOOL\fR]
.RS 4
ذخیره یک نسخه از بسته‌ها در زمان نصب در حافظه موقت.\& در صورت وجود پیوند نمادین \fB/etc/apk/cache\fR به‌طور خودکار فعال می‌شود.\&
.PP
.RE
\fB\-\-cache\-predownload\fR[=\fIBOOL\fR]
.RS 4
دانلود بسته‌های مورد نیاز در حافظه موقت پیش از آغاز اعمال یک تراکنش.\& برای کارکرد صحیح نیازمند پیکربندی حافظه موقت است.\& به طور ضمنی \fB\-\-cache\-packages\fR را فعال می‌کند.\&
.PP
.RE
\fB\-\-check\-certificate\fR[=\fIBOOL\fR]
.RS 4
در صورت غیرفعال بودن، اعتبارسنجی گواهی سرور HTTPS نادیده گرفته می‌شود.\&
.PP
.RE
\fB\-\-force\fR, \fB\-f\fR
.RS 4
فعال‌سازی گزینه‌های منتخب \-\-force\-* (منسوخ شده).\&
.PP
.RE
\fB\-\-force\-binary\-stdout\fR
.RS 4
ادامه عملیات حتی اگر داده‌های باینری در ترمینال چاپ شوند.\&
.PP
.RE
\fB\-\-force\-broken\-world\fR
.RS 4
خطرناک: حذف محدودیت‌های world تا زمانی که راه‌حلی بدون تداخل یافت شود.\& این گزینه اجازه نصب بسته‌هایی با وابستگی‌های برآورده‌نشده را نمی‌دهد و عمدتاً برای استفاده در بوت initramfs در نظر گرفته شده است و به طور ضمنی توسط \fB\-\-initramfs\-diskless\-boot\fR فعال می‌شود.\& هدف اصلی این است که به سیستم‌های اجراشونده از tmpfs اجازه دهد در صورتی که رسانه ارتقا یافته و برخی بسته‌ها دیگر در انتشار جدید در دسترس نیستند، بوت شوند.\&
.PP
ابزار APK تلاش خواهد کرد محدودیت‌های world را که باعث ایجاد بسته‌هایی با وابستگی‌های متداخل می‌شوند شناسایی کند و غیرفعال کردن محدودیت‌های world را به همین ترتیب آغاز نماید تا زمانی که مجموعه‌ای از محدودیت‌های قابل‌حل باقی بماند.\& استفاده از این سوییچ در نصب روی دیسک سخت احتمالاً منجر به حذف غیرمنتظره برخی بسته‌ها خواهد شد.\& در صورت عدم اطمینان، ابتدا آن را با \fB\-\-interactive\fR یا \fB\-\-simulate\fR استفاده کنید.\&
.PP
.RE
\fB\-\-force\-missing\-repositories\fR
.RS 4
ادامه عملیات حتی اگر برخی از نمایه‌های مخزن در دسترس نباشند.\&
.PP
.RE
\fB\-\-force\-no\-chroot\fR
.RS 4
غیرفعال کردن chroot برای اسکریپت‌ها.\& این گزینه می‌تواند برای ایجاد rootfs در زمانی که chroot در دسترس نیست استفاده شود.\& اسکریپت‌هایی که خارج از یک محیط chroot اجرا می‌شوند ممکن است سیستم میزبان را تغییر داده و به آن آسیب برسانند.\&
.PP
.RE
\fB\-\-force\-non\-repository\fR
.RS 4
ادامه عملیات حتی اگر بسته‌ها هنگام راه‌اندازی مجدد سیستم (reboot) از دست بروند.\& این حالت ممکن است هنگام اجرا در حالت اجرا از tmpfs و نصب بسته‌های غیرمخزنی رخ دهد.\&
.PP
.RE
\fB\-\-force\-old\-apk\fR
.RS 4
ادامه عملیات حتی اگر بسته‌ها از ویژگی‌های پشتیبانی‌نشده استفاده کنند.\&
.PP
.RE
\fB\-\-force\-overwrite\fR
.RS 4
بازنویسی فایل‌های موجود در بسته‌های دیگر.\&
.PP
.RE
\fB\-\-force\-refresh\fR
.RS 4
عدم استفاده از فایل‌های کَش‌شده (محلی یا از طریق پروکسی).\&
.PP
.RE
\fB\-\-help\fR, \fB\-h\fR
.RS 4
چاپ فهرست تمام دستورات همراه با توضیحات آن‌ها.\&
.PP
.RE
\fB\-\-interactive\fR[=\fIAUTO\fR]
.RS 4
تعیین اینکه آیا می‌توان پیش از انجام برخی عملیات‌ها سوال پرسید یا خیر.\& در حالت \fBauto\fR، در صورتی که برنامه روی یک tty اجرا شود، حالت تعاملی فعال خواهد شد.\& پیش‌فرض \fBno\fR است، یا اگر \fB/etc/apk/interactive\fR وجود داشته باشد برابر با \fBauto\fR خواهد بود.\&
.PP
.RE
\fB\-\-keys\-dir\fR \fIKEYSDIR\fR
.RS 4
بازنویسی دایرکتوری‌های پیش‌فرض کلیدهای معتمد سیستم.\& در صورت مشخص شدن، تنها این دایرکتوری پردازش می‌شود.\& با \fIKEYSDIR\fR به‌صورت نسبی نسبت به \fIROOT\fR رفتار می‌شود.\&
.PP
.RE
\fB\-\-legacy\-info\fR[=\fIBOOL\fR]
.RS 4
چاپ خروجی اپلت "info" در قالب قدیمی یا قالب جدید "query".\& در حال حاضر پیش‌فرض no است، اما این پیش‌فرض ممکن است در انتشارات آینده به yes تغییر کند.\&
.PP
.RE
\fB\-\-logfile\fR[=\fIBOOL\fR]
.RS 4
در صورت خاموش بودن، نوشتن در فایل لاگ را غیرفعال می‌کند.\&
.PP
.RE
\fB\-\-network\fR[=\fIBOOL\fR]
.RS 4
در صورت خاموش بودن، از شبکه استفاده نمی‌کند.\& از بسته‌های موجود در حافظه موقت که از مخازن شبکه‌ای هستند استفاده خواهد شد.\&
.PP
.RE
\fB\-\-preserve\-env\fR[=\fIBOOL\fR]
.RS 4
اجازه به انتقال متغیرهای محیطی کاربر به اسکریپت‌ها (به استثنای متغیرهایی که با APK_ شروع می‌شوند و رزرو شده‌اند).\&
.PP
.RE
\fB\-\-pretty\-print\fR[=\fIAUTO\fR]
.RS 4
تعیین اینکه آیا خروجی باید به صورت خوانا برای انسان سبک‌بندی شود یا خیر.\& پیش‌فرض \fBauto\fR است که در صورت اجرا روی tty به \fByes\fR تبدیل می‌شود.\&
.PP
.RE
\fB\-\-preupgrade\-depends\fR \fIDEPS\fR
.RS 4
افزودن یا تغییر وابستگی‌های پیش‌ارتقا (preupgrade).\& از وابستگی‌های پیش‌ارتقا برای تطبیق بسته‌های نصب‌شده‌ای که واجد شرایط پیش‌ارتقا هستند استفاده می‌شود.\& برای نمونه '\&apk\-tools'\& همیشه بسته '\&apk\-tools'\& را پیش‌ارتقا می‌دهد، اما '\&baselayout<2'\& بسته '\&baselayout'\& را تنها در صورتی پیش‌ارتقا می‌دهد که نسخه نصب‌شده baselayout کمتر از ۲ بوده و ارتقایی در دسترس باشد.\& همچنین نگاه کنید به \fBapk\-upgrade\fR(8).\&
.PP
.RE
\fB\-\-print\-arch\fR
.RS 4
چاپ معماری پیش‌فرض و خروج.\&
.PP
.RE
\fB\-\-progress\fR[=\fIAUTO\fR]
.RS 4
فعال یا غیرفعال کردن نوار پیشرفت.\& پیش‌فرض \fBauto\fR است که در صورت اجرا روی tty به \fByes\fR تبدیل می‌شود.\&
.PP
.RE
\fB\-\-progress\-fd\fR \fIFD\fR
.RS 4
نوشتن وضعیت پیشرفت در توصیف‌کننده فایل (file descriptor) مشخص‌شده.\&
.PP
.RE
\fB\-\-purge\fR[=\fIBOOL\fR]
.RS 4
پاکسازی پیکربندی‌های تغییریافته و بسته‌های کَش‌شده.\& امکان حذف فایل‌های پیکربندی تغییریافته هنگام حذف بسته را فعال می‌کند.\& در عملیات پاکسازی حافظه موقت (cache clean)، حذف بسته‌های کَش‌شده غیرضروری (بسته‌های نصب‌نشده در نصب‌های tmpfs یا تمامی بسته‌ها در نصب‌های روی دیسک) را فعال می‌سازد.\&
.PP
.RE
\fB\-\-quiet\fR, \fB\-q\fR
.RS 4
چاپ اطلاعات کمتر.\&
.PP
.RE
\fB\-\-repositories\-file\fR \fIREPOFILE\fR
.RS 4
بازنویسی مخازن سیستم، نگاه کنید به \fBapk\-repositories\fR(5).\& مشخص کردن این گزینه، پردازش فایل معمول مخازن و دایرکتوری repositories.\&d را بازنویسی می‌کند.\& مقدار \fIREPOFILE\fR از نسخه apk 2.\&12.\&0_rc2 به بعد نسبت به دایرکتوری آغاز به کار تفسیر می‌شود.\&
.PP
.RE
\fB\-\-repository\fR, \fB\-X\fR \fIREPO\fR
.RS 4
مشخص کردن مخزن بسته‌های اضافی.\& دستورات مشخص‌شده در \fBapk\-repositories\fR(5) پردازش نمی‌شوند (برای این منظور از \fB\-\-repository\-config\fR استفاده کنید).\& علاوه بر این، مسیرهای نسبی پذیرفته شده و نسبت به دایرکتوری آغاز به کار تفسیر می‌شوند.\&
.PP
.RE
\fB\-\-repository\-config\fR \fIREPOCONFIG\fR
.RS 4
مشخص کردن پیکربندی مخزن بسته‌های اضافی.\& مقدار \fIREPOCONFIG\fR دقیقاً به همان روشی پردازش می‌شود که گویی از یک فایل \fB.\&list\fR مشخص‌شده در \fBapk\-repositories\fR(5) خوانده شده است.\&
.PP
.RE
\fB\-\-root\fR, \fB\-p\fR \fIROOT\fR
.RS 4
مدیریت سیستم فایل در \fIROOT\fR.\&
.PP
.RE
\fB\-\-root\-tmpfs\fR[=\fIAUTO\fR]
.RS 4
مشخص کردن اینکه آیا \fIROOT\fR یک سیستم فایل موقت است یا خیر.\& پیش‌فرض \fBauto\fR است که نوع سیستم فایل را به‌طور خودکار تشخیص می‌دهد.\&
.PP
این گزینه موارد زیر را تحت تأثیر قرار می‌دهد:
.RS 4
.PD 0
.IP \(bu 4
خواندن و ایجاد نمایه 'installed' در حافظه موقت
.IP \(bu 4
پاکسازی بسته‌ها در حافظه موقت
.IP \(bu 4
بررسی‌های ایمنی برای عدم نصب بسته‌های غیرمخزنی
.PD
.PP
.RE
.RE
\fB\-\-sync\fR[=\fIAUTO\fR]
.RS 4
تعیین اینکه آیا حافظه‌های موقت سیستم فایل باید روی دیسک ذخیره (commit) شوند یا خیر.\& پیش‌فرض \fBauto\fR است که اگر \fB\-\-root\fR مشخص نشده باشد، پایگاه داده در حالت کاربری نباشد، و روی فضای نام pid ریشه اجرا شود (کانتینری نباشد)، به \fByes\fR تبدیل می‌شود.\&
.PP
.RE
\fB\-\-timeout\fR \fITIME\fR
.RS 4
قطع اتصالات شبکه (تایم‌اوت) در صورتی که در مدت TIME ثانیه پیشرفتی حاصل نشود.\& مقدار پیش‌فرض ۶۰ ثانیه است.\&
.PP
.RE
\fB\-\-update\-cache\fR, \fB\-U\fR
.RS 4
نام مستعاری برای '\&\-\-cache\-max\-age 0'\&.\&
.PP
.RE
\fB\-\-uvol\-manager\fR \fIUVOL\fR
.RS 4
مشخص کردن مکان فایل اجرایی مدیریت حجم \fIuvol\fR در OpenWRT.\&
.PP
.RE
\fB\-\-verbose\fR, \fB\-v\fR
.RS 4
چاپ اطلاعات بیشتر (می‌تواند دو بار مشخص شود).\&
.PP
.RE
\fB\-\-version\fR, \fB\-V\fR
.RS 4
چاپ نگارش برنامه و خروج.\&
.PP
.RE
\fB\-\-wait\fR \fITIME\fR
.RS 4
انتظار به مدت TIME ثانیه برای دریافت قفل انحصاری مخزن پیش از اعلام خطا.\&
.PP
.RE
.SH "گزینه‌های اعمال تغییرات (COMMIT OPTIONS)"
.PP
گزینه‌های زیر برای تمام دستوراتی که تغییرات را در پایگاه داده اعمال (commit) می‌کنند در دسترس هستند.\&
.PP
\fB\-\-clean\-protected\fR[=\fIBOOL\fR]
.RS 4
در صورت غیرفعال بودن، از ایجاد فایل‌های .\&apk\-new در دایرکتوری‌های پیکربندی جلوگیری می‌کند.\&
.PP
.RE
\fB\-\-commit\-hooks\fR[=\fIBOOL\fR]
.RS 4
در صورت غیرفعال بودن، از اجرای اسکریپت‌های قلاب پیش/پس از اعمال تغییرات (pre/post hook) صرف‌نظر می‌کند (اما سایر اسکریپت‌ها اجرا می‌شوند).\&
.PP
.RE
\fB\-\-initramfs\-diskless\-boot\fR
.RS 4
توسط initramfs هنگام بازسازی tmpfs ریشه استفاده می‌شود.\& این گزینه گزینه‌های اجباری (force) منتخب را برای به حداقل رساندن خطاها فعال کرده و علاوه بر ویژگی‌های دیگر، قلاب‌های اعمال تغییرات را غیرفعال می‌کند.\&
.PP
.RE
\fB\-\-overlay\-from\-stdin\fR
.RS 4
خواندن فهرست فایل‌های overlay از ورودی استاندارد (stdin).\& معمولاً این گزینه تنها در طول initramfs هنگام بوت کردن یک نصب اجرا شونده از tmpfs استفاده می‌شود.\&
.PP
.RE
\fB\-\-scripts\fR[=\fIBOOL\fR]
.RS 4
در صورت غیرفعال بودن، از اجرای تمامی اسکریپت‌ها جلوگیری می‌کند.\& برای استخراج یک ایمیج سیستمی برای معماری متفاوت روی یک \fIROOT\fR جایگزین مفید است.\&
.PP
.RE
\fB\-\-simulate\fR[=\fIBOOL\fR], \fB\-s\fR
.RS 4
شبیه‌سازی عملیات درخواستی بدون اعمال هیچ‌گونه تغییر.\& پایگاه داده در حالت فقط‌خواندنی باز می‌شود و به‌روزرسانی خودکار نمایه‌ها غیرفعال می‌گردد.\& ممکن است بخواهید پیش از اجرای شبیه‌سازی دستور "apk update" را اجرا کنید تا مطمئن شوید با نمایه‌های به‌روز مخزن انجام می‌شود.\&
.PP
.RE
.SH "گزینه‌های تولید (GENERATION OPTIONS)"
.PP
گزینه‌های زیر برای تمام دستوراتی که فایل‌های APKv3 را تولید می‌کنند در دسترس هستند.\&
.PP
\fB\-\-compression\fR, \fB\-c\fR \fIALGORITHM[:LEVEL]\fR
.RS 4
فشرده‌سازی فایل با الگوریتم (\fIALGORITHM\fR) و سطح (\fILEVEL\fR) مشخص‌شده.\& الگوریتم‌های پشتیبانی‌شده:
.PD 0
.IP \(bu 4
none
.IP \(bu 4
deflate (سطح ۱\-۹)
.IP \(bu 4
zstd (سطح ۱\-۲۲)
.PD
.PP
.RE
\fB\-\-sign\-key\fR \fIKEYFILE\fR
.RS 4
امضای فایل با کلید خصوصی موجود در \fIKEYFILE\fR مشخص‌شده.\&
.PP
.RE
.SH "محیط (ENVIRONMENT)"
.PP
\fBAPK_CONFIG\fR
.RS 4
بازنویسی نام فایل پیکربندی پیش‌فرض.\& نگاه کنید به \fB/etc/apk/config\fR
.PP
.RE
\fBLANG\fR
.RS 4
برای تشخیص پشتیبانی از UTF\-8 و تنظیم نویسه پیشرفت پیش‌فرض بر اساس آن استفاده می‌شود.\&
.PP
.RE
\fBSOURCE_DATE_EPOCH\fR
.RS 4
نگاه کنید به \fBapk\-index\fR(8).\&
.PP
.RE
\fBTERM\fR
.RS 4
برای تعیین اینکه آیا ترمینال ساده (dumb) است یا خیر استفاده می‌شود.\& نوار پیشرفت به‌طور پیش‌فرض در ترمینال‌های dumb فعال نیست.\&
.PP
.RE
.SS "متغیرهایی برای پیکربندی libfetch داخلی (Variables to configure built\-in libfetch)"
.PP
\fBFETCH_BIND_ADDRESS\fR
.RS 4
یک آدرس IP محلی که libfetch تمام سوکت‌های ایجادشده خود را به آن متصل (bind) می‌کند.\& می‌تواند برای مسیریابی مبدأ مفید باشد.\&
.PP
.RE
\fBNETRC\fR
.RS 4
مشخص کردن فایل \fB.\&netrc\fR برای خواندن اطلاعات محرمانه احراز هویت.\& در صورت عدم تنظیم، پیش‌فرض \fB$HOME/.\&netrc\fR است.\&
.PP
.RE
\fBHTTP_AUTH\fR
.br
\fBHTTP_REFERER\fR
.br
\fBHTTP_USER_AGENT\fR
.RS 4
مشخص کردن هدر سفارشی سطح HTTP برای \fBAuthorization\fR، \fBReferer\fR یا \fBUser\-Agent\fR.\&
.PP
.RE
\fBHTTP_PROXY\fR, \fBhttp_proxy\fR
.br
\fBHTTPS_PROXY\fR, \fBhttps_proxy\fR
.RS 4
در صورت تنظیم، این متغیرها باید به ترتیب شامل نشانی URL پروکسی برای اتصالات \fBhttp\fR و \fBhttps\fR باشند.\&
.PP
.RE
\fBHTTP_PROXY_AUTH\fR
.RS 4
مشخص کردن هدر \fBProxy\-Authorization\fR در پروتکل HTTP.\& تنها در صورتی استفاده می‌شود که اتصال از طریق یک پروکسی HTTP پیکربندی‌شده برقرار شده باشد.\&
.PP
.RE
\fBNO_PROXY\fR, \fBno_proxy\fR
.RS 4
فهرستی جداشده با کاما از پسوندهای دامنه یا نشانی‌های IP با نمادگذاری CIDR که پروکسی \fInot\fR (نباید) برای آن‌ها استفاده شود.\& این مقدار صراحتاً فقط برای آزمایش بخش نام میزبان (hostname) در URL استفاده می‌شود.\& به این معنی که تعیین یک آدرس IP یا بلوک CIDR با نام DNS که به آن آدرس IP اشاره می‌کند تطابق نخواهد داشت.\&
.PP
.RE
\fBSSL_CLIENT_CERT_FILE\fR
.br
\fBSSL_CLIENT_KEY_FILE\fR
.RS 4
بازنویسی گواهی کلاینت SSL پیش‌فرض و نام فایل کلید خصوصی متناظر آن.\&
.PP
.RE
\fBSSL_NO_VERIFY_HOSTNAME\fR
.RS 4
اگر روی هر مقداری تنظیم شود، بررسی و اعتبارسنجی نام گواهی سرور را غیرفعال می‌کند.\&
.PP
.RE
.SS "محیط برای اسکریپت‌هایی که APK اجرا می‌کند (Environment for the scripts APK executes)"
.PP
به‌طور معمول \fBapk\fR اسکریپت‌ها را با یک محیط پاکسازی‌شده و حداقلی که تنها شامل \fBPATH\fR است اجرا می‌کند.\& همچنین برای انتقال متغیرهای محیطی بیشتر، \fB\-\-preserve\-env\fR را ببینید.\&
.PP
پیش از اجرای یک اسکریپت، apk دایرکتوری کاری را روی \fIROOT\fR تنظیم کرده و مگر در صورتی که \fB\-\-force\-no\-chroot\fR مشخص شده باشد یک chroot انجام می‌دهد.\& در هر دو حالت، باید با دایرکتوری کاری اسکریپت به عنوان ریشه سیستم رفتار شود.\&
.PP
متغیرهای محیطی تعریف‌شده توسط APK عبارتند از:
.PP
\fBAPK_PACKAGE\fR
.RS 4
نام بسته (تنها برای اسکریپت‌های بسته).\&
.PP
.RE
\fBAPK_SCRIPT\fR
.RS 4
روی یکی از انواع اسکریپت بسته یا commit تنظیم می‌شود.\& در صورت نیاز از این متغیر برای تعیین نوع قلاب اسکریپت استفاده کنید.\& نام فایل ($0) قابل اعتماد نیست زیرا apk ترجیح می‌دهد اسکریپت‌های بسته را از یک فایل memfd اجرا کند.\&
.PP
.RE
.SH "فایل‌ها (FILES)"
.PP
.SS "فایل‌های پیکربندی (Configuration files)"
.PP
\fB/etc/apk/config\fR
.br
\fB/lib/apk/config\fR
.RS 4
گزینه‌های سراسری پیش‌فرض.\& تنها نخستین فایلی که در فهرست بالا وجود داشته باشد خوانده و پردازش می‌شود.\& فایل موجود در \fB/lib\fR برای گزینه‌های پیش‌فرض توزیع در نظر گرفته شده است، که می‌تواند سپس توسط کاربر با فایل موجود در \fB/etc\fR بازنویسی شود.\& همچنین متغیر محیطی \fBAPK_CONFIG\fR را ببینید.\&
.PP
یک فایل پیکربندی شامل یک گزینه طولانی در هر خط است.\& برای نمونه:
.RS 4
no\-cache
.br
timeout 120
.PP
.RE
.RE
\fB/etc/apk/interactive\fR
.RS 4
اگر این فایل وجود داشته باشد، پیش‌فرض \fB\-\-interactive\fR را به \fBauto\fR تغییر می‌دهد.\&
.PP
.RE
.SS "فایل‌های پیکربندی (نسبت به \-\-root)"
.PP
\fB/etc/apk/arch\fR
.RS 4
معماری پردازنده (CPU) برای این پایگاه داده.\& برای مشاهده فهرست، بخش متاداده بسته در فیلد \fBarch\fR را در \fBapk\-package\fR(5) ببینید.\&
.PP
.RE
\fB/etc/apk/cache\fR
.RS 4
انتظار می‌رود این یک پیوند نمادین (symlink) به دایرکتوری مورد استفاده apk به عنوان حافظه موقت (کَش) بسته‌ها باشد.\& همچنین نگاه کنید به \fBapk\-cache\fR(5) و \fBapk\-cache\fR(8).\&
.PP
.RE
\fB/etc/apk/commit_hooks.\&d/*\fR
.br
\fB/lib/apk/commit_hooks.\&d/*\fR
.RS 4
اسکریپت‌های قلاب که پیش از نوشتن هر چیزی روی سیستم فایل و پس از اعمال تمام تغییرات اجرا می‌شوند.\& اسکریپت اجرا شده نام مرحله (\fBpre\-commit\fR یا \fBpost\-commit\fR) را به عنوان آرگومان دریافت می‌کند.\& اگر اسکریپت در مرحله \fBpre\-commit\fR با شکست مواجه شود، اعمال تغییرات متوقف (لغو) می‌شود.\&
.PP
همچنین برای متغیرهای محیطی، بخش \fBمحیط (ENVIRONMENT)\fR را ببینید.\&
.PP
اگر گزینه \fB\-\-no\-scripts\fR یا \fB\-\-no\-commit\-hooks\fR مشخص شده باشد، این اسکریپت‌های قلاب اجرا نخواهند شد.\&
.PP
.RE
\fB/etc/apk/keys\fR
.br
\fB/lib/apk/keys\fR
.RS 4
دایرکتوری‌هایی برای کلیدهای امضای معتمد.\& دایرکتوری‌ها به ترتیب ذکرشده در بالا پیمایش می‌شوند.\& به محض مشاهده یک نام فایل داده‌شده، هر فایلی با همان نام در دایرکتوری‌های بعدی نادیده گرفته می‌شود.\&
.PP
.RE
\fB/etc/apk/protected_paths.\&d/*.\&list\fR
.RS 4
فایل‌های پیکربندی برای تعیین نحوه برخورد با تغییرات در ماسک‌های دایرکتوری یا فایل‌های مشخص‌شده.\& فرمت فایل بیشتر در \fBapk\-protected_paths\fR(5) مستند شده است.\&
.PP
.RE
\fB/etc/apk/repositories\fR
.br
\fB/etc/apk/repositories.\&d/*.\&list\fR
.br
\fB/lib/apk/repositories.\&d/*.\&list\fR
.RS 4
فایل‌های پیکربندی برای تعیین مخازن.\& دایرکتوری‌ها به ترتیب ذکرشده در بالا پیمایش می‌شوند.\& به محض مشاهده یک نام فایل مشخص، هر فایلی با همان نام در دایرکتوری‌های بعدی نادیده گرفته می‌شود.\& برای جزئیات به \fBapk\-repositories\fR(5) مراجعه کنید.\&
.PP
.RE
\fB/etc/apk/world\fR
.RS 4
الزامات و محدودیت‌های سطح بالا در مورد آنچه باید نصب شود.\& برای جزئیات به \fBapk\-world\fR(5) مراجعه کنید.\&
.PP
.RE
.SS "فایل‌های پیکربندی برای libfetch داخلی (Configuration files for built\-in libfetch)"
.PP
\fB/etc/apk/ca.\&pem\fR
.RS 4
مجموعه مخزن گواهی‌های CA برای تایید گواهی‌های سرور.\& در صورت عدم وجود، از مخزن CA پیش‌فرض سیستم استفاده می‌شود.\&
.PP
.RE
\fB/etc/apk/crl.\&pem\fR
.RS 4
مخزن لیست ابطال گواهی (CRL) برای بررسی گواهی‌های سرور در برابر آن.\&
.PP
.RE
\fB/etc/apk/cert.\&key\fR
.RS 4
کلید خصوصی گواهی کلاینت.\&
.PP
.RE
\fB/etc/apk/cert.\&pem\fR
.RS 4
گواهی کلاینت برای استفاده در احراز هویت.\&
.PP
.RE
.SS "فایل‌های سیستم (System files)"
.PP
\fB/lib/apk/db/lock\fR
.RS 4
یک فایل قفل که برای مجاز دانستن تنها یک تراکنش نوشتن هم‌زمان روی سیستم استفاده می‌شود.\&
.PP
.RE
\fB/lib/apk/db/installed\fR
.RS 4
پایگاه داده بسته‌های نصب‌شده و محتویات آن‌ها.\&
.PP
.RE
\fB/lib/apk/db/scripts.\&tar\fR
.br
\fB/lib/apk/db/scripts.\&tar.\&gz\fR
.RS 4
مجموعه‌ای از تمام اسکریپت‌های بسته از بسته‌هایی که در حال حاضر نصب هستند.\&
.PP
.RE
\fB/lib/apk/db/triggers\fR
.RS 4
فهرست قوانین تریگرها برای بسته‌هایی که در حال حاضر نصب هستند.\&
.PP
.RE
\fB/lib/apk/db\-uvol\fR
.RS 4
پیوند نمادین پایگاه داده یا دایرکتوری با ساختار مشابه با \fB/lib/apk/db/\fR، اما زمانی برای محتوای بسته استفاده می‌شود که با استفاده از مدیر حجم \fBuvol\fR در OpenWRT مدیریت شود.\&
.PP
.RE
\fB/lib/apk/exec\fR
.RS 4
دایرکتوری موقت برای استخراج و اجرای اسکریپت‌ها و تریگرهای بسته.\&
.PP
.RE
\fB/var/log/apk.\&log\fR
.RS 4
فایل لاگ برای تغییرات انجام‌شده روی سیستم.\&
.PP
.RE
.SH "نکات (NOTES)"
.PP
این نسخه از apk قابلیت آماده کردن قهوه را نیز دارد.\&