dpkg-genbuildinfo(1)              dpkg suite              dpkg-genbuildinfo(1)


نام (NAME)
       dpkg-genbuildinfo - تولید فایل‌های اطلاعات ساخت دبیان (buildinfo.)

خلاصه دستور (SYNOPSIS)
       dpkg-genbuildinfo [گزینه...]

توضیحات (DESCRIPTION)
       دستور dpkg-genbuildinfo اطلاعات را از یک درخت منبع بازشده و ساخته‌شدهٔ
       دبیان و فایل‌های تولیدشده توسط آن می‌خواند و یک فایل کنترل دبیان تولید
       می‌کند که محیط ساخت و مصنوعات ساخت (فایل .buildinfo) را توصیف می‌نماید.

       این برنامه در dpkg نسخه 1.18.11 معرفی شد.

گزینه‌ها (OPTIONS)
       --build=type
           نوع ساخت (type) را از میان فهرستی از مؤلفه‌ها که با کاما جدا شده‌اند،
           مشخص می‌کند.

           مقادیر مجاز عبارتند از:

           any تولید اطلاعات ساخت شامل وابستگی‌های ساخت بدون قید
               (Build-Depends) و وابستگی‌های ساخت وابسته به معماری
               (Build-Depends-Arch).

           all تولید اطلاعات ساخت شامل وابستگی‌های ساخت بدون قید
               (Build-Depends) و وابستگی‌های ساخت مستقل از معماری
               (Build-Depends-Indep).

           source
               عملاً نادیده گرفته می‌شود؛ اطلاعات ساخت را تنها با وابستگی‌های
               ساخت بدون قید (Build-Depends) تولید می‌کند.

           binary
               تولید اطلاعات ساخت با هر سه نوع وابستگی ساخت.  این گزینه نام
               مستعاری برای any,all است.

           full
               تولید اطلاعات ساخت با هر سه نوع وابستگی ساخت.  این گزینه نام
               مستعاری برای any,all,source بوده و معادل حالت پیش‌فرض در زمانی
               است که هیچ گزینهٔ ساختی مشخص نشده باشد.

       -ccontrolfile
           فایل اصلی کنترل منبع را برای خواندن اطلاعات مشخص می‌کند. مقدار
           پیش‌فرض debian/control است.

       -lchangelog-file
           فایل گزارش تغییرات را برای خواندن اطلاعات مشخص می‌کند. مقدار پیش‌فرض
           debian/changelog است.

       -ffiles-list-file
           محل فهرست فایل‌های تولیدشده توسط فرآیند ساخت را به جای استفاده از
           debian/files مشخص می‌کند.

       -Fchangelog-format
           قالب فایل گزارش تغییرات را مشخص می‌کند. برای اطلاعات دربارهٔ قالب‌های
           جایگزین، dpkg-parsechangelog(1) را ببینید.

       -O[filename]
           فایل buildinfo را به جای ذخیره در
           dir/source-name_binary-version_arch.buildinfo (که در آن dir به‌طور
           پیش‌فرض .. بوده یا در صورت استفاده از گزینهٔ -u برابر با
           upload-files-dir خواهد بود)، در خروجی استاندارد (یا در صورت مشخص
           شدن، در filename) چاپ می‌کند.

       -uupload-files-dir
           فایل‌های آماده برای ارسال/بارگذاری را به جای .. در upload-files-dir
           جستجو می‌کند (dpkg-genbuildinfo باید این فایل‌ها را پیدا کند تا
           بتواند اندازه‌ها و چیدمان‌های درهم‌سازی / چک‌سام‌های آن‌ها را در فایل
           .buildinfo بگنجاند).

       --always-include-kernel
           به‌طور پیش‌فرض، فیلد Build-Kernel-Version نوشته نخواهد شد.

           مشخص کردن این گزینه (از dpkg نسخه 1.19.0 به بعد) باعث می‌شود که
           هنگام تولید فایل .buildinfo فیلد Build-Kernel-Version همواره نوشته
           شود.

       --always-include-path
           به‌طور پیش‌فرض، فیلد Build-Path تنها در صورتی نوشته می‌شود که
           دایرکتوری جاری با یک الگوی مجاز شروع شود.

           در دبیان و توزیع‌های مشتق از آن، این الگو با /build/ در ابتدای نام
           مسیر مطابقت دارد.

           مشخص کردن این گزینه باعث می‌شود که هنگام تولید فایل .buildinfo فیلد
           Build-Path همواره نوشته شود.

       --admindir=dir
           محل پایگاه‌دادهٔ dpkg را تغییر می‌دهد. محل پیش‌فرض /var/lib/dpkg است.

       -q  دستور dpkg-genbuildinfo ممکن است پیام‌های اطلاع‌رسانی را در خروجی
           خطای استاندارد تولید کند. گزینهٔ -q این پیام‌ها را فرونشانی (بی‌صدا)
           می‌کند.

       -?, --help
           پیام راهنمای نحوهٔ استفاده را نمایش داده و خارج می‌شود.

       --version
           اطلاعات نسخه را نمایش داده و خارج می‌شود.

