.\" -*- 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 "dpkg-genbuildinfo 1"
.TH dpkg-genbuildinfo 1 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)"
dpkg\-genbuildinfo \- تولید فایل‌های اطلاعات ساخت دبیان (buildinfo.)
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "خلاصه دستور (SYNOPSIS)"
\&\fBdpkg\-genbuildinfo\fR
[\fIگزینه\fR...]
.SH "توضیحات (DESCRIPTION)"
.IX Header "توضیحات (DESCRIPTION)"
دستور
\&\fBdpkg\-genbuildinfo\fR
اطلاعات را از یک درخت منبع بازشده و ساخته‌شدهٔ دبیان و فایل‌های تولیدشده توسط آن می‌خواند و یک فایل کنترل دبیان تولید می‌کند که محیط ساخت و مصنوعات ساخت (فایل
\&\fB.buildinfo\fR)
را توصیف می‌نماید.
.PP
این برنامه در dpkg نسخه 1.18.11 معرفی شد.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "گزینه‌ها (OPTIONS)"
.IP \fB\-\-build=\fR\fItype\fR 4
.IX Item "--build=type"
نوع ساخت
(\fItype\fR)
را از میان فهرستی از مؤلفه‌ها که با کاما جدا شده‌اند، مشخص می‌کند.
.Sp
مقادیر مجاز عبارتند از:
.RS 4
.IP \fBany\fR 4
.IX Item "any"
تولید اطلاعات ساخت شامل وابستگی‌های ساخت بدون قید
(\fBBuild\-Depends\fR)
و وابستگی‌های ساخت وابسته به معماری
(\fBBuild\-Depends\-Arch\fR).
.IP \fBall\fR 4
.IX Item "all"
تولید اطلاعات ساخت شامل وابستگی‌های ساخت بدون قید
(\fBBuild\-Depends\fR)
و وابستگی‌های ساخت مستقل از معماری
(\fBBuild\-Depends\-Indep\fR).
.IP \fBsource\fR 4
.IX Item "source"
عملاً نادیده گرفته می‌شود؛ اطلاعات ساخت را تنها با وابستگی‌های ساخت بدون قید
(\fBBuild\-Depends\fR)
تولید می‌کند.
.IP \fBbinary\fR 4
.IX Item "binary"
تولید اطلاعات ساخت با هر سه نوع وابستگی ساخت.
این گزینه نام مستعاری برای
\&\fBany,all\fR
است.
.IP \fBfull\fR 4
.IX Item "full"
تولید اطلاعات ساخت با هر سه نوع وابستگی ساخت.
این گزینه نام مستعاری برای
\&\fBany,all,source\fR
بوده و معادل حالت پیش‌فرض در زمانی است که هیچ گزینهٔ ساختی مشخص نشده باشد.
.RE
.IP \fB\-c\fR\fIcontrolfile\fR 4
.IX Item "-ccontrolfile"
فایل اصلی کنترل منبع را برای خواندن اطلاعات مشخص می‌کند. مقدار پیش‌فرض
\&\fBdebian/control\fR
است.
.IP \fB\-l\fR\fIchangelog\-file\fR 4
.IX Item "-lchangelog-file"
فایل گزارش تغییرات را برای خواندن اطلاعات مشخص می‌کند. مقدار پیش‌فرض
\&\fBdebian/changelog\fR
است.
.IP \fB\-f\fR\fIfiles\-list\-file\fR 4
.IX Item "-ffiles-list-file"
محل فهرست فایل‌های تولیدشده توسط فرآیند ساخت را به جای استفاده از
\&\fBdebian/files\fR
مشخص می‌کند.
.IP \fB\-F\fR\fIchangelog\-format\fR 4
.IX Item "-Fchangelog-format"
قالب فایل گزارش تغییرات را مشخص می‌کند. برای اطلاعات دربارهٔ قالب‌های جایگزین،
\&\fBdpkg\-parsechangelog\fR\|(1)
را ببینید.
.IP \fB\-O\fR[\fIfilename\fR] 4
.IX Item "-O[filename]"
فایل buildinfo را به جای ذخیره در
\&\fIdir\fR\fB/\fR\fIsource\-name\fR\fB_\fR\fIbinary\-version\fR\fB_\fR\fIarch\fR\fB.buildinfo\fR
(که در آن
\&\fIdir\fR
به‌طور پیش‌فرض
\&\fB..\fR
بوده یا در صورت استفاده از گزینهٔ
\&\fB\-u\fR
برابر با
\&\fIupload\-files\-dir\fR
خواهد بود)، در خروجی استاندارد (یا در صورت مشخص شدن، در
\&\fIfilename\fR)
چاپ می‌کند.
.IP \fB\-u\fR\fIupload\-files\-dir\fR 4
.IX Item "-uupload-files-dir"
فایل‌های آماده برای ارسال/بارگذاری را به جای
\&\fB..\fR
در
\&\fIupload\-files\-dir\fR
جستجو می‌کند
(\fBdpkg\-genbuildinfo\fR
باید این فایل‌ها را پیدا کند تا بتواند اندازه‌ها و چیدمان‌های درهم‌سازی / چک‌سام‌های آن‌ها را در فایل
\&\fB.buildinfo\fR
بگنجاند).
.IP \fB\-\-always\-include\-kernel\fR 4
.IX Item "--always-include-kernel"
به‌طور پیش‌فرض، فیلد
\&\fBBuild\-Kernel\-Version\fR
نوشته نخواهد شد.
.Sp
مشخص کردن این گزینه (از dpkg نسخه 1.19.0 به بعد) باعث می‌شود که هنگام تولید فایل
\&\fB.buildinfo\fR
فیلد
\&\fBBuild\-Kernel\-Version\fR
همواره نوشته شود.
.IP \fB\-\-always\-include\-path\fR 4
.IX Item "--always-include-path"
به‌طور پیش‌فرض، فیلد
\&\fBBuild\-Path\fR
تنها در صورتی نوشته می‌شود که دایرکتوری جاری با یک الگوی مجاز شروع شود.
.Sp
در دبیان و توزیع‌های مشتق از آن، این الگو با
\&\fB/build/\fR
در ابتدای نام مسیر مطابقت دارد.
.Sp
مشخص کردن این گزینه باعث می‌شود که هنگام تولید فایل
\&\fB.buildinfo\fR
فیلد
\&\fBBuild\-Path\fR
همواره نوشته شود.
.IP \fB\-\-admindir=\fR\fIdir\fR 4
.IX Item "--admindir=dir"
محل پایگاه‌دادهٔ
\&\fBdpkg\fR
را تغییر می‌دهد. محل پیش‌فرض
\&\fI/var/lib/dpkg\fR
است.
.IP \fB\-q\fR 4
.IX Item "-q"
دستور
\&\fBdpkg\-genbuildinfo\fR
ممکن است پیام‌های اطلاع‌رسانی را در خروجی خطای استاندارد تولید کند. گزینهٔ
\&\fB\-q\fR
این پیام‌ها را فرونشانی (بی‌صدا) می‌کند.
.IP "\fB\-?\fR, \fB\-\-help\fR" 4
.IX Item "-?, --help"
پیام راهنمای نحوهٔ استفاده را نمایش داده و خارج می‌شود.
.IP \fB\-\-version\fR 4
.IX Item "--version"
اطلاعات نسخه را نمایش داده و خارج می‌شود.
.SH "محیط (ENVIRONMENT)"
.IX Header "محیط (ENVIRONMENT)"
.IP \fBDEB_BUILD_OPTIONS\fR 4
.IX Item "DEB_BUILD_OPTIONS"
این متغیر می‌تواند برای فعال یا غیرفعال کردن قابلیت‌های گوناگونی که بر اطلاعات درج‌شده در فایل buildinfo. تأثیر می‌گذارند، از طریق گزینهٔ
\&\fBbuildinfo\fR
(از dpkg نسخه 1.18.19) به کار رود.
این گزینه شامل فهرستی از قابلیت‌ها است که با کاما جدا شده‌اند و با پیشوندهای اصلاح‌کنندهٔ
\(oq\fB+\fR\(cq
یا
\(oq\fB\-\fR\(cq
برای تعیین فعال یا غیرفعال بودن آن‌ها مشخص می‌شوند.
قابلیت ویژهٔ
\(lq\fBall\fR\(rq
می‌تواند برای فعال یا غیرفعال کردن همهٔ قابلیت‌های دیگر استفاده شود.
قابلیت
\(lq\fBpath\fR\(rq
تعیین می‌کند که آیا فیلد
\&\fBBuild\-Path\fR
بدون قید و شرط درج شود یا خیر.
.IP \fBDEB_BUILD_PROFILES\fR 4
.IX Item "DEB_BUILD_PROFILES"
در صورت تنظیم، به عنوان نمایه(ها)ی ساخت فعال هنگام تولید فایل buildinfo. استفاده خواهد شد. این متغیر فهرستی از نام‌های نمایه‌هاست که با فاصله از هم جدا شده‌اند.
.IP \fBDEB_BUILD_ARCH\fR 4
.IX Item "DEB_BUILD_ARCH"
معماری ساخت را تعیین می‌کند. این متغیر بر مقدار فیلد
\&\fBBuild\-Architecture\fR
و همچنین بررسی حالت کامپایل متقابل (cross-compilation) تأثیر می‌گذارد.
.IP \fBDEB_HOST_ARCH\fR 4
.IX Item "DEB_HOST_ARCH"
معماری میزبان را تعیین می‌کند. این متغیر بر نام فایل مورد استفاده برای فایل buildinfo. و همچنین بررسی حالت کامپایل متقابل (cross-compilation) تأثیر می‌گذارد.
.IP \fBDPKG_COLORS\fR 4
.IX Item "DPKG_COLORS"
حالت رنگی را تعیین می‌کند (از dpkg نسخه 1.18.5).
مقادیر پذیرفته‌شده در حال حاضر عبارتند از:
\&\fBauto\fR
(پیش‌فرض)،
\&\fBalways\fR
و
\&\fBnever\fR.
.IP \fBDPKG_NLS\fR 4
.IX Item "DPKG_NLS"
در صورت تنظیم، برای تصمیم‌گیری در مورد فعال‌سازی پشتیبانی از زبان بومی (Native Language Support)، که به عنوان پشتیبانی از بین‌المللی‌سازی (یا i18n) نیز شناخته می‌شود، استفاده خواهد شد (از dpkg نسخه 1.19.0).
مقادیر پذیرفته‌شده عبارتند از:
\&\fB0\fR
و
\&\fB1\fR
(پیش‌فرض).
.SH "فایل‌ها (FILES)"
.IX Header "فایل‌ها (FILES)"
.IP \fBdebian/files\fR 4
.IX Item "debian/files"
فهرست فایل‌های تولیدشده.
\&\fBdpkg\-genbuildinfo\fR
هنگام تولید یک فایل
\&\fB.buildinfo\fR
داده‌ها را از اینجا می‌خواند.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "همچنین ببینید (SEE ALSO)"
\&\fBdeb\-buildinfo\fR\|(5).