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

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

dpkg-genbuildinfo [گزینه...]

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

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

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

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

تولید اطلاعات ساخت شامل وابستگی‌های ساخت بدون قید (Build-Depends) و وابستگی‌های ساخت وابسته به معماری (Build-Depends-Arch).
تولید اطلاعات ساخت شامل وابستگی‌های ساخت بدون قید (Build-Depends) و وابستگی‌های ساخت مستقل از معماری (Build-Depends-Indep).
عملاً نادیده گرفته می‌شود؛ اطلاعات ساخت را تنها با وابستگی‌های ساخت بدون قید (Build-Depends) تولید می‌کند.
تولید اطلاعات ساخت با هر سه نوع وابستگی ساخت. این گزینه نام مستعاری برای any,all است.
تولید اطلاعات ساخت با هر سه نوع وابستگی ساخت. این گزینه نام مستعاری برای any,all,source بوده و معادل حالت پیش‌فرض در زمانی است که هیچ گزینهٔ ساختی مشخص نشده باشد.
فایل اصلی کنترل منبع را برای خواندن اطلاعات مشخص می‌کند. مقدار پیش‌فرض debian/control است.
فایل گزارش تغییرات را برای خواندن اطلاعات مشخص می‌کند. مقدار پیش‌فرض debian/changelog است.
محل فهرست فایل‌های تولیدشده توسط فرآیند ساخت را به جای استفاده از debian/files مشخص می‌کند.
قالب فایل گزارش تغییرات را مشخص می‌کند. برای اطلاعات دربارهٔ قالب‌های جایگزین، dpkg-parsechangelog(1) را ببینید.
فایل buildinfo را به جای ذخیره در dir/source-name_binary-version_arch.buildinfo (که در آن dir به‌طور پیش‌فرض .. بوده یا در صورت استفاده از گزینهٔ -u برابر با upload-files-dir خواهد بود)، در خروجی استاندارد (یا در صورت مشخص شدن، در filename) چاپ می‌کند.
فایل‌های آماده برای ارسال/بارگذاری را به جای .. در upload-files-dir جستجو می‌کند (dpkg-genbuildinfo باید این فایل‌ها را پیدا کند تا بتواند اندازه‌ها و چیدمان‌های درهم‌سازی / چک‌سام‌های آن‌ها را در فایل .buildinfo بگنجاند).
به‌طور پیش‌فرض، فیلد Build-Kernel-Version نوشته نخواهد شد.

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

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

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

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

محل پایگاه‌دادهٔ dpkg را تغییر می‌دهد. محل پیش‌فرض /var/lib/dpkg است.
دستور dpkg-genbuildinfo ممکن است پیام‌های اطلاع‌رسانی را در خروجی خطای استاندارد تولید کند. گزینهٔ -q این پیام‌ها را فرونشانی (بی‌صدا) می‌کند.
-?, --help
پیام راهنمای نحوهٔ استفاده را نمایش داده و خارج می‌شود.
اطلاعات نسخه را نمایش داده و خارج می‌شود.

این متغیر می‌تواند برای فعال یا غیرفعال کردن قابلیت‌های گوناگونی که بر اطلاعات درج‌شده در فایل buildinfo. تأثیر می‌گذارند، از طریق گزینهٔ buildinfo (از dpkg نسخه 1.18.19) به کار رود. این گزینه شامل فهرستی از قابلیت‌ها است که با کاما جدا شده‌اند و با پیشوندهای اصلاح‌کنندهٔ ‘+’ یا ‘-’ برای تعیین فعال یا غیرفعال بودن آن‌ها مشخص می‌شوند. قابلیت ویژهٔ “all” می‌تواند برای فعال یا غیرفعال کردن همهٔ قابلیت‌های دیگر استفاده شود. قابلیت “path” تعیین می‌کند که آیا فیلد Build-Path بدون قید و شرط درج شود یا خیر.
در صورت تنظیم، به عنوان نمایه(ها)ی ساخت فعال هنگام تولید فایل buildinfo. استفاده خواهد شد. این متغیر فهرستی از نام‌های نمایه‌هاست که با فاصله از هم جدا شده‌اند.
معماری ساخت را تعیین می‌کند. این متغیر بر مقدار فیلد Build-Architecture و همچنین بررسی حالت کامپایل متقابل (cross-compilation) تأثیر می‌گذارد.
معماری میزبان را تعیین می‌کند. این متغیر بر نام فایل مورد استفاده برای فایل buildinfo. و همچنین بررسی حالت کامپایل متقابل (cross-compilation) تأثیر می‌گذارد.
حالت رنگی را تعیین می‌کند (از dpkg نسخه 1.18.5). مقادیر پذیرفته‌شده در حال حاضر عبارتند از: auto (پیش‌فرض)، always و never.
در صورت تنظیم، برای تصمیم‌گیری در مورد فعال‌سازی پشتیبانی از زبان بومی (Native Language Support)، که به عنوان پشتیبانی از بین‌المللی‌سازی (یا i18n) نیز شناخته می‌شود، استفاده خواهد شد (از dpkg نسخه 1.19.0). مقادیر پذیرفته‌شده عبارتند از: 0 و 1 (پیش‌فرض).

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

deb-buildinfo(5).

2026-03-06 1.23.7-dirty