نام (NAME)

dpkg-genchanges - ایجاد فایل‌های .changes دبیان

خلاصه دستور (SYNOPSIS)

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

توضیحات (DESCRIPTION)

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

گزینه‌ها (OPTIONS)

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

source: بارگذاری بسته سورس (منبع).
any: بارگذاری بسته‌های باینری وابسته به معماری.
all: بارگذاری بسته‌های باینری مستقل از معماری.
binary: بارگذاری بسته‌های باینری وابسته و مستقل از معماری. این یک نام مستعار برای any,all است.
full: بارگذاری همه‌چیز. این یک نام مستعار برای source,any,all است، و مشابه حالت پیش‌فرض در زمانی است که هیچ گزینه ساختی مشخص نشده باشد.

-g: معادل --build=source,all (از نسخه dpkg 1.17.11).
-G: معادل --build=source,any (از نسخه dpkg 1.17.11).
-b: معادل --build=binary یا --build=any,all.
-B: معادل --build=any.
-A: معادل --build=all.
-S: معادل --build=source.

گزینه‌های -sx کنترل می‌کنند که در صورت تولید سورس (یعنی زمانی که -b یا -B استفاده نشده باشد)، آیا آرشیو سورس اصلی در بارگذاری گنجانده شود یا خیر.

-si: به‌طور پیش‌فرض، یا در صورت مشخص شدن، سورس اصلی تنها در صورتی گنجانده خواهد شد که شماره نسخه بالادستی (نسخه بدون epoch و بدون بازبینی دبیان) با شماره نسخه بالادستی مدخل قبلی در گزارش تغییرات (changelog) متفاوت باشد.
-sa: گنجاندن سورس اصلی را اجباری می‌کند.
-sd: عدم گنجاندن سورس اصلی را اجباری کرده و فقط diff را شامل می‌شود.
-vنسخه: باعث می‌شود اطلاعات گزارش تغییرات (changelog) از تمامی نسخه‌هایی که دقیقاً جدیدتر از نسخه هستند استفاده شود.
-Cشرح-تغییرات: شرح تغییرات را از فایل شرح-تغییرات می‌خواند، به جای اینکه از اطلاعات فایل changelog در درخت سورس استفاده کند.
-mنشانی-نگهدارنده: از نشانی-نگهدارنده به عنوان نام و نشانی ایمیل نگهدارنده برای این بسته استفاده می‌کند، به جای استفاده از اطلاعات موجود در فایل کنترل درخت سورس.
-eنشانی-نگهدارنده: از نشانی-نگهدارنده به عنوان نام و نشانی ایمیل نگهدارنده برای این بارگذاری استفاده می‌کند، به جای استفاده از اطلاعات موجود در changelog درخت سورس.
-Vنام=مقدار: یک متغیر جایگزینی خروجی را تنظیم می‌کند. برای بررسی جایگزینی خروجی به deb-substvars(5) مراجعه کنید.
-Tفایل-substvars: متغیرهای جایگزینی را در فایل-substvars می‌خواند؛ مقدار پیش‌فرض debian/substvars است. هیچ جایگزینی متغیری روی هیچ‌یک از فیلدهای خروجی انجام نمی‌شود، به جز محتویات استخراج‌شده از فیلد Description هر بسته باینری (از نسخه dpkg 1.19.0)؛ با این حال متغیر ویژه Format فیلدی با همین نام را بازنویسی خواهد کرد. این گزینه می‌تواند چندین بار برای خواندن متغیرهای جایگزینی از چندین فایل استفاده شود (از نسخه dpkg 1.15.6).
-Dفیلد=مقدار: یک فیلد فایل کنترل خروجی را بازنویسی کرده یا اضافه می‌کند.
-Uفیلد: یک فیلد فایل کنترل خروجی را حذف می‌کند.
-cفایل-کنترل: فایل کنترل سورس اصلی را برای خواندن اطلاعات مشخص می‌کند. مقدار پیش‌فرض debian/control است.
-lفایل-changelog: فایل گزارش تغییرات (changelog) را برای خواندن اطلاعات مشخص می‌کند. مقدار پیش‌فرض debian/changelog است.
-fفایل-فهرست-فایل‌ها: فهرست فایل‌های آماده برای بارگذاری را به جای استفاده از debian/files از این فایل می‌خواند.
-Fقالب-changelog: قالب فایل changelog را مشخص می‌کند. برای اطلاعات درباره قالب‌های جایگزین به dpkg-parsechangelog(1) مراجعه کنید.
-uدایرکتوری-فایل‌های-بارگذاری: فایل‌های آماده برای بارگذاری را به جای .. در دایرکتوری-فایل‌های-بارگذاری جستجو می‌کند (دستور dpkg-genchanges نیاز به یافتن این فایل‌ها دارد تا بتواند اندازه‌ها و چکسام‌های آن‌ها را در فایل .changes درج کند).
-q: معمولاً dpkg-genchanges پیام‌های آگاهی‌بخش را در خروجی خطای استاندارد تولید می‌کند، برای نمونه درباره تعداد فایل‌های سورس بسته که در حال بارگذاری هستند. گزینه -q این پیام‌ها را بی‌صدا می‌کند.
-O[نام-فایل]: فایل changes را در خروجی استاندارد (پیش‌فرض) یا در صورت مشخص شدن در نام-فایل چاپ می‌کند (از نسخه dpkg 1.18.5).
-?, --help: نمایش پیام راهنما و خروج.
--version: نمایش نسخه و خروج.

محیط (ENVIRONMENT)

DEB_HOST_ARCH: معماری میزبان را تنظیم می‌کند.
DEB_BUILD_PROFILES: در صورت تنظیم، به عنوان پروفایل(های) ساخت فعال هنگام تولید فایل .changes استفاده خواهد شد. این متغیر فهرستی از نام‌های پروفایل است که با فاصله از هم جدا شده‌اند.
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-genchanges هنگام تولید یک فایل .changes داده‌ها را از اینجا می‌خواند.

همچنین ببینید (SEE ALSO)

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