.\" 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\-v2" "5" "2026\-08\-31"
.PP
.SH "نام (NAME)"
apk-v2 \- قالب فرمت پایگاه داده و بسته نسخه ۲ در apk
.PP
.SH "توضیحات (DESCRIPTION)"
.PP
یک فایل \fB.apk\fR نسخه ۲ حاوی محتویات یک بسته واحد، مقداری متادیتا و چند امضا است.\& فایل \fB.apk\fR شامل سه جریان
gzip
به هم پیوسته است که در مجموع یک آرشیو
tar
واحد را تشکیل می‌دهند.\& آرشیو
tar
شامل سه بخش است: امضاها، بخش کنترل، و بخش داده.\&
.PP
.SH "امضاها (THE SIGNATURES)"
.PP
امضاها دنباله‌ای از فایل‌ها هستند که نام آن‌ها با
".\&SIGN.\&"
شروع می‌شود، که باید قبل از هر داده دیگری در فایل
tar
قرار گیرند.\& این نام‌فایل‌ها به این صورت هستند:
.PP
.RS 4
\fB.\&SIGN.\&<algorithm>.\&<keyid>\fR
.PP
.RE
که در آن <algorithm> باید یکی از مقادیر
\fBDSA\fR،
\fBRSA\fR،
\fBRSA256\fR
و
\fBRSA512\fR
باشد و <keyid> باید نام فایل کلید در
/etc/apk/keys
باشد (به
\fBapk\-keys\fR(5)
مراجعه کنید).\&
.PP
امضا می‌تواند بر روی متادیتا محاسبه شود (اگر متادیتا حاوی هش داده برای داده‌ها باشد)، یا بر روی متادیتا و داده با هم محاسبه شود (اگر متادیتا فاقد هش داده باشد).\&
.PP
یک امضای واحد از سوی یک کلید مورد اعتماد کافی است، بنابراین در صورت نیاز یک
apk
می‌تواند توسط چندین کلید مختلف امضا شود، تا زمانی که کلاینت‌ها حداقل به یکی از آن‌ها اعتماد داشته باشند.\&
.PP
.SH "بخش کنترل (THE CONTROL SECTION)"
.PP
در یک فایل apk نسخه ۲، متادیتای بسته در یک فایل واحد به نام
PKGINFO
ذخیره می‌شود.\& آن فایل از یک قالب کلید\-مقدار استفاده می‌کند که در آن کلیدها و مقادیر با
" = "
از هم جدا می‌شوند و خطوطی که با "#" آغاز می‌شوند کامنت هستند.\& کلیدهای مجاز متعددی وجود دارد و هیچ فهرست متمرکزی از کلیدهای شناخته‌شده وجود ندارد؛ سورس‌کد
\fBabuild\fR(1)
بهترین مرجع است.\&
.PP
یک کلید برای درک قالب نسخه ۲ مهم است زیرا بر تفسیر امضا تأثیر می‌گذارد: اگر یک کلید "datahash" در
PKGINFO
وجود داشته باشد، مقدار آن هش sha256 بخش داده فایل apk است.\& بسته‌ها باید دارای datahash باشند، اما نمایه‌ها (indexes) چنین نیستند.\&
.PP
بخش کنترل همچنین محلی است که اسکریپت‌های قلاب (hook) پیش/پس از نصب، حذف و ارتقا و همچنین تریگرها در آن قرار دارند.\&
.PP
.SH "بخش داده (THE DATA SECTION)"
.PP
بخش داده صرفاً یک آرشیو tar از محتویات بسته است، همان‌طور که توسط فرآیند ساخت تولید می‌شود.\& این فایل‌ها توسط
\fBabuild\-tar\fR(1)
پردازش نهایی می‌شوند و از هدرهای توسعه‌یافته pax برای گنجاندن چکسام‌های هر فایل در یک هدر با نام
APK\-TOOLS.\&checksum.\&\fB<hash>\fR
استفاده می‌کنند.\&
.PP
.SH "مثال (EXAMPLE)"
.PP
به عنوان مثال، فایل apk نسخه ۲ برای خود
\fBscdoc\fR(1)
حاوی این فایل‌ها به همین ترتیب است:
.PP
.nf
.RS 4
\&.SIGN\&.RSA\&.alpine\-devel@lists\&.alpinelinux\&.org\-6165ee59\&.rsa\&.pub
\&.PKGINFO
usr/
usr/bin/
usr/bin/scdoc
usr/share/
usr/share/pkgconfig/
usr/share/pkgconfig/scdoc\&.pc
.fi
.RE
.PP
از آنجا که فایل‌های apk نسخه ۲ صرفاً آرشیوهای tar هستند (تقسیم‌شده به چندین جریان gzip)، می‌توان آن‌ها را با
\fBtar\fR(1)
بررسی و باز کرد، اگرچه هنگام تغییر آن‌ها باید دقت شود که ترتیب بخش‌ها به هم نخورد یا امضا باطل نشود.\& بهتر است برای اصلاح آن‌ها از
\fBabuild\fR(1)
استفاده شود.\& اگر می‌خواهید آن‌ها را به جریان‌های gzip تشکیل‌دهنده‌شان تجزیه کنید، می‌توانید از
\fBabuild\-gzsplit\fR(1)
استفاده کنید.\&
.PP
.SH "نکات (NOTES)"
.PP
در حال حاضر تنها طرح امضای "RSA" (به معنای RSA + SHA1) توسط
\fBabuild\fR(1)
استفاده می‌شود.\&
.PP
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBabuild\fR(1), \fBapk\fR(8), \fBapk\-package\fR(5), \fBapk\-v3\fR(5)