dpkg-gencontrol(1) dpkg suite dpkg-gencontrol(1)

dpkg-gencontrol - تولید فایل‌های کنترل دبیان

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

دستور dpkg-gencontrol اطلاعات را از یک درخت منبع بازشدهٔ دبیان می‌خواند و یک فایل کنترل بستهٔ باینری (که به‌طور پیش‌فرض debian/tmp/DEBIAN/control است) تولید می‌کند؛ در طول این فرآیند، فیلدهای رابطه را ساده‌سازی می‌نماید.

بدین ترتیب، فیلدهای Pre-Depends، Depends، Recommends و Suggests به همین ترتیب با حذف وابستگی‌هایی که با توجه به وابستگی‌های قوی‌ترِ پیش‌تر پردازش‌شده صادق هستند، ساده‌سازی می‌شوند. همچنین هرگونه وابستگی به خود (self-dependency) را حذف می‌کند (در واقع هر وابستگی‌ای را که با توجه به نسخهٔ فعلی بسته به عنوان بستهٔ نصب‌شده برقرار باشد، حذف خواهد کرد). از نظر منطقی، این دستور اشتراک وابستگی‌های چندگانه روی یک بستهٔ یکسان را نگه می‌دارد. ترتیب وابستگی‌ها تا حد امکان حفظ می‌شود: اگر وابستگی‌ای به دلیل وجود وابستگی دیگری در ادامهٔ فیلد باید کنار گذاشته شود، وابستگی جایگزین جای وابستگی حذف‌شده را خواهد گرفت.

سایر فیلدهای رابطه (Enhances، Conflicts، Breaks، Replaces و Provides) نیز هنگامی که یک بسته چندین بار در فیلد فهرست شده باشد، با محاسبهٔ اجتماع وابستگی‌های گوناگون به‌طور جداگانه ساده‌سازی می‌شوند.

دستور dpkg-gencontrol همچنین یک مدخل برای بستهٔ باینری به فایل debian/files اضافه می‌کند.

شماره نسخهٔ بستهٔ باینری‌ای را که تولید خواهد شد تعیین می‌کند.
یک متغیر جایگزینی خروجی را تنظیم می‌کند. برای بررسی و توضیحات پیرامون جایگزینی در خروجی، deb-substvars(5) را ببینید.
متغیرهای جایگزینی را در substvars-file می‌خواند؛ مقدار پیش‌فرض debian/substvars است. این گزینه می‌تواند چندین بار برای خواندن متغیرهای جایگزینی از چندین فایل استفاده شود (از dpkg نسخه 1.15.6 به بعد).
یک فیلد فایل کنترل خروجی را جایگزین کرده یا می‌افزاید.
یک فیلد فایل کنترل خروجی را حذف می‌کند.
فایل اصلی کنترل منبع را برای خواندن اطلاعات مشخص می‌کند. مقدار پیش‌فرض debian/control است.
فایل گزارش تغییرات را برای خواندن اطلاعات مشخص می‌کند. مقدار پیش‌فرض debian/changelog است.
فهرست فایل‌هایی را که باید بارگذاری شوند در اینجا می‌خواند یا می‌نویسد، به جای استفاده از debian/files.
قالب گزارش تغییرات را مشخص می‌کند. برای اطلاعات بیشتر دربارهٔ قالب‌های جایگزین، dpkg-parsechangelog(1) را ببینید.
اطلاعات را برای بستهٔ باینری package تولید می‌کند. اگر فایل کنترل منبع تنها یک بستهٔ باینری را فهرست کند، این گزینه ممکن است نادیده گرفته شود؛ در غیر این صورت، انتخاب اینکه اطلاعات کدام بستهٔ باینری تولید شود ضروری است.
فرض می‌کند نام فایل بسته به جای نام معمول package_version_arch.deb، برابر با filename خواهد بود.
این گزینه‌ها برای سازگاری با نسخه‌های قدیمی‌تر اسکریپت‌های ساخت dpkg نادیده گرفته می‌شوند، اما اکنون منسوخ شده‌اند. پیش‌تر از آن‌ها استفاده می‌شد تا به dpkg-gencontrol اعلام کنند فیلدهای Section و Priority را در فایل کنترل بگنجاند. این مورد اکنون رفتار پیش‌فرض است. اگر می‌خواهید رفتار پیشین را به دست آورید، می‌توانید از گزینهٔ -U برای حذف این فیلدها از فایل کنترل استفاده کنید.
به جای debian/tmp، دایرکتوری package-build-dir را بررسی (پویش) می‌کند. این مقدار برای یافتن مقدار پیش‌فرض متغیر جایگزینی و فیلد فایل کنترل Installed-Size، و همچنین برای محل پیش‌فرض فایل خروجی استفاده می‌شود.
فایل کنترل را در خروجی استاندارد (یا در صورت تعیین، در filename، از dpkg نسخه 1.17.2 به بعد) چاپ می‌کند، به جای چاپ در debian/tmp/DEBIAN/control (یا package-build-dir/DEBIAN/control اگر از -P استفاده شده باشد).
-?, --help
پیام راهنمای استفاده را نمایش داده و خارج می‌شود.
اطلاعات نسخه را نمایش داده و خارج می‌شود.

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

فایل الگوی کنترل بستهٔ منبع، که اطلاعات مستقل از نسخه را دربارهٔ بستهٔ منبع و بسته‌های باینری‌ای که می‌تواند تولید کند، ارائه می‌دهد.
فهرست فایل‌های تولیدشده که بخشی از بارگذاری در حال آماده‌سازی هستند. دستور dpkg-gencontrol نام‌های فرضی بسته‌های باینری‌ای را که فایل‌های کنترل آن‌ها را تولید می‌کند، در اینجا اضافه می‌نماید.

deb-substvars(5), deb-src-control(5), deb-changelog(5), deb-control(5).

2026-03-06 1.23.7-dirty