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


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

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

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

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

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

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

گزینه‌ها (OPTIONS)
       -vversion
           شماره نسخهٔ بستهٔ باینری‌ای را که تولید خواهد شد تعیین می‌کند.

       -Vname=value
           یک متغیر جایگزینی خروجی را تنظیم می‌کند.  برای بررسی و توضیحات
           پیرامون جایگزینی در خروجی، deb-substvars(5) را ببینید.

       -Tsubstvars-file
           متغیرهای جایگزینی را در substvars-file می‌خواند؛ مقدار پیش‌فرض
           debian/substvars است.  این گزینه می‌تواند چندین بار برای خواندن
           متغیرهای جایگزینی از چندین فایل استفاده شود (از dpkg نسخه 1.15.6 به
           بعد).

       -Dfield=value
           یک فیلد فایل کنترل خروجی را جایگزین کرده یا می‌افزاید.

       -Ufield
           یک فیلد فایل کنترل خروجی را حذف می‌کند.

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

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

       -ffiles-list-file
           فهرست فایل‌هایی را که باید بارگذاری شوند در اینجا می‌خواند یا
           می‌نویسد، به جای استفاده از debian/files.

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

       -ppackage
           اطلاعات را برای بستهٔ باینری package تولید می‌کند.  اگر فایل کنترل
           منبع تنها یک بستهٔ باینری را فهرست کند، این گزینه ممکن است نادیده
           گرفته شود؛ در غیر این صورت، انتخاب اینکه اطلاعات کدام بستهٔ باینری
           تولید شود ضروری است.

       -nfilename
           فرض می‌کند نام فایل بسته به جای نام معمول package_version_arch.deb،
           برابر با filename خواهد بود.

       -is, -ip, -isp
           این گزینه‌ها برای سازگاری با نسخه‌های قدیمی‌تر اسکریپت‌های ساخت dpkg
           نادیده گرفته می‌شوند، اما اکنون منسوخ شده‌اند.  پیش‌تر از آن‌ها استفاده
           می‌شد تا به dpkg-gencontrol اعلام کنند فیلدهای Section و Priority را
           در فایل کنترل بگنجاند.  این مورد اکنون رفتار پیش‌فرض است.  اگر
           می‌خواهید رفتار پیشین را به دست آورید، می‌توانید از گزینهٔ -U برای حذف
           این فیلدها از فایل کنترل استفاده کنید.

       -Ppackage-build-dir
           به جای debian/tmp، دایرکتوری package-build-dir را بررسی (پویش)
           می‌کند.  این مقدار برای یافتن مقدار پیش‌فرض متغیر جایگزینی و فیلد
           فایل کنترل Installed-Size، و همچنین برای محل پیش‌فرض فایل خروجی
           استفاده می‌شود.

       -O[filename]
           فایل کنترل را در خروجی استاندارد (یا در صورت تعیین، در filename، از
           dpkg نسخه 1.17.2 به بعد) چاپ می‌کند، به جای چاپ در
           debian/tmp/DEBIAN/control (یا package-build-dir/DEBIAN/control اگر
           از -P استفاده شده باشد).

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

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

محیط (ENVIRONMENT)
       DEB_HOST_ARCH
           معماری میزبان را تعیین می‌کند.

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

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

فایل‌ها (FILES)
       debian/control
           فایل الگوی کنترل بستهٔ منبع، که اطلاعات مستقل از نسخه را دربارهٔ بستهٔ
           منبع و بسته‌های باینری‌ای که می‌تواند تولید کند، ارائه می‌دهد.

       debian/files
           فهرست فایل‌های تولیدشده که بخشی از بارگذاری در حال آماده‌سازی هستند.
           دستور dpkg-gencontrol نام‌های فرضی بسته‌های باینری‌ای را که فایل‌های
           کنترل آن‌ها را تولید می‌کند، در اینجا اضافه می‌نماید.

همچنین ببینید (SEE ALSO)
       deb-substvars(5), deb-src-control(5), deb-changelog(5), deb-control(5).

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