.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Required to disable full justification in groff 1.23.0.
.if n .ds AD l
.\" ========================================================================
.\"
.IX Title "deb-buildinfo 5"
.TH deb-buildinfo 5 2026-03-06 1.23.7-dirty "dpkg suite"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "نام (NAME)"
deb\-buildinfo \- قالب پرونده اطلاعات ساخت دبیان
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "خلاصه دستور (SYNOPSIS)"
\&\fIfilename\fR\fB.buildinfo\fR
.SH "توضیحات (DESCRIPTION)"
.IX Header "توضیحات (DESCRIPTION)"
هر فرآیند ساخت بستهٔ مبدأ دبیان می‌تواند اطلاعات ساخت را در یک پروندهٔ کنترل \fB.buildinfo\fR ثبت کند، که حاوی تعدادی فیلد در قالب \fBdeb822\fR\|(5) است.
.PP
هر فیلد با یک برچسب آغاز می‌شود، مانند \fBSource\fR یا \fBBinary\fR (غیرحساس به حروف کوچک و بزرگ)، که به دنبال آن یک دونقطه (:) و سپس بدنهٔ فیلد (حساس به حروف کوچک و بزرگ مگر خلاف آن قید شده باشد) می‌آید.
فیلدها فقط با برچسب‌های فیلد جدا می‌شوند.
به عبارت دیگر، متن فیلد ممکن است چندین خط باشد، اما ابزارهای نصب هنگام پردازش بدنهٔ فیلد، خطوط را به هم متصل می‌کنند (به‌جز در مورد فیلدهای چندخطی \fBBinary\-Only\-Changes\fR، \fBInstalled\-Build\-Depends\fR، \fBEnvironment\fR، \fBChecksums\-Md5\fR، \fBChecksums\-Sha1\fR و \fBChecksums\-Sha256\fR، به ادامه مراجعه کنید).
.PP
داده‌های کنترلی ممکن است در یک امضای محصور OpenPGP ASCII Armored، همان‌طور که در RFC9580 مشخص شده است، قرار گیرند.
.PP
نام پروندهٔ \fB.buildinfo\fR به نوع ساخت بستگی دارد و به اندازهٔ لازم خاص خواهد بود اما نه بیشتر؛ نام آن به این صورت خواهد بود:
.IP \fIsource\-name\fR\fB_\fR\fIbinary\-version\fR\fB_\fR\fIarch\fR\fB.buildinfo\fR 4
.IX Item "source-name_binary-version_arch.buildinfo"
برای ساختی که شامل \fBany\fR است
.IP \fIsource\-name\fR\fB_\fR\fIbinary\-version\fR\fB_\fR\fBall.buildinfo\fR 4
.IX Item "source-name_binary-version_all.buildinfo"
در غیر این صورت برای ساختی که شامل \fBall\fR است
.IP \fIsource\-name\fR\fB_\fR\fIsource\-version\fR\fB_\fR\fBsource.buildinfo\fR 4
.IX Item "source-name_source-version_source.buildinfo"
در غیر این صورت برای ساختی که شامل \fBsource\fR است
.SH "فیلدها (FIELDS)"
.IX Header "فیلدها (FIELDS)"
.IP "\fBFormat:\fR \fIformat\-version\fR (لازم)" 4
.IX Item "Format: format-version (required)"
مقدار این فیلد، نسخهٔ قالب پرونده را مشخص می‌کند.
نحو مقدار فیلد، یک شمارهٔ نسخه با دو بخش اصلی (major) و فرعی (minor) است.
تغییرات ناسازگار با نسخه‌های پیشین باعث افزایش نسخهٔ اصلی می‌شوند و تغییرات سازگار با گذشته (مانند افزودن فیلدها) نسخهٔ فرعی را افزایش می‌دهند.
نسخهٔ کنونی این قالب \fB1.0\fR است.
.IP "\fBSource:\fR \fIsource\-name\fR [\fB(\fR\fIsource\-version\fR\fB)\fR] (لازم)" 4
.IX Item "Source: source-name [(source-version)] (required)"
نام بستهٔ مبدأ.
اگر نسخهٔ مبدأ با نسخهٔ باینری متفاوت باشد، پس از \fIsource\-name\fR یک \fIsource\-version\fR داخل پرانتز قرار می‌گیرد.
این حالت زمانی رخ می‌دهد که ساخت برای یک بارگذاری صرفاً باینری توسط غیر نگه‌دارنده (binNMU) باشد.
.IP "\fBBinary:\fR \fIbinary\-package\-list\fR (بسته به زمینه لازم است)" 4
.IX Item "Binary: binary-package-list (required in context)"
این فیلد چندخطیِ ادغام‌شده، فهرستی از بسته‌های باینری ساخته‌شده است که با فاصله از هم جدا شده‌اند.
اگر ساخت صرفاً مبدأ (source-only) باشد، این فیلد حذف می‌شود (از نسخهٔ dpkg 1.20.0 به بعد).
.IP "\fBArchitecture:\fR \fIarch\-list\fR (لازم)" 4
.IX Item "Architecture: arch-list (required)"
فهرست معماری‌ها مشخص می‌کند که این بسته روی چه نوع دستگاهی اجرا می‌شود.
مقدار آن باید فهرستی از نام‌های معماری باشد که با فاصله از هم جدا شده‌اند.
.Sp
معماری‌های رایج عبارتند از \fBamd64\fR، \fBarmel\fR، \fBi386\fR و غیره.
توجه داشته باشید که مقدار ویژهٔ \fBall\fR برای بسته‌هایی در نظر گرفته شده که مستقل از معماری هستند (مانند اسکریپت‌های شل و Perl یا مستندات).
اگر مبدأ بسته نیز در حال ساخت باشد، ورودی ویژهٔ \fBsource\fR نیز درج می‌شود.
.Sp
\&\fBنکته:\fR نویسه‌های عام (wildcard) معماری در این زمینه مجاز نیستند.
.IP "\fBVersion:\fR \fIversion\-string\fR (لازم)" 4
.IX Item "Version: version-string (required)"
به‌طور معمول، این مقدار همان شمارهٔ نسخهٔ اصلی بسته به هر شکلی است که نویسندهٔ برنامه به کار برده است.
همچنین ممکن است شامل یک شماره بازنگری دبیان (برای بسته‌های غیربومی) باشد.
قالب دقیق و الگوریتم مرتب‌سازی در \fBdeb\-version\fR\|(7) شرح داده شده است.
.Sp
\&\fBنکته:\fR در برخی توزیع‌ها،
dpkg طوری ساخته شده است که اجازه می‌دهد سورس‌های بومی دارای نسخه‌های غیربومی باشند؛ این موضوع باعث ناهمخوانی و سردرگمی در این مفهوم شده و علاوه بر این معمولاً دامی برای اشتباهات تصادفی است.
.IP \fBBinary\-Only\-Changes:\fR 4
.IX Item "Binary-Only-Changes:"
.PD 0
.IP "\ \fIchangelog\-entry\fR" 4
.IX Item " changelog-entry"
.PD
این فیلد چندخطی شامل متن به‌هم‌پیوستهٔ ورودی تغییرات (changelog) برای یک بارگذاری صرفاً باینری توسط غیر نگه‌دارنده (binNMU) است، در صورتی که ساخت از این نوع باشد.
برای اینکه این فیلد یک فیلد چندخطی معتبر باشد، خطوط خالی با یک نقطهٔ تنها (\(oq.\(cq) جایگزین می‌شوند و همهٔ خطوط به اندازهٔ یک نویسهٔ فاصله دندانه‌دار (indent) می‌شوند.
محتوای دقیق به قالب changelog بستگی دارد.
.IP "\fBChecksums\-Md5:\fR (لازم، ضعیف)" 4
.IX Item "Checksums-Md5: (required, weak)"
.PD 0
.IP "\fBChecksums\-Sha1:\fR (لازم، ضعیف)" 4
.IX Item "Checksums-Sha1: (required, weak)"
.IP "\fBChecksums\-Sha256:\fR (لازم، قوی)" 4
.IX Item "Checksums-Sha256: (required, strong)"
.IP "\ \fIchecksum\fR \fIsize\fR \fIfilename\fR" 4
.IX Item " checksum size filename"
.PD
این فیلدهای چندخطی حاوی فهرستی از پرونده‌ها به همراه جمع‌آزمای (checksum) و اندازهٔ هر یک هستند.
این فیلدها نحو یکسانی دارند و تنها در الگوریتم جمع‌آزمای استفاده‌شده تفاوت دارند: MD5 برای \fBChecksums\-Md5\fR، SHA\-1 برای \fBChecksums\-Sha1\fR و SHA\-256 برای \fBChecksums\-Sha256\fR.
.Sp
\&\fBنکته:\fR جمع‌آزماهای MD5 و SHA\-1 ضعیف در نظر گرفته می‌شوند و هرگز نباید برای اعتبارسنجی امن کافی فرض شوند.
.Sp
خط اول مقدار فیلد (بخشی که در همان خطِ نام فیلد پس از دونقطه قرار دارد) همیشه خالی است.
محتوای فیلد به صورت خطوط ادامه‌دار، یک خط به ازای هر پرونده، بیان می‌شود.
هر خط شامل ورودی‌هایی است که با فاصله از هم جدا شده‌اند و پرونده را توصیف می‌کنند:
جمع‌آزما، اندازهٔ پرونده و نام پرونده.
.Sp
این فیلدها تمام پرونده‌هایی را که ساخت را تشکیل می‌دهند فهرست می‌کنند.
.IP "\fBBuild\-Origin:\fR \fIname\fR" 4
.IX Item "Build-Origin: name"
نام توزیعی که این بسته از آن سرچشمه می‌گیرد.
.IP "\fBBuild\-Architecture:\fR \fIarch\fR (لازم)" 4
.IX Item "Build-Architecture: arch (required)"
معماری دبیان برای محیط نصبی که بسته‌ها در آن ساخته می‌شوند.
معماری‌های رایج عبارتند از \fBamd64\fR، \fBarmel\fR، \fBi386\fR و غیره.
.IP "\fBBuild\-Date:\fR \fIbuild\-date\fR" 4
.IX Item "Build-Date: build-date"
تاریخی که بسته ساخته شده است.
این تاریخ باید در همان قالب تاریخ موجود در یک ورودی \fBdeb\-changelog\fR\|(5) باشد.
.IP "\fBBuild\-Kernel\-Version:\fR \fIbuild\-kernel\-version\fR" 4
.IX Item "Build-Kernel-Version: build-kernel-version"
نسخه و انتشار (در قالبی نامشخص) از هسته‌ای که روی سامانهٔ ساخت در حال اجرا است.
این فیلد تنها در صورتی وجود خواهد داشت که سازنده صریحاً آن را درخواست کرده باشد، تا از افشای اطلاعات احتمالاً حساس جلوگیری شود.
.IP "\fBBuild\-Path:\fR \fIbuild\-path\fR" 4
.IX Item "Build-Path: build-path"
مسیر مطلق ساخت، که متناظر با درخت مبدأ بازشده (unpacked source tree) است.
این فیلد تنها در صورتی وجود خواهد داشت که توزیع از طریق تطبیق الگو آن را مجاز دانسته باشد تا از نشت اطلاعات احتمالاً حساس جلوگیری شود.
.Sp
در دبیان و مشتقات آن، تنها مسیرهای ساختی که با \fI/build/\fR شروع می‌شوند این فیلد را تولید می‌کنند.
.IP \fBBuild\-Tainted\-By:\fR 4
.IX Item "Build-Tainted-By:"
.PD 0
.IP "\ \fItaint\-reason\-list\fR" 4
.IX Item " taint-reason-list"
.PD
این فیلد ادغام‌شده شامل فهرستی از برچسب‌های دلیل ناجامع (تشکیل‌شده از نویسه‌های حرفی-عددی و خط تیره) است که با فاصله جدا شده‌اند و مشخص می‌کنند چرا ساخت فعلی آلوده (tainted) شده است (از نسخهٔ dpkg 1.19.5 به بعد).
.Sp
در دبیان و مشتقات آن، برچسب‌های دلیل زیر ممکن است صادر شوند:
.RS 4
.IP \fBusr\-local\-has\-configs\fR 4
.IX Item "usr-local-has-configs"
سامانه دارای پرونده‌های پیکربندی زیر مسیر \fI/usr/local/etc\fR است.
.IP \fBusr\-local\-has\-includes\fR 4
.IX Item "usr-local-has-includes"
سامانه دارای پرونده‌های سرآیند زیر مسیر \fI/usr/local/include\fR است.
.IP \fBusr\-local\-has\-programs\fR 4
.IX Item "usr-local-has-programs"
سامانه دارای برنامه‌هایی زیر مسیر \fI/usr/local/bin\fR یا \fI/usr/local/sbin\fR است.
.IP \fBusr\-local\-has\-libraries\fR 4
.IX Item "usr-local-has-libraries"
سامانه دارای کتابخانه‌های ایستا یا اشتراکی زیر مسیر \fI/usr/local/lib\fR است.
.IP \fBcan\-execute\-cross\-built\-programs\fR 4
.IX Item "can-execute-cross-built-programs"
سامانه می‌تواند برنامه‌های دگرساخته (cross-built) را، چه به‌طور مستقیم یا از طریق یک لایهٔ شبیه‌ساز، اجرا کند.
.Sp
از نسخهٔ dpkg 1.21.10 به بعد.
.RE
.RS 4
.RE
.IP "\fBInstalled\-Build\-Depends:\fR (لازم)" 4
.IX Item "Installed-Build-Depends: (required)"
.PD 0
.IP "\ \fIpackage\-list\fR" 4
.IX Item " package-list"
.PD
فهرستی از بسته‌های نصب‌شده و پیکربندی‌شده که ممکن است بر فرایند ساخت بسته تأثیر بگذارند.
.Sp
این فهرست شامل نام هر بسته است که به‌صورت اختیاری برای معماری‌های بیگانه (foreign) با معماری مشخص شده و با محدودیت نسخهٔ دقیق همراه است که با کاما از هم جدا شده‌اند.
.Sp
این فهرست شامل تمام بسته‌های حیاتی (essential)، بسته‌های فهرست‌شده در فیلدهای کنترل مبدأ \fBBuild\-Depends\fR، \fBBuild\-Depends\-Arch\fR و \fBBuild\-Depends\-Indep\fR، هرگونه وابستگی توکار خاص توزیع، و تمام وابستگی‌های بازگشتی آن‌ها است.
در دبیان و مشتقات آن، وابستگی توکار \fBbuild\-essential\fR است.
.Sp
برای وابستگی‌های ناشی از فیلدهای کنترل مبدأ، تمام جایگزین‌های وابستگی و تمام ارائه‌دهندگان بسته‌های مجازی مورد وابستگی گنجانده خواهند شد.
.IP \fBEnvironment:\fR 4
.IX Item "Environment:"
.PD 0
.IP "\ \fIvariable\-list\fR" 4
.IX Item " variable-list"
.PD
فهرستی از متغیرهای محیطی که مشخص شده بر فرایند ساخت بسته تأثیر می‌گذارند؛ به طوری که هر متغیر محیطی با یک علامت مساوی (\(oq=\(cq) و مقدار درون گیومهٔ متغیر با استفاده از جفت‌گیومه (\(oq"\(cq) و بک‌اسلش‌های گریز داده‌شده (\(oq\e\e\(cq) دنبال می‌شود.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "همچنین ببینید (SEE ALSO)"
\&\fBdeb822\fR\|(5)،
\&\fBdeb\-changes\fR\|(5)،
\&\fBdeb\-version\fR\|(7)،
\&\fBdpkg\-genbuildinfo\fR\|(1).