dpkg-source - آنلاین در ابر

برنامه:

نام

dpkg-source - ابزار دستکاری بسته منبع دبیان (dsc.).

خلاصه

dpkg-source [انتخاب...] فرمان

شرح

dpkg-source آرشیوهای منبع دبیان را بسته و باز می کند.

هیچ یک از این دستورات اجازه نمی دهد چندین گزینه در یک ترکیب شوند، و اینطور نیست
اجازه دهید مقدار یک گزینه در یک آرگومان جداگانه مشخص شود.

دستورات

-x, --استخراج کردن نام فایل.dsc [دایرکتوری خروجی]
استخراج یک بسته منبع (--استخراج کردن از dpkg 1.17.14). یک آرگومان غیر گزینه ای
باید ارائه شود، نام فایل کنترل منبع دبیان (dsc). یک اختیاری
آرگومان غیر گزینه دوم ممکن است برای مشخص کردن دایرکتوری برای استخراج ارائه شود
بسته منبع به، این نباید وجود داشته باشد. اگر هیچ دایرکتوری خروجی مشخص نشده باشد،
بسته منبع در دایرکتوری به نام استخراج می شود منبع-نسخه تحت جریان
دایرکتوری کار

dpkg-source نام فایل(های) دیگر تشکیل دهنده بسته منبع را خواهد خواند
از فایل کنترل؛ فرض بر این است که آنها در همان دایرکتوری قرار دارند dsc.

فایل‌های موجود در بسته استخراج‌شده مجوزها و مالکیت‌های خود را تنظیم می‌کنند
به مواردی که اگر فایل ها و دایرکتوری ها به سادگی وجود داشتند، انتظار می رفت
ایجاد شد - دایرکتوری ها و فایل های اجرایی 0777 و فایل های ساده خواهد بود
0666 باشد که هر دو توسط umask استخراج کننده اصلاح شده اند. اگر دایرکتوری والد setgid باشد
سپس دایرکتوری های استخراج شده نیز خواهند بود و همه فایل ها و دایرکتوری ها نیز خواهند بود
مالکیت گروه خود را به ارث می برد.

اگر بسته منبع از یک فرمت غیر استاندارد استفاده می کند (در حال حاضر این به معنای همه فرمت ها است
به جز "1.0")، نام آن در آن ذخیره می شود دبیان/منبع/فرمت به طوری که
ساخت های زیر بسته منبع به طور پیش فرض از همان فرمت استفاده می کنند.

-b, --ساختن فهرست راهنما [پارامترهای فرمت خاص]
یک بسته منبع بسازید (--ساختن از dpkg 1.17.14). اولین آرگومان غیر اختیاری
به عنوان نام دایرکتوری حاوی درخت منبع debianized گرفته می شود (یعنی
با یک دایرکتوری فرعی دبیان و شاید به فایل های اصلی تغییر کند). وابسته به
قالب بسته منبع مورد استفاده برای ساخت بسته، ممکن است پارامترهای اضافی باشد
پذیرفته شده.

dpkg-source بسته منبع را با اولین فرمت موجود در این خواهد ساخت
لیست سفارشی: فرمت مشخص شده با --قالب گزینه خط فرمان،
فرمت مشخص شده در دبیان/منبع/فرمت، "1.0". بازگشت به "1.0" است
منسوخ شده و در آینده حذف خواهد شد، همیشه باید
فرمت منبع مورد نظر را در آن مستند کنید دبیان/منبع/فرمت. بخش را ببینید SOURCE
بسته فرمها برای توضیح گسترده از فرمت های بسته منبع مختلف.

- فرمت چاپ فهرست راهنما
فرمت منبعی را که برای ساخت بسته منبع استفاده می شود چاپ کنید
dpkg-source --ساختن فهرست راهنما نامیده شد (در همان شرایط و با همان
مولفه های؛ از dpkg 1.15.5).

--قبل از ساخت فهرست راهنما
قلاب مربوطه را با فرمت بسته منبع (از dpkg 1.15.8) اجرا کنید. این
هوک قبل از ساختن بسته فراخوانی می شود (dpkg-buildpackage خیلی بهش میگه
اوایل حتی قبل از دبیان/قوانین تمیز). این دستور idempotent است و می توان آن را فراخوانی کرد
چندین بار. همه فرمت‌های منبع چیزی را در این قلاب و آن‌ها پیاده‌سازی نمی‌کنند
که معمولاً درخت منبع را برای ساخت آماده می کنند، به عنوان مثال با اطمینان از آن
پچ های دبیان اعمال می شوند.

-- پس از ساخت فهرست راهنما
قلاب مربوطه را با فرمت بسته منبع (از dpkg 1.15.8) اجرا کنید. این
هوک پس از هر ساختن بسته فراخوانی می شود (dpkg-buildpackage آن را آخرین می نامد).
این دستور idempotent است و می توان چندین بار فراخوانی کرد. نه همه فرمت های منبع
چیزی را در این قلاب پیاده‌سازی کنید، و آنهایی که انجام می‌دهند معمولاً از آن برای خنثی کردن چه چیزی استفاده می‌کنند
--قبل از ساخت انجام داده است.

--مرتکب شدن [فهرست راهنما]...
ثبت تغییرات در درخت منبع باز شده در فهرست راهنما (از dpkg 1.16.1). این
دستور بسته به فرمت منبع می تواند پارامترهای تکمیلی را دریافت کند. خواهد شد
خطا برای فرمت هایی که این عملیات معنایی ندارد.

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

- نسخه
نسخه را نشان دهید و خارج شوید.