محیط (ENVIRONMENT)
       DEB_BUILD_OPTIONS
           این متغیر می‌تواند برای فعال یا غیرفعال کردن قابلیت‌های گوناگونی که
           بر اطلاعات درج‌شده در فایل buildinfo. تأثیر می‌گذارند، از طریق گزینهٔ
           buildinfo (از dpkg نسخه 1.18.19) به کار رود.  این گزینه شامل فهرستی
           از قابلیت‌ها است که با کاما جدا شده‌اند و با پیشوندهای اصلاح‌کنندهٔ ‘+’
           یا ‘-’ برای تعیین فعال یا غیرفعال بودن آن‌ها مشخص می‌شوند.  قابلیت
           ویژهٔ “all” می‌تواند برای فعال یا غیرفعال کردن همهٔ قابلیت‌های دیگر
           استفاده شود.  قابلیت “path” تعیین می‌کند که آیا فیلد Build-Path بدون
           قید و شرط درج شود یا خیر.

       DEB_BUILD_PROFILES
           در صورت تنظیم، به عنوان نمایه(ها)ی ساخت فعال هنگام تولید فایل
           buildinfo. استفاده خواهد شد. این متغیر فهرستی از نام‌های نمایه‌هاست
           که با فاصله از هم جدا شده‌اند.

       DEB_BUILD_ARCH
           معماری ساخت را تعیین می‌کند. این متغیر بر مقدار فیلد
           Build-Architecture و همچنین بررسی حالت کامپایل متقابل (cross-
           compilation) تأثیر می‌گذارد.

       DEB_HOST_ARCH
           معماری میزبان را تعیین می‌کند. این متغیر بر نام فایل مورد استفاده
           برای فایل buildinfo. و همچنین بررسی حالت کامپایل متقابل (cross-
           compilation) تأثیر می‌گذارد.

       DPKG_COLORS
           حالت رنگی را تعیین می‌کند (از dpkg نسخه 1.18.5).  مقادیر پذیرفته‌شده
           در حال حاضر عبارتند از: auto (پیش‌فرض)، always و never.

       DPKG_NLS
           در صورت تنظیم، برای تصمیم‌گیری در مورد فعال‌سازی پشتیبانی از زبان
           بومی (Native Language Support)، که به عنوان پشتیبانی از
           بین‌المللی‌سازی (یا i18n) نیز شناخته می‌شود، استفاده خواهد شد (از dpkg
           نسخه 1.19.0).  مقادیر پذیرفته‌شده عبارتند از: 0 و 1 (پیش‌فرض).

فایل‌ها (FILES)
       debian/files
           فهرست فایل‌های تولیدشده.  dpkg-genbuildinfo هنگام تولید یک فایل
           .buildinfo داده‌ها را از اینجا می‌خواند.

همچنین ببینید (SEE ALSO)
       deb-buildinfo(5).

1.23.7-dirty                      2026-03-06              dpkg-genbuildinfo(1)