.\" 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\-repositories" "5" "2026\-08\-31"
.PP
.SH "نام (NAME)"
apk\-repositories \- فهرست مخازن بسته
.PP
.SH "توضیحات (DESCRIPTION)"
.PP
برنامه \fBapk\fR(8) تعاریف مخازن را از فایل‌های فوق (\fB/etc/apk/repositories\fR، \fB/etc/apk/repositories.\&d/*.\&list\fR و \fB/lib/apk/repositories.\&d/*.\&list\fR) بارگذاری می‌کند.\&
.PP
ابتدا فایل \fBrepositories\fR بارگذاری می‌شود.\& سپس در صورتی که از گزینه \fB\-\-repositories\-file\fR استفاده نشده باشد، مسیرهای \fBrepositories.\&d\fR پردازش می‌شوند.\& دایرکتوری‌ها به ترتیب ذکرشده پیمایش می‌شوند.\& به محض مشاهده یک فایل \fB.\&list\fR با نام مشخص، هر فایلی با همان نام در دایرکتوری‌های بعدی نادیده گرفته می‌شود.\&
.PP
.SH "قالب فایل (FILE FORMAT)"
.PP
هر خط از یکی از نحوهای (syntax) زیر پیروی می‌کند:
.PP
\fB# comment\fR
.RS 4
خط توضیح (کامنت) که نادیده گرفته می‌شود.\&
.PP
.RE
\fBset [\-default] key=value\fR
.RS 4
متغیر به نام \fBkey\fR را به \fBvalue\fR داده‌شده تنظیم می‌کند.\&
.PP
نام \fBkey\fR محدود به حروف، اعداد و نویسه خط زیرین (_) است و باید با یک حرف آغاز شود.\& نام‌های متغیر با پیشوند \fBAPK_\fR برای متغیرهای داخلی رزرو شده‌اند و توسط کاربر قابل تعریف نیستند.\&
.PP
پیش از انتساب، گسترش متغیر روی \fBvalue\fR انجام می‌شود.\&
.PP
اگر گزینه \fB\-default\fR مشخص شده باشد، در صورتی که \fBkey\fR از قبل وجود داشته باشد، مقدار آن تغییر نخواهد کرد.\&
.PP
در حال حاضر متغیرهای زیر تعریف شده‌اند:
.RS 4
.PD 0
.IP \(bu 4
\fBAPK_ARCH\fR، معماری اصلی پایگاه داده
.PD
.PP
.RE
.RE
\fBndx [@tag] url\fR
.br
\fB[v2|v3] [@tag] url [component.\&.\&.\&]\fR
.RS 4
اگر در اعلان مخزن، فیلد نوع حذف شود، مقدار پیش‌فرض آن \fBv2\fR خواهد بود (یا در صورتی که \fBurl\fR به \fB.\&adb\fR یا \fB.\&tar.\&gz\fR ختم شود، برابر با \fBndx\fR خواهد بود).\& اگر قالب \fBv3\fR باشد یا نام فایل \fBndx\fR به \fB.\&adb\fR ختم شود، یک فایل نمایه (index) با فرمت v3 الزامی است.\&
.PP
برچسب اختیاری \fB@tag\fR می‌تواند برای نشان دادن این موضوع استفاده شود که مخزن نباید به صورت پیش‌فرض استفاده گردد.\& برای چگونگی فعال‌سازی نصب بسته‌ها از مخازن برچسب‌خورده، به \fBapk\-world\fR(5) مراجعه کنید.\&
.PP
گسترش متغیر روی بخش‌های \fBurl\fR و \fBcomponent\fR به صورت جداگانه در زمان تجزیه خط انجام می‌شود.\&
.PP
آدرس \fBurl\fR به یک فایل نمایه یا یک مسیر مخزن اشاره دارد.\& طرح‌واره‌های (schemes) پشتیبانی‌شده در حال حاضر عبارتند از:
.RS 4
.PD 0
.IP \(bu 4
\fIhttp://\fR
.IP \(bu 4
\fIhttps://\fR
.IP \(bu 4
\fIfile://\fR
.IP \(bu 4
مسیر مطلق در سیستم‌فایل (باید با `/` شروع شود)
.PD
.PP
.RE
فهرست \fBcomponent\fR فهرستی از مولفه‌های مخزن را مشخص می‌کند.\& در صورت مشخص شدن، خط مربوطه به چندین URL گسترش می‌یابد: یکی برای هر مولفه، و \fBcomponent\fR به انتهای \fBurl\fR افزوده می‌شود.\& مشخص کردن \fBcomponent\fR همراه با نوع \fBndx\fR معتبر نیست.\&
.PP
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
برای تعریف فهرست مخزن ارائه‌شده توسط توزیع، توزیع می‌تواند به عنوان مثال فایل \fB/lib/apk/repositories.\&d/distribution.\&list\fR را با محتویات زیر ارائه دهد:
.PP
.RS 4
set \-default distro_mirror=https://example.\&com/distro
.br
v3 ${distro_mirror} main community
.PP
.RE
در \fB/etc/apk/repositories.\&d/00\-vars.\&list\fR می‌توان آینه (mirror) را به این صورت بازنویسی کرد:
.PP
.RS 4
set distro_mirror=https://mirror.\&example.\&com/distro
.PP
.RE
.SH "چیدمان مخزن (REPOSITORY LAYOUT)"
.PP
اگر \fBtype\fR برابر با \fBndx\fR باشد، چیدمان و تفکیک مسیر به شرح زیر است:
.RS 4
.PD 0
.IP \(bu 4
\fBurl\fR یک URL به فایل نمایه (index) است
.IP \(bu 4
\fBbase_url\fR همان \fBurl\fR است که آخرین مولفه آن حذف شده است
.IP \(bu 4
مسیر پیش‌فرض بسته: \fB$base_url/$name\-$version.\&apk\fR
.PD
.PP
.RE
در غیر این صورت، \fBtype\fR یکی از انواع مخزن است و تفکیک مسیر به این صورت کار می‌کند:
.RS 4
.PD 0
.IP \(bu 4
\fBurl\fR همان \fBbase_url\fR برای مخزن است
.IP \(bu 4
نمایه (\fBv3\fR) در \fB$base_url/$arch/Packages.\&adb\fR قرار دارد
.IP \(bu 4
نمایه (\fBv2\fR) در \fB$base_url/$arch/APKINDEX.\&tar.\&gz\fR قرار دارد
.IP \(bu 4
مسیر پیش‌فرض بسته: \fB$base_url/$arch/$name\-$version.\&apk\fR
.PD
.PP
.RE
اگر فایل نمایه دارای مقدار \fBpkgname\-spec\fR تنظیم‌شده باشد، از آن برای ساخت مسیر بسته استفاده می‌شود.\& در غیر این صورت، مسیر پیش‌فرض بسته بر اساس قوانین بالا استفاده خواهد شد.\&
.PP
.SH "ایجاد نمایه‌ها و مخازن (CREATING INDEXES AND REPOSITORIES)"
.PP
برای چگونگی ایجاد فایل‌های نمایه به \fBapk\-mkndx\fR(8) و برای اصلاح امضاها به \fBapk\-adbsign\fR(8) مراجعه کنید.\&
.PP
برای قالب نمایه موروثی (قدیمی)، به \fBapk\-index\fR(8) برای فایل‌های نمایه، \fBabuild\-keygen\fR(1) برای اطلاعات پیرامون تولید کلیدها و \fBabuild\-sign\fR(1) برای اطلاعات در مورد استفاده از این کلیدها جهت امضای فایل‌ها مراجعه کنید.\&
.PP
برنامه \fBapk\-verify\fR(8) می‌تواند فایل‌های نمایه و بسته‌ها را چه در قالب جدید و چه در قالب قدیمی اعتبارسنجی کند.\&
.PP
.SH "به‌روزرسانی نمایه کلاینت (CLIENT INDEX UPDATING)"
.PP
برنامه \fBapk\fR(8) نمایه هر مخزن را دریافت کرده و در یک حافظه موقت (کش) محلی در \fB/etc/apk/cache\fR یا \fB/var/cache/apk\fR ذخیره می‌کند.\& برای جزئیات بیشتر به \fBapk\-cache\fR(5) مراجعه کنید.\&
.PP
برای چگونگی پیکربندی کلاینت جهت اعتبارسنجی امضاهای نمایه، به \fBapk\-keys\fR(5) مراجعه کنید.\&