OPTIONS

عمومی ساختن گزینه های
-cفایل کنترلی
فایل کنترل منبع اصلی را برای خواندن اطلاعات از آن مشخص می کند. پیش فرض است
دبیان / کنترل. اگر با نام مسیر نسبی داده شود این با شروع تفسیر می شود
دایرکتوری سطح بالای درخت منبع.

-lفایل تغییر لاگ
فایل تغییرات را برای خواندن اطلاعات از آن مشخص می کند. پیش فرض است
debian/changelog. اگر با نام مسیر نسبی داده شود این با شروع تفسیر می شود
دایرکتوری سطح بالای درخت منبع.

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

--فرمت=ارزش
از فرمت داده شده برای ساخت بسته منبع استفاده کنید (از dpkg 1.14.17). این کار را انجام می دهد
نادیده گرفتن هر قالب ارائه شده در دبیان/منبع/فرمت.

-Vنام=ارزش
یک متغیر جایگزین خروجی تنظیم کنید. دیدن deb-substvars(5) برای بحث در مورد
جایگزینی خروجی

-Tفایل substvars
متغیرهای جایگزین را در آن بخوانید فایل substvars; پیش فرض این است که هیچ فایلی را نخوانید.
این گزینه را می توان چندین بار برای خواندن متغیرهای جایگزین از چند مورد استفاده کرد
فایل ها (از dpkg 1.15.6).

-Dرشته=ارزش
یک فیلد فایل کنترل خروجی را لغو یا اضافه کنید.

-Uرشته
یک فیلد فایل کنترل خروجی را حذف کنید.

-Zفشرده سازی, -- فشرده سازی=فشرده سازی
فشرده سازی مورد استفاده برای تاربال های ایجاد شده و فایل های متفاوت را مشخص کنید (-- فشرده سازی
از dpkg 1.15.5). توجه داشته باشید که این گزینه باعث نمی شود تاربال های موجود باشد
فشرده سازی مجدد، فقط روی فایل های جدید تاثیر می گذارد. مقادیر پشتیبانی شده عبارتند از: از gzip, bzip2, لزما
و xz. پیش فرض است xz برای فرمت های 2.0 و جدیدتر و از gzip برای فرمت 1.0 xz
فقط از dpkg 1.15.5 پشتیبانی می شود.

-zسطح, - سطح فشرده سازی=سطح
سطح فشرده سازی برای استفاده (- سطح فشرده سازی از dpkg 1.15.5). همانطور که با -Z it
فقط روی فایل های تازه ایجاد شده تاثیر می گذارد. مقادیر پشتیبانی شده عبارتند از: 1 به 9, بهترینو سریع.
پیش فرض این است 9 برای gzip و bzip2، 6 برای xz و lzma.

-i[regex], --تفاوت-نادیده گرفتن[=regex]
می‌توانید یک عبارت منظم پرل را برای مطابقت با فایل‌هایی که می‌خواهید از آن‌ها فیلتر کنید، تعیین کنید
لیست فایل ها برای تفاوت (--تفاوت-نادیده گرفتن از dpkg 1.15.6). (این لیست است
تولید شده توسط دستور find.) (اگر بسته منبع به عنوان نسخه 3 ساخته می شود
بسته منبع با استفاده از VCS، این می تواند برای نادیده گرفتن تغییرات غیرمتعهد در مورد استفاده قرار گیرد
فایل های خاص استفاده از -i.* همه آنها را نادیده می گیرد.)

La -i گزینه به خودی خود این تنظیم را با یک regex پیش فرض فعال می کند (حفظ هر
تغییر در regex پیش فرض با استفاده قبلی از --extend-diff-ignore)
که فایل های کنترلی و دایرکتوری های رایج ترین ویرایش ها را فیلتر می کند
سیستم های کنترل، فایل های پشتیبان و مبادله و دایرکتوری های خروجی ساخت Libtool. آنجا
فقط می تواند یک regex فعال، از چند -i گزینه هایی که فقط آخرین مورد را انتخاب می کند
اثر.

این برای برش فایل های اضافی که در تفاوت گنجانده شده اند بسیار مفید است.
به عنوان مثال اگر منبع خود را در یک سیستم کنترل بازبینی نگهداری می کنید و می خواهید از a استفاده کنید
پرداخت برای ساخت یک بسته منبع بدون گنجاندن فایل های اضافی و
دایرکتوری هایی که معمولاً شامل آن می شود (به عنوان مثال CVS/، .cvsignore، .svn/). در
regex پیش فرض در حال حاضر بسیار جامع است، اما اگر نیاز به جایگزینی آن دارید، لطفاً
توجه داشته باشید که به طور پیش فرض می تواند با هر بخشی از یک مسیر مطابقت داشته باشد، بنابراین اگر می خواهید با آن مطابقت داشته باشید
برای شروع نام فایل یا فقط نام های کامل فایل، باید موارد لازم را ارائه دهید
لنگرها (به عنوان مثال '(^|/)'، '($|/)') خودتان.

--extend-diff-ignore=regex
عبارت منظم perl مشخص شده مقدار پیش فرض استفاده شده توسط را گسترش می دهد
--تفاوت-نادیده گرفتن و مقدار فعلی آن، در صورت تنظیم (از dpkg 1.15.6). این کار را توسط
به هم پیوستن "|regex” به مقدار موجود. این گزینه برای استفاده راحت است
دبیان/منبع/گزینه ها برای حذف برخی از فایل های تولید شده خودکار از وصله خودکار
نسل.

