.\" Generated by scdoc 1.11.4
.\" 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 "abuild" "1" "2026-06-05"
.PP
.SH "نام (NAME)"
.PP
\fBabuild\fR \- ساخت یک بسته apk از روی پرونده APKBUILD
.PP
.SH "خلاصه دستور (SYNOPSIS)"
.PP
\fBabuild\fR [گزینه‌ها] [-C DIR] [-P \fIREPODEST\fR] [-s \fISRCDEST\fR] [-D \fIDESCRIPTION\fR] [cmd] .\&.\&.\&
.PP
.SH "توضیحات (DESCRIPTION)"
.PP
دستور \fBabuild\fR یک بسته باینری apk را بر اساس پرونده ورودی APKBUILD(5) به همراه سایر عملیات مرتبط می‌سازد.\&
.PP
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB-A\fR
.RS 4
چاپ CARCH و خروج
.PP
.RE
\fB-c\fR
.RS 4
فعال‌سازی خروجی رنگی
.PP
.RE
\fB-C DIR\fR
.RS 4
تغییر پوشه به DIR پیش از اجرای هر دستور
.PP
.RE
\fB-d\fR
.RS 4
غیرفعال‌سازی بررسی وابستگی‌ها
.PP
.RE
\fB-D DESCRIPTION\fR
.RS 4
تنظیم توضیحات APKINDEX (پیش‌فرض: \fB$repo $(git describe)\fR)
.PP
.RE
\fB-f\fR
.RS 4
اجبار در اجرای دستور مشخص‌شده (صرف‌نظر از بررسی به‌روز بودن apk یا معماری)
.PP
.RE
\fB-F\fR
.RS 4
اجرای اجباری در قالب ریشه (کاربر ارشد)
.PP
.RE
\fB-h\fR
.RS 4
نمایش این راهنما
.PP
.RE
\fB-k\fR
.RS 4
نگه‌داشتن بسته‌های ساخته‌شده حتی اگر APKBUILD یا سورس‌ها جدیدتر باشند
.PP
.RE
\fB-K\fR
.RS 4
نگه‌داشتن پوشه‌ها و پرونده‌های موقت زمان ساخت (srcdir/pkgdir/deps)
.PP
.RE
\fB-m\fR
.RS 4
غیرفعال‌سازی رنگ‌ها (تک‌رنگ)
.PP
.RE
\fB-P REPODEST\fR
.RS 4
تنظیم REPODEST به عنوان مسیر مخزن برای بسته‌های ایجادشده
.PP
.RE
\fB-q\fR
.RS 4
حالت بی‌صدا
.PP
.RE
\fB-r\fR
.RS 4
نصب وابستگی‌های مفقود از مخزن سیستم
.PP
.RE
\fB-s SRCDEST\fR
.RS 4
تنظیم پوشه مقصد بسته مبدا به SRCDEST
.PP
.RE
\fB-v\fR
.RS 4
نمایش پرجزئیات: نمایش هر دستور هنگام اجرا (خروجی بسیار پر سر و صدا)
.PP
.RE
.SH "دستورات (COMMANDS)"
.PP
\fBall\fR
.RS 4
اجرای کل فرآیند ساخت.\& این مقدار پیش‌فرض است در حالتی که دستور دیگری مشخص نشده باشد، و معادل اجرای \fBvalidate builddeps clean fetch unpack prepare mkusers build check rootpkg\fR است.\&
.PP
.RE
\fBbuild\fR
.RS 4
کامپایل و نصب بسته در \fB$pkgdir\fR.\&
.PP
.RE
\fBcheck\fR
.RS 4
اجرای آزمون‌های تعریف‌شده مربوط به بسته
.PP
.RE
\fBchecksum\fR
.RS 4
تولید چکسام جهت گنجاندن در APKBUILD
.PP
.RE
\fBclean\fR
.RS 4
حذف پوشه‌های موقت ساخت و نصب
.PP
.RE
\fBcleancache\fR
.RS 4
حذف پرونده‌های بارگیری‌شده از $SRCDEST
.PP
.RE
\fBcleanoldpkg\fR
.RS 4
حذف بسته‌های باینری به جز نسخه فعلی
.PP
.RE
\fBcleanpkg\fR
.RS 4
حذف بسته باینری و سورس که قبلاً ساخته شده است
.PP
.RE
\fBdeps\fR
.RS 4
نصب بسته‌های ذکرشده در makedepends و depends
.PP
.RE
\fBfetch\fR
.RS 4
دریافت سورس‌ها به $SRCDEST
.PP
.RE
\fBindex\fR
.RS 4
تولید دوباره نمایه‌ها (indexها) در $REPODEST
.PP
.RE
\fBlistpkg\fR
.RS 4
فهرست کردن بسته‌های هدف
.PP
.RE
\fBpackage\fR
.RS 4
نصب پروژه در پوشه پکیج
.PP
.RE
\fBprepare\fR
.RS 4
اعمال وصله‌ها (پچ‌ها)
.PP
.RE
\fBrootbld\fR
.RS 4
ساخت بسته در محیط چروت (chroot) تمیز.\& به \fBabuild-rootbld\fR نیاز دارد.\&
.PP
.RE
\fBrootpkg\fR
.RS 4
اجرای 'package'، توابع تفکیک، و ایجاد فایلهای apk در قالب fakeroot
.PP
.RE
\fBvalidate\fR
.RS 4
اعتبارسنجی اولیه پرونده APKBUILD
.PP
.RE
\fBsnapshot\fR
.RS 4
ایجاد یک اسنپ‌شات از \fB$giturl\fR و بارگذاری آن در \fB$disturl\fR
.PP
.RE
\fBsourcecheck\fR
.RS 4
بررسی وجود بسته مبدا از راه دور در بالادست
.PP
.RE
\fBsrcpkg\fR
.RS 4
ساخت بسته سورس
.PP
.RE
\fBundeps\fR
.RS 4
حذف نصب بسته‌های ذکرشده در makedepends و depends
.PP
.RE
\fBunpack\fR
.RS 4
استخراج سورس‌ها در $srcdir
.PP
.RE
\fBup2date\fR
.RS 4
مقایسه تاریخ‌های مقصد و سورس‌ها
.PP
.RE
.SH "متغیرهای محیطی (ENVIRONMENT)"
.PP
\fBAPKBUILD\fR
.RS 4
تغییر مسیر به پرونده \fBAPKBUILD\fR.\&
.PP
.RE
\fBBOOTSTRAP\fR
.RS 4
استفاده هنگام راه‌اندازی اولیه بدون وجود بسته‌های قبلی از طریق به حداقل رساندن وابستگی‌های ساخت.\& این فلگ فقط بر تعداد کمی از بسته‌های خاص تأثیر دارد.\&
.PP
مقدار \fInocc\fR از هرگونه کامپایل چشم‌پوشی می‌کند (برای نمونه: فقط شامل هدرهای سورس می‌شود).\&
مقدار \fInolibc\fR فرض می‌کند که هیچ \fIlibc\fRای در دسترس نیست.\&
.PP
این فهرست مقادیر جامع نیست.\&
.PP
.RE
\fBCHOST\fR
.RS 4
تولید بسته‌ها برای معماری یا سه‌گانه داده‌شده.\&
.PP
.RE
\fBCTARGET\fR
.RS 4
تولید کامپایلر برای معماری یا سه‌گانه داده‌شده.\&
.PP
.RE
\fBPACKAGER\fR
.RS 4
نام و رایانامه بسته‌بندی‌کننده در قالب RFC5322.\&
مانند: \fBJohn Doe <john@example.\&com>\fR.\&
.PP
.RE
\fBPACKAGER_PRIVKEY\fR
.RS 4
مسیر کلید خصوصی برای امضای بسته‌ها.\&
.PP
.RE
\fBREPODEST\fR
.RS 4
بسته‌ها در \fI$REPODEST/$repo/$arch/$pkgname-$pkgver-r$pkgrel.\&apk\fR ذخیره خواهند شد،
که در آن \fB$repo\fR نام پایه پوشه والد \fB$startdir\fR است.\&
.PP
.RE
\fBSOURCE_DATE_EPOCH\fR
.RS 4
استفاده از این برچسب زمان به عنوان مرجع برای ساخت‌های بازتولیدپذیر (reproducible builds).\&
ببینید: <https://reproducible-builds.org/docs/source-date-epoch>
.PP
.RE
\fBSUDO_APK\fR
.RS 4
دستور مورد استفاده برای اجرای apk با دسترسی ریشه.\& پیش‌فرض: \fBabuild-apk\fR.\&
.PP
.RE
\fBUSE_CCACHE\fR
.RS 4
در صورت مقداردهی غیرخالی، پشتیبانی از \fBccache\fR فعال می‌شود.\&
.PP
.RE
\fBUSE_COLORS\fR
.RS 4
در صورت مقداردهی غیرخالی، خروجی رنگی با استفاده از توالی‌های گریز ANSI چاپ می‌شود.\&
.PP
.RE
.SH "فایل‌ها (FILES)"
.PP
/etc/abuild.\&conf
.RS 4
پیکربندی به‌طور پیش‌فرض از این پرونده خوانده می‌شود.\&
.PP
.RE
$HOME/.\&abuild/abuild.\&conf
.RS 4
پیکربندی ویژه‌ی کاربر در صورت وجود از این پرونده خوانده می‌شود.\&
.PP
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
به‌روزرسانی چکسام‌ها برای یک پرونده APKBUILD:
.PP
.nf
.RS 4
abuild checksum
.fi
.RE
.PP
ساخت یک پرونده APKBUILD و چاپ خروجی رنگی:
.PP
.nf
.RS 4
abuild -rc
.fi
.RE
.PP
.SH "همچنین ببینید (SEE ALSO)"
.PP
مرجع مجوز SPDX (در وب: <https://spdx.org/licenses>)،
newapkbuild(1), apk(8), APKBUILD(5), abuild.\&conf(5), buildrepo(1), ap(1), checkapk(1).\&
.PP
.SH "نویسندگان (AUTHORS)"
.PP
\fBabuild\fR: Natanael Copa <\fIncopa@alpinelinux.\&org\fR>
.PP
مستندات:
.br
Hugo Osvaldo Barrera <\fIhugo@whynothugo.\&nl\fR>