-I[الگوی فایل], --تار-نادیده گرفتن[=الگوی فایل]
اگر این گزینه مشخص باشد، الگو به آن منتقل می شود قیر(1). -- استثناء کردن
گزینه زمانی که برای تولید یک فایل .orig.tar یا .tar فراخوانی می شود (--تار-نادیده گرفتن پس از
dpkg 1.15.6). مثلا، -ICVS باعث می‌شود که تار از فهرست‌های CVS عبور کند
ایجاد یک فایل tar.gz. این گزینه ممکن است چندین بار برای فهرست تکرار شود
الگوهای متعدد برای حذف

-I به خودی خود پیش فرض را اضافه می کند -- استثناء کردن گزینه هایی که فایل های کنترلی را فیلتر می کنند و
دایرکتوری های رایج ترین سیستم های کنترل ویرایش، فایل های پشتیبان و مبادله و
Libtool دایرکتوری های خروجی را می سازد.

توجه داشته باشید: در حالی که آنها اهداف مشابهی دارند، -i و -I دارای نحو بسیار متفاوت و
مفاهیم. -i فقط یک بار می تواند مشخص شود و یک عبارت منظم سازگار با perl را می گیرد
که با مسیر نسبی کامل هر فایل مطابقت دارد. -I می تواند چندگانه را مشخص کند
بار و یک الگوی نام فایل با علامت های عام پوسته می گیرد. الگو به کار می رود
مسیر نسبی کامل بلکه به هر بخش از مسیر به صورت جداگانه. معنایی دقیق
تار -- استثناء کردن گزینه تا حدودی پیچیده است، ببینید
https://www.gnu.org/software/tar/manual/tar.html#wildcards for a full documentation.

Regex و الگوهای پیش فرض برای هر دو گزینه را می توان در خروجی مشاهده کرد --کمک
فرمان

عمومی عصاره گزینه های
-- بدون کپی
تاربال های اصلی را در نزدیکی بسته منبع استخراج شده کپی نکنید (از dpkg
1.14.17).

-- بدون بررسی
قبل از باز کردن بسته بندی، امضاها و چک سام ها را بررسی نکنید (از dpkg 1.14.17).

--require-valid-signature
اگر بسته منبع حاوی امضای OpenPGP نیست، از باز کردن بسته بندی خودداری کنید
را می توان تأیید کرد (از dpkg 1.15.0) یا با کاربر trustedkeys.gpg دسته کلید،
یکی از کلیدهای مخصوص فروشنده یا یکی از کلیدهای رسمی دبیان
(/usr/share/keyrings/debian-keyring.gpg و
/usr/share/keyrings/debian-maintainers.gpg).

-نسخه بد
بررسی نسخه بسته منبع بد را به یک هشدار غیر کشنده تبدیل می کند (از dpkg
1.17.7). این گزینه فقط باید هنگام استخراج منبع قدیمی ضروری باشد
بسته هایی با نسخه های خراب، فقط برای سازگاری با عقب.

SOURCE بسته فرمها

اگر نمی‌دانید از چه قالب منبعی استفاده کنید، احتمالاً باید «3.0 (لحاف)» را انتخاب کنید.
یا "3.0 (بومی)". برای اطلاعات در مورد https://wiki.debian.org/Projects/DebSrc3.0 مراجعه کنید
استقرار آن فرمت ها در دبیان

فرمت: 1.0
یک بسته منبع در این قالب شامل یکی از یک است .orig.tar.gz مرتبط با .diff.gz
یا یک تک .tar.gz (در این صورت گفته می شود که بسته است بومی).

استخراج

استخراج یک بسته بومی یک استخراج ساده از تاربول منفرد در هدف است
فهرست راهنما. استخراج یک بسته غیر بومی با باز کردن بسته بندی انجام می شود .orig.tar.gz و
سپس پچ موجود در را اعمال کنید .diff.gz فایل. مهر زمانی همه فایل های وصله شده
به زمان استخراج بسته منبع بازنشانی می‌شود (با این کار از انحرافات مُهر زمان جلوگیری می‌شود
به مشکلاتی که فایل‌های تولید شده خودکار وصله می‌شوند). تفاوت می تواند فایل های جدید ایجاد کند (the
کل فهرست دبیان به این ترتیب ایجاد می شود) اما نمی تواند فایل ها را حذف کند (فایل های خالی خواهند بود
پس مانده غذا).

بنا

ساختن یک بسته بومی فقط ایجاد یک تاربال با دایرکتوری منبع است.
ساخت یک بسته غیر بومی شامل استخراج تربال اصلی به صورت جداگانه است
دایرکتوری “.orig” و ایجاد مجدد .diff.gz با مقایسه بسته منبع فهرست راهنما
با دایرکتوری orig.

ساختن گزینه های (با --ساختن):

اگر یک آرگومان غیر گزینه دوم ارائه شده باشد، باید نام منبع اصلی باشد
دایرکتوری یا tarfile یا رشته خالی اگر بسته مخصوص دبیان باشد و غیره
هیچ تفاوت Debianisation ندارد. اگر آرگومان دومی ارائه نشده باشد dpkg-source نگاه خواهد کرد
برای tarfile منبع اصلی package_upstream-نسخه.orig.tar.gz یا اصل
دایرکتوری منبع فهرست راهنمامنشاء بسته به -sX استدلال

-سا, -sp, -سک, -سو و -sr tarfiles یا فهرست های موجود را بازنویسی نمی کند. اگر این است
پس از آن مورد نظر -sA, -sP, -sK, -sU و -sR باید به جای آن استفاده شود

-سک مشخص می کند که به طور پیش فرض منبع اصلی به عنوان یک tarfile انتظار می رود package_upstream-
نسخه.orig.tar.گسترش. این منبع اصلی را به عنوان یک در جای خود باقی می گذارد
tarfile، یا آن را در دایرکتوری فعلی کپی کنید، اگر قبلاً آنجا نیست. تربال
در بسته بندی باز می شود فهرست راهنمامنشاء برای نسل تفاوت.

-sp پسندیدن -سک اما پس از آن دوباره دایرکتوری را حذف می کند.

-سو مشخص می کند که منبع اصلی به صورت پیش فرض به عنوان دایرکتوری انتظار می رود بسته-
نسخه بالادستمنشاء و dpkg-source یک آرشیو منبع اصلی جدید ایجاد می کند
از آن.

-sr پسندیدن -سو اما پس از استفاده آن دایرکتوری را حذف می کند.

-ss مشخص می کند که منبع اصلی هم به صورت دایرکتوری و هم به صورت a در دسترس است
tarfile dpkg-source از دایرکتوری برای ایجاد تفاوت استفاده می کند، اما از tarfile استفاده می کند
ایجاد کنید dsc. این گزینه باید با احتیاط استفاده شود - اگر دایرکتوری و tarfile باشد
مطابقت ندارد بایگانی منبع بد ایجاد خواهد شد.

-sn مشخص می کند که به دنبال هیچ منبع اصلی نباشد و تفاوت ایجاد نشود. را
آرگومان دوم، در صورت ارائه، باید رشته خالی باشد. این برای دبیان استفاده می شود
بسته های خاصی که منبع بالادستی جداگانه ندارند و بنابراین دارند
بدون انحراف تفاوت.

-سا or -sA
مشخص می کند که بایگانی منبع اصلی را به عنوان یک tarfile یا به عنوان یک فهرست جستجو کنید -
آرگومان دوم، در صورت وجود، ممکن است یکی یا رشته خالی باشد (این معادل است
به استفاده از -sn). اگر tarfile پیدا شود، آن را برای ایجاد تفاوت و
سپس آن را بردارید (این معادل است -sp) اگر دایرکتوری پیدا شود، پیدا می شود
آن را بسته بندی کنید تا منبع اصلی ایجاد شود و سپس آن را حذف کنید (این معادل است
به -sr) اگر هیچکدام یافت نشد، فرض می‌شود که بسته فاقد انحراف است
تفاوت، فقط یک آرشیو منبع ساده (این معادل است -sn). اگر هر دو
سپس پیدا می شوند dpkg-source دایرکتوری را نادیده می گیرد، آن را بازنویسی می کند، اگر -sA بود
مشخص شده است (این معادل است -sP) یا یک خطا مطرح کنید اگر -سا مشخص شد. -sA
پیش فرض است.

- تغییرات در بالادست
اگر تفاوت ایجاد شده حاوی تغییراتی در فایل‌های خارج از آن باشد، فرآیند با شکست مواجه می‌شود
دایرکتوری فرعی دبیان (از dpkg 1.15.8). این گزینه مجاز نیست
دبیان/منبع/گزینه ها اما قابل استفاده در debian/source/local-Options.

عصاره گزینه های (با --استخراج کردن):

در همه موارد، درخت منبع اصلی موجود حذف خواهد شد.

-sp هنگام استخراج استفاده می شود، سپس منبع اصلی (در صورت وجود) به عنوان یک tarfile باقی می ماند.
اگر قبلاً در دایرکتوری فعلی قرار نداشته باشد یا یک اما موجود باشد
فایل های مختلف وجود دارد و در آنجا کپی می شود. (این is la به طور پیش فرض).

-سو درخت منبع اصلی را باز می کند.

-sn اطمینان حاصل می کند که منبع اصلی نه در فهرست فعلی کپی شده است و نه
بسته بندی نشده هر درخت منبع اصلی که در دایرکتوری فعلی بود همچنان باقی است
حذف شده.

همه -sX گزینه ها متقابلا منحصر به فرد هستند. اگر بیش از یک مورد را مشخص کنید فقط آخرین مورد
استفاده خواهد شد.

-- skip-debianization
از کاربرد تفاوت دبیان در بالای منابع بالادستی صرفنظر می کند (از dpkg
1.15.1).

فرمت: 2.0
استخراج از dpkg 1.13.9 پشتیبانی می شود، ساختمان از dpkg 1.14.8 پشتیبانی می شود. همچنین شناختهشده است
به عنوان کلاه گیس و قلم. این قالب برای استفاده گسترده توصیه نمی شود، فرمت "3.0 (لحاف)"
جایگزین آن می کند. Wig&pen اولین مشخصات یک بسته منبع نسل جدید بود
فرمت.

رفتار این فرمت مانند فرمت "3.0 (لحاف)" است با این تفاوت که آن را دارد
از لیست صریح وصله ها استفاده نمی کند. همه فایل ها در debian/patch/ تطبیق پرل
عبارت منظم [\w-]+ باید وصله های معتبر باشند: آنها در زمان استخراج اعمال می شوند.

هنگام ساخت یک بسته منبع جدید، هر تغییری در منبع بالادستی در یک پچ ذخیره می شود
تحت عنوان zz_debian-diff-auto.

فرمت: 3.0 (بومی)
پشتیبانی از dpkg 1.14.17. این فرمت یک فرمت فرمت بسته بومی است
در قالب 1.0 تعریف شده است. از تمام روش های فشرده سازی پشتیبانی می کند و به طور پیش فرض نادیده می گیرد
هر فایل و دایرکتوری خاص VCS و همچنین بسیاری از فایل های موقت (مقدار پیش فرض را ببینید
مرتبط با -I گزینه در --کمک خروجی).

فرمت: 3.0 (لحاف)
پشتیبانی از dpkg 1.14.17. یک بسته منبع در این قالب شامل حداقل یک
تربال اصلی (.orig.tar.EXT جایی که EXT می تواند gz, bz2, لزما و xz) و یک دبیان
تربال (.debian.tar.EXT). همچنین می تواند حاوی تاربال های اصلی اضافی باشد
(.orig-جزءتار.EXT). جزء فقط می تواند شامل نویسه های حروف عددی و خط فاصله باشد
('-').

استخراج

ابتدا تربال اصلی اصلی استخراج می شود، سپس تمام تربال های اصلی اضافی استخراج می شوند
استخراج شده در زیرشاخه های به نام جزء بخشی از نام فایل آنها (هر پیش از
دایرکتوری موجود جایگزین می شود). دبیان تربال در بالای منبع استخراج می شود
دایرکتوری پس از حذف قبلی از قبل دبیان فهرست راهنما. توجه داشته باشید که دبیان
تربال باید حاوی الف باشد دبیان دایرکتوری فرعی اما می تواند حاوی فایل های باینری در خارج نیز باشد
از آن دایرکتوری (نگاه کنید به --شامل-دودویی گزینه).

همه وصله های فهرست شده در debian/patches/debian.series or debian/patches/series هستند پس
کاربردی. اگر فایل اول استفاده می شود و دومی وجود ندارد (یا یک پیوند نمادین است)،
سپس دومی با یک پیوند نمادین به اولی جایگزین می شود. این به معنای ساده کردن استفاده است
of لحاف برای مدیریت مجموعه پچ ها با این حال توجه داشته باشید که در حالی که dpkg-source پارس
به درستی فایل‌ها را با گزینه‌های صریح مورد استفاده برای برنامه پچ (ذخیره شده در هر کدام
خط بعد از نام فایل پچ و یک یا چند فاصله)، آن گزینه ها را نادیده می گیرد و
همیشه منتظر وصله هایی باشید که می توان با آن اعمال کرد -p1 گزینه ای از وصله. بنابراین منتشر خواهد شد
هنگامی که با چنین گزینه هایی روبرو می شود، هشدار می دهد و ساخت احتمالاً با شکست مواجه می شود.

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

بر خلاف لحافدر رفتار پیش‌فرض، انتظار می‌رود که وصله‌ها بدون هیچ گونه فازی اعمال شوند.
وقتی اینطور نیست، باید چنین وصله‌هایی را با آن به‌روزرسانی کنید لحاف، یا dpkg-source اراده
هنگام تلاش برای اعمال آنها، خطا رخ می دهد.

به همین ترتیب لحافرفتار پیش‌فرض، وصله‌ها می‌توانند فایل‌ها را نیز حذف کنند.

پرونده .pc/applied-patches در صورتی ایجاد می شود که برخی از وصله ها در طول دوره اعمال شده باشند
استخراج.

بنا

تمام تاربال های اصلی موجود در فهرست فعلی به صورت موقت استخراج می شوند
دایرکتوری با پیروی از منطق مشابه برای unpack، دایرکتوری دبیان کپی می شود
در دایرکتوری موقت، و همه وصله ها به جز وصله خودکار
(دبیان-تغییرات-نسخه or debian-changes، وابسته به --single-debian-patch) هستند
کاربردی. دایرکتوری موقت با دایرکتوری بسته منبع مقایسه می شود. وقتی که
diff خالی نیست، ساخت شکست می خورد مگر اینکه --single-debian-patch or --تعهد خودکار بوده است
استفاده می شود که در این صورت تفاوت در پچ خودکار ذخیره می شود. اگر پچ خودکار باشد
ایجاد/حذف شد، از فایل سری و از فایل اضافه/حذف می شود لحاف فراداده

هر گونه تغییر در یک فایل باینری قابل نمایش در یک تفاوت نیست و در نتیجه منجر به شکست می شود
مگر اینکه نگهدارنده عمدا تصمیم بگیرد که آن فایل باینری اصلاح شده را در فایل قرار دهد
دبیان تربال (با فهرست کردن آن در debian/source/include-binaries). ساخت نیز شکست خواهد خورد
اگر فایل های باینری را در دایرکتوری فرعی دبیان پیدا کند مگر اینکه در لیست سفید قرار گرفته باشند
از طریق debian/source/include-binaries.

دایرکتوری به روز شده دبیان و لیستی از باینری های اصلاح شده برای تولید استفاده می شود
دبیان تربال

تفاوت ایجاد شده به طور خودکار شامل تغییرات در فایل های خاص VCS نیز نمی شود
بسیاری از فایل های موقت (مقدار پیش فرض مربوط به را ببینید -i گزینه در --کمک خروجی). که در
خاص، .pc دایرکتوری مورد استفاده توسط لحاف در طول تولید خودکار نادیده گرفته می شود
پچ

توجه داشته باشید: dpkg-source --قبل از ساخت (و --ساختن) اطمینان حاصل می کند که تمام وصله های فهرست شده در
فایل سری اعمال می شود به طوری که یک بسته ساخت همیشه همه وصله ها اعمال می شود. این کار را انجام می دهد
این کار با یافتن وصله‌های اعمال نشده (آنها در فهرست شده‌اند سلسله فایل اما نه در
.pc/applied-patches) و اگر اولین پچ در آن مجموعه را بتوان بدون خطا اعمال کرد
همه آنها را اعمال خواهد کرد. گزینه -- عدم آمادگی می توان برای غیرفعال کردن این رفتار استفاده کرد.

ضبط تغییرات

--مرتکب شدن [فهرست راهنما] [پچ نام] [پچ فایل]
یک وصله مربوط به تغییرات محلی ایجاد می کند که توسط آن مدیریت نمی شود
لحاف پچ سیستم و آن را در سیستم پچ تحت نام ادغام می کند پچ نام.
اگر نام وجود نداشته باشد، به صورت تعاملی پرسیده می شود. اگر پچ فایل داده می شود، آن
به عنوان پچ مربوط به تغییرات محلی برای ادغام استفاده می شود. یک بار
یکپارچه، یک ویرایشگر راه اندازی می شود تا بتوانید متا اطلاعات را در آن ویرایش کنید
هدر پچ

عبور پچ فایل عمدتاً پس از یک شکست ساخت که از قبل این را ایجاد کرده است مفید است
فایل، و در این زمینه فایل داده شده پس از ادغام حذف می شود. همچنین توجه داشته باشید
که تغییرات موجود در فایل پچ باید قبلاً روی درخت اعمال شود
و اینکه فایل های اصلاح شده توسط پچ نباید تکمیلی ثبت نشده باشند
تغییرات.

اگر تولید پچ فایل های باینری اصلاح شده را شناسایی کند، آنها به طور خودکار انجام می شوند
اضافه شده به debian/source/include-binaries به طوری که آنها در نهایت به تربال دبیان ختم می شوند
(دقیقا شبیه dpkg-source --شامل-دودویی --ساختن انجام خواهد داد).

ساختن گزینه های

--allow-version-of-quilt-db=نسخه
اجازه دادن dpkg-source برای ساخت بسته منبع اگر نسخه از لحاف فراداده
مشخص شده است، حتی اگر dpkg-source در مورد آن نمی داند (از dpkg
1.15.5.4). به طور موثر این می گوید که نسخه داده شده از لحاف ابرداده است
سازگار با نسخه 2 که dpkg-source در حال حاضر پشتیبانی می کند. نسخه از
la لحاف ابرداده در ذخیره می شود نسخه pc/..

-- شامل - حذف
فایل های حذف شده را نادیده نگیرید و آنها را در وصله ایجاد شده به طور خودکار قرار دهید.

--include-timestamp
در وصله‌ای که به‌طور خودکار تولید می‌شود، مُهر زمانی را درج کنید.

--شامل-دودویی
تمام باینری های اصلاح شده را در دبیان تاربال اضافه کنید. همچنین آنها را به آنها اضافه کنید
debian/source/include-binaries: به طور پیش فرض در ساخت های بعدی اضافه خواهند شد
و بنابراین این گزینه دیگر مورد نیاز نیست.

-- عدم آمادگی
سعی نکنید با اعمال وصله هایی که ظاهراً هستند، درخت ساخت را آماده کنید
اعمال نشده (از dpkg 1.14.18).

--single-debian-patch
استفاده کنید debian/patch/debian-changes بجای debian/patch/debian-changes-نسخه
برای نام پچ خودکار تولید شده در حین ساخت (از dpkg 1.15.5.4).
این گزینه به ویژه زمانی مفید است که بسته در VCS و a نگهداری شود
مجموعه پچ را نمی توان با اطمینان ایجاد کرد. در عوض تفاوت فعلی با بالادست
باید در یک پچ ذخیره شود. گزینه قرار خواهد گرفت
debian/source/local-Options و با الف همراه خواهد بود
debian/source/local-patch-header فایل توضیح می دهد که چگونه تغییرات دبیان می تواند بهترین باشد
بررسی شده است، به عنوان مثال در VCS که استفاده می شود.

--ایجاد-خالی-منشأ
تاربال اصلی اصلی را به صورت خودکار در صورت نبود و اگر خالی ایجاد کنید
تاربال های اصلی تکمیلی وجود دارد (از dpkg 1.15.6). این گزینه است
زمانی که بسته منبع فقط یک بسته چندگانه بالادستی است استفاده می شود
نرم افزار و جایی که نرم افزار "اصلی" وجود ندارد.

--بدون عدم اعمال وصله، - unapply-patches
به طور پیش فرض، dpkg-source به طور خودکار وصله های موجود در را لغو می کند -- پس از ساخت
اگر آنها را در طول اعمال کرد، قلاب کنید --قبل از ساخت (- unapply-patches از dpkg
شماره ۱۰۲۹، --بدون عدم اعمال وصله از dpkg 1.16.5). آن گزینه ها به شما اجازه می دهند
به اجبار فرآیند حذف وصله را غیرفعال یا فعال کنید. آن گزینه ها هستند
فقط اجازه ورود debian/source/local-Options به طوری که تمام بسته های منبع تولید می شود
به طور پیش فرض همان رفتار را دارند.

- تغییرات در بالادست
اگر یک پچ خودکار (از dpkg 1.15.8) ایجاد شده باشد، فرآیند با شکست مواجه می شود.
از این گزینه می توان برای اطمینان از اینکه همه تغییرات به درستی ثبت شده اند استفاده کرد
جداگانه لحاف وصله های قبل از ساخت بسته منبع. این گزینه نیست
مجاز به ورود دبیان/منبع/گزینه ها اما قابل استفاده در debian/source/local-Options.

--تعهد خودکار
اگر یک پچ خودکار ایجاد شده باشد، این فرآیند شکست نمی‌خورد، در عوض شکست می‌خورد
بلافاصله در لحاف سری.

عصاره گزینه های

-- skip-debianization
از استخراج دبیان تاربال در بالای منابع بالادستی صرفنظر می کند (از dpkg
1.15.1).

-- skip-patches
در پایان استخراج از چسب ها استفاده نکنید (از dpkg 1.14.18).

فرمت: 3.0 (سفارشی)
پشتیبانی از dpkg 1.14.17. این قالب خاص است. این یک منبع واقعی را نشان نمی دهد
قالب بسته اما می تواند برای ایجاد بسته های منبع با فایل های دلخواه استفاده شود.

ساختن گزینه های

همه آرگومان های غیر گزینه ای به عنوان فایل برای ادغام در بسته منبع تولید شده در نظر گرفته می شوند.
آنها باید وجود داشته باشند و ترجیحاً در فهرست فعلی هستند. حداقل یک فایل باید باشد
داده شده.

--target-format=ارزش
ضروری. قالب واقعی بسته منبع تولید شده را تعریف می کند. تولید شده
فایل dsc این مقدار را در خود دارد قالب فیلد و نه "3.0 (سفارشی)".

فرمت: 3.0 (git)
پشتیبانی از dpkg 1.14.17. این قالب آزمایشی است.

یک بسته منبع در این قالب از یک بسته واحد از یک مخزن git تشکیل شده است .گیت به
منبع یک بسته را نگه دارید همچنین ممکن است وجود داشته باشد .gitshallow بازبینی لیست فایل برای
یک کلون git کم عمق

استخراج

بسته نرم افزاری به عنوان یک مخزن git در فهرست هدف کلون می شود. اگر وجود دارد
فایل gitshallow، به صورت نصب شده است .git / سطحی داخل مخزن کلون شده git.

توجه داشته باشید که به‌طور پیش‌فرض مخزن جدید همان شعبه‌ای را بررسی می‌کند که بود
در منبع اصلی بررسی شده است. (معمولا "استاد"، اما می تواند هر چیزی باشد.) هر
شعبه های دیگر زیر در دسترس خواهد بود ریموت/منبع/.

بنا

قبل از ادامه، برخی بررسی ها انجام می شود تا اطمینان حاصل شود که ما هیچ غیره نداریم
تغییرات غیرمتعهد را نادیده گرفت.

git-bundle(1) برای تولید بسته ای از مخزن git استفاده می شود. به طور پیش فرض، همه
شاخه ها و برچسب ها در مخزن در بسته گنجانده شده است.

ساختن گزینه های

--git-ref=کد عکس
به تعیین یک مرجع git برای درج در بسته git اجازه می دهد. استفاده پیش فرض را غیرفعال می کند
رفتار شامل تمام شاخه ها و برچسب ها. ممکن است چندین بار مشخص شود. در
کد عکس می تواند نام شاخه یا برچسبی باشد که باید در آن گنجانده شود. همچنین ممکن است هر پارامتری باشد
که می توان به آن منتقل کرد git-rev-list(1). مثلاً فقط استاد را شامل شود
شاخه، استفاده --git-ref=استاد. برای گنجاندن تمام تگ ها و شاخه ها، به جز برای
شعبه خصوصی، استفاده کنید --git-ref=--همه --git-ref=^خصوصی

--git-depth=عدد
یک کلون کم عمق با تاریخچه کوتاه شده به تعداد مشخص شده ایجاد می کند
تجدید نظرها

فرمت: 3.0 (bzr)
پشتیبانی از dpkg 1.14.17. این قالب آزمایشی است. یک تربال واحد تولید می کند
حاوی مخزن bzr.

استخراج

تربال باز می شود و سپس از bzr برای پرداخت شعبه فعلی استفاده می شود.

بنا

قبل از ادامه، برخی بررسی ها انجام می شود تا اطمینان حاصل شود که ما هیچ غیره نداریم
تغییرات غیرمتعهد را نادیده گرفت.

سپس بخش خاص VCS از دایرکتوری منبع در یک پوشه موقت کپی می شود
فهرست راهنما. قبل از اینکه این دایرکتوری موقت در یک تاربال بسته بندی شود، پاکسازی های مختلفی انجام می شود
برای صرفه جویی در فضا انجام می شود.

عیب یابی

نه منبع قالب مشخص شده in دبیان/منبع/فرمت
پرونده دبیان/منبع/فرمت باید همیشه وجود داشته باشد و فرمت منبع مورد نظر را نشان دهد.
برای سازگاری به عقب، فرمت "1.0" زمانی در نظر گرفته می شود که فایل به جز شما وجود نداشته باشد
نباید به این تکیه کرد: در مقطعی در آینده dpkg-source تغییر خواهد کرد تا شکست بخورد
زمانی که آن فایل وجود ندارد

منطق این است که فرمت "1.0" دیگر قالب توصیه شده نیست، معمولاً باید
یکی از قالب‌های جدیدتر («3.0 (لحاف)»، «3.0 (بومی)») را انتخاب کنید، اما dpkg-source انجام نخواهد داد
این به طور خودکار برای شما اگر می خواهید به استفاده از قالب قدیمی ادامه دهید، باید این کار را انجام دهید
صریح در مورد آن و قرار دادن "1.0" در آن دبیان/منبع/فرمت.

la تفاوت تغییر la پیروی بالادست فایل ها
هنگام استفاده از فرمت منبع "1.0" معمولاً تغییر مستقیم فایل های بالادست ایده بدی است
از آنجایی که تغییرات در فایل .diff.gz مخفی و عمدتاً غیرمستند می شوند. در عوض شما
باید تغییرات خود را به عنوان وصله در فهرست دبیان ذخیره کرده و در زمان ساخت اعمال کنید.
برای جلوگیری از این پیچیدگی، می توانید از قالب "3.0 (لحاف)" که این را ارائه می دهد نیز استفاده کنید
بومی

نمی توان نشان دادن تغییر دادن به پرونده
تغییرات در منابع بالادستی معمولاً با فایل های پچ ذخیره می شوند، اما همه تغییرات نمی توانند
با وصله ها نشان داده شود: آنها فقط می توانند محتوای فایل های متنی ساده را تغییر دهند. اگر شما
سعی کنید یک فایل را با چیزی از نوع متفاوت جایگزین کنید (به عنوان مثال جایگزین کردن یک فایل ساده
فایل با یک پیوند نمادین یا یک دایرکتوری)، این پیام خطا را دریافت خواهید کرد.

به تازگی ایجاد شده خالی پرونده پرونده اراده نه be نمایندگی in تفاوت
فایل های خالی را نمی توان با فایل های پچ ایجاد کرد. بنابراین این تغییر در ثبت نمی شود
بسته منبع و به شما در مورد آن هشدار داده می شود.

قابل اجرا حالت پرم of پرونده اراده نه be نمایندگی in تفاوت
فایل‌های وصله مجوزهای فایل‌ها را ضبط نمی‌کنند و بنابراین مجوزهای اجرایی نمی‌شوند
در بسته منبع ذخیره می شود. این هشدار این واقعیت را به شما یادآوری می کند.

ویژه حالت پرم of پرونده اراده نه be نمایندگی in تفاوت
فایل‌های وصله مجوزهای فایل‌ها را ضبط نمی‌کنند و بنابراین مجوزهای اصلاح‌شده هم نیستند
در بسته منبع ذخیره می شود. این هشدار این واقعیت را به شما یادآوری می کند.

فایل فرمها

دبیان/منبع/فرمت
این فایل در یک خط حاوی فرمتی است که باید برای ساخت منبع استفاده شود
بسته (فرمت های ممکن در بالا توضیح داده شده است). هیچ فضای پیشرو یا دنباله‌ای مجاز نیست.

debian/source/include-binaries
این فایل حاوی لیستی از فایل های باینری (یکی در هر خط) است که باید در آن گنجانده شود
دبیان تربال فضاهای پیشرو و انتهایی خالی شده است. خطوطی که با ' شروع می شوند#' هستند
نظر داده و از آن صرفنظر می شود. خطوط خالی نادیده گرفته می شوند.

دبیان/منبع/گزینه ها
این فایل حاوی لیستی از گزینه های طولانی است که باید به طور خودکار به آن اضافه شود
مجموعه ای از گزینه های خط فرمان a dpkg-source --ساختن or dpkg-source - فرمت چاپ زنگ زدن.
گزینه هایی مانند -- فشرده سازی و - سطح فشرده سازی برای این فایل مناسب هستند.

هر گزینه باید در یک خط جداگانه قرار گیرد. خطوط خالی و خطوطی که با ' شروع می شوند#' هستند
نادیده گرفته شده است. پیشرو '--' باید برداشته شود و گزینه های کوتاه مجاز نیستند. اختیاری
فضاهای اطراف " مجاز است=نماد و نقل قول اختیاری در اطراف مقدار مجاز است.
در اینجا نمونه ای از چنین فایلی آورده شده است:

# اجازه دهید dpkg-source یک debian.tar.bz2 با حداکثر فشرده سازی ایجاد کند
فشرده سازی = "bzip2"
سطح فشرده سازی = 9
# از debian/patches/debian-changes به عنوان وصله خودکار استفاده کنید
تک دبیان-پچ
# تغییرات در پیکربندی را نادیده بگیرید.{sub, guess}
extend-diff-ignore = "(^|/)(config.sub|config.guess)$"

توجه داشته باشید: قالب گزینه ها در این فایل پذیرفته نمی شوند، باید استفاده کنید دبیان/منبع/فرمت
به جای آن.

debian/source/local-Options
دقیقا شبیه دبیان/منبع/گزینه ها با این تفاوت که فایل در فایل تولید شده گنجانده نشده است
بسته منبع ذخیره یک اولویت مرتبط با نگهدارنده یا به آن می تواند مفید باشد
مخزن VCS که در آن بسته منبع نگهداری می شود.

debian/source/local-patch-header و debian/source/patch-header
متن فرم آزاد که در بالای پچ خودکار تولید شده در قالب‌های «2.0» یا قرار داده می‌شود
"3.0 (لحاف)". local-patch-header در بسته منبع تولید شده در حالی که گنجانده نشده است
پچ هدر است.

debian/patches/series
این فایل تمام وصله هایی را که باید اعمال شوند (به ترتیب داده شده) در بالای آن فهرست می کند
بسته منبع بالادست. فضاهای پیشرو و انتهایی خالی شده است. خطوطی که با
'#" نظرات هستند و از آنها صرفنظر می شود. خطوط خالی نادیده گرفته می شوند. خطوط باقی مانده با a شروع می شوند
نام فایل پچ (نسبت به debian/patch/ فهرست) تا اولین کاراکتر فاصله
یا انتهای خط اختیاری لحاف گزینه ها می توانند تا آخر خط یا اول دنبال شوند
'#قبل از یک یا چند فاصله (که شروع یک نظر تا پایان را نشان می دهد
خط).

با استفاده از خدمات onworks.net از منبع dpkg به صورت آنلاین استفاده کنید