.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" .\" Required to disable full justification in groff 1.23.0. .if n .ds AD l .\" ======================================================================== .\" .IX Title "dsc 5" .TH dsc 5 2026-03-06 1.23.7-dirty "dpkg suite" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "نام (NAME)" dsc \- قالب فایل کنترل بسته منبع دبیان .SH "خلاصه دستور (SYNOPSIS)" .IX Header "SYNOPSIS" \&\fIfilename\fR\fB.dsc\fR .SH "توضیحات (DESCRIPTION)" .IX Header "DESCRIPTION" هر بستهٔ منبع دبیان از یک فایل کنترل .dsc تشکیل شده است که حاوی چندین فیلد با قالب \fBdeb822\fR\|(5) می‌باشد. .PP هر فیلد با یک برچسب مانند \&\fBSource\fR یا \&\fBBinary\fR (غیرحساس به حروف بزرگ و کوچک) آغاز می‌شود که پس از آن یک دونقطه (:) و سپس بدنهٔ فیلد (حساس به حروف بزرگ و کوچک مگر اینکه خلاف آن ذکر شده باشد) قرار می‌گیرد. فیلدها فقط با برچسب‌های فیلد از یکدیگر متمایز و تفکیک می‌شوند. به عبارت دیگر، متن فیلد می‌تواند چندخطی باشد، اما ابزارهای نصب معمولاً هنگام پردازش بدنهٔ فیلد خطوط را به یکدیگر متصل می‌کنند (به‌جز در مورد فیلدهای چندخطی \&\fBPackage\-List\fR، \fBFiles\fR، \fBChecksums\-Sha1\fR و \fBChecksums\-Sha256\fR؛ به زیر مراجعه کنید). .PP داده‌های کنترلی ممکن است همان‌طور که در RFC9580 مشخص شده است، در یک امضای حفاظتی اسکی (ASCII Armored) از نوع OpenPGP محصور شده باشند. .SH "فیلدها (FIELDS)" .IX Header "FIELDS" .IP "\fBFormat:\fR \fIformat\-version\fR (الزامی)" 4 .IX Item "Format: format-version (required)" مقدار این فیلد نسخهٔ قالب بستهٔ منبع را مشخص می‌کند. این مقدار توسط برنامه‌هایی که با بستهٔ منبع سر و کار دارند برای تفسیر فهرست فایل‌های موجود در بستهٔ منبع و تعیین نحوهٔ باز کردن (unpack) آن به کار می‌رود. نحو مقدار این فیلد شامل یک شماره بازبینی اصلی عددی (\(lq0\-9\(rq)، یک نقطه (\(lq.\(rq)، یک بازبینی فرعی عددی (\(lq0\-9\(rq)، و سپس یک زیرنوع (subtype) اختیاری پس از فاصله (\(lq \et\(rq) است که در صورت مشخص شدن، کلمه‌ای از حروف و ارقام کوچک (\(lqa\-z0\-9\(rq) درون پرانتز (\(lq()\(rq) خواهد بود. زیرنوع در ساختار نحوی اختیاری است اما ممکن است برای بازبینی‌های خاصی از قالب منبع الزامی باشد. .Sp قالب‌های منبعی که در حال حاضر توسط \fBdpkg\fR پشتیبانی می‌شوند عبارتند از: \fB1.0\fR، \&\fB2.0\fR، \fB3.0 (native)\fR، \fB3.0 (quilt)\fR، \fB3.0 (git)\fR، \&\fB3.0 (bzr)\fR و \fB3.0 (custom)\fR. برای توضیحات مربوط به آن‌ها به \fBdpkg\-source\fR\|(1) مراجعه کنید. .IP "\fBSource:\fR \fIsource\-name\fR (الزامی)" 4 .IX Item "Source: source-name (required)" مقدار این فیلد نام بسته را تعیین می‌کند و توسط اکثر ابزارهای نصب برای ایجاد نام فایل‌ها استفاده می‌شود. .IP "\fBBinary:\fR \fIbinary\-package\-list\fR" 4 .IX Item "Binary: binary-package-list" این فیلد تاخورده (folded) فهرستی از بسته‌های باینری تولیدشده توسط این بستهٔ منبع را با کاما از هم جدا می‌کند. .Sp این فیلد اکنون با فیلد \fBPackage\-List\fR جایگزین شده است که اطلاعات کاملی دربارهٔ بسته‌های باینری تولیدی در هر معماری، نمایه ساخت (build-profile) و سایر محدودیت‌های دخیل ارائه می‌دهد. .IP "\fBArchitecture:\fR \fIarch\-list\fR (توصیه‌شده)" 4 .IX Item "Architecture: arch-list (recommended)" فهرست معماری مشخص می‌کند که این بسته روی چه نوع ماشین یا معماری‌ای اجرا می‌شود. این مقدار باید فهرستی از نام‌های معماری و/یا الگوهای عام (wildcards) باشد که با فاصله از هم جدا شده‌اند. .Sp نام‌های معماری و الگوهای عام معماری رایج عبارتند از \fBamd64\fR، \&\fBarmel\fR، \fBi386\fR، \fBlinux\-any\fR، \fBany\-amd64\fR و غیره. توجه داشته باشید که مقدار \fBall\fR برای بسته‌های مستقل از معماری، و \fBany\fR برای بسته‌های وابسته به معماری در نظر گرفته شده است. این فهرست می‌تواند شامل مقدار ویژهٔ \fBall\fR باشد (یا صرفاً از آن تشکیل شده باشد). هنگامی که فهرست شامل الگوی عام \fBany\fR باشد، تنها مقدار مجاز دیگر در فهرست \fBall\fR خواهد بود. .Sp مقدار این فیلد عموماً بر اساس فیلدهای \fBArchitecture\fR موجود در فایل \fIdebian/control\fR در بستهٔ منبع تولید می‌شود. .IP "\fBVersion:\fR \fIversion\-string\fR (الزامی)" 4 .IX Item "Version: version-string (required)" معمولاً این مقدار شماره نسخهٔ اصلی بسته به هر شکلی است که نویسندهٔ برنامه به کار برده است. همچنین ممکن است شامل شماره بازبینی دبیان (برای بسته‌های غیربومی یا non-native) باشد. قالب دقیق و الگوریتم مرتب‌سازی در \&\fBdeb\-version\fR\|(7) شرح داده شده است. .Sp \&\fBنکته\fR: در برخی توزیع‌ها، dpkg طوری تنظیم شده است که به منابع بومی با نسخه‌های غیربومی اجازهٔ فعالیت می‌دهد که این امر ساختار را نامنسجم کرده و به ابهام مفاهیم می‌افزاید و علاوه بر این ممکن است دامی برای خطاهای ناخواسته باشد. .IP "\fBOrigin:\fR \fIname\fR" 4 .IX Item "Origin: name" نام توزیعی که این بسته از آن سرچشمه می‌گیرد. .IP "\fBMaintainer:\fR \fIfullname\-email\fR (توصیه‌شده)" 4 .IX Item "Maintainer: fullname-email (recommended)" باید در قالب \(lqJoe Bloggs \(rq باشد و معمولاً مشخص‌کنندهٔ شخصی است که بسته را ایجاد کرده است، نه لزوماً نویسندهٔ نرم‌افزاری که بسته‌بندی شده است. .IP "\fBUploaders:\fR \fIfullname\-email\-list\fR" 4 .IX Item "Uploaders: fullname-email-list" تمام نام‌ها و نشانی‌های ایمیل نگه‌دارندگان همکار بسته را با همان قالب فیلد \fBMaintainer\fR فهرست می‌کند. نگه‌دارندگان همکار چندگانه باید با کاما از یکدیگر جدا شوند. .IP "\fBDescription\fR \fIshort\-description\fR" 4 .IX Item "Description short-description" .PD 0 .IP "\ \fIlong\-description\fR" 4 .IX Item " long-description" .PD قالب توضیحات بستهٔ منبع شامل یک خلاصهٔ کوتاه در خط اول (پس از فیلد \fBDescription\fR) است. خطوط بعدی باید برای توضیحات کامل‌تر و با جزئیات بیشتر به کار روند. ابتدای هر خط از توضیحات طولانی باید یک فاصله (space) وجود داشته باشد، و خطوط خالی در توضیحات طولانی باید شامل یک \(oq\fB.\fR\(cq پس از فاصلهٔ ابتدایی باشند. .IP "\fBHomepage:\fR \fIurl\fR" 4 .IX Item "Homepage: url" آدرس \fIurl\fR صفحهٔ اصلی پروژهٔ بالادستی. .IP "\fBStandards\-Version:\fR \fIversion\-string\fR (توصیه‌شده)" 4 .IX Item "Standards-Version: version-string (recommended)" جدیدترین نسخهٔ استانداردهای خط‌مشی توزیع را که این بسته با آن مطابقت دارد ثبت می‌کند. .IP "\fBVcs\-Browser:\fR \fIurl\fR" 4 .IX Item "Vcs-Browser: url" آدرس \fIurl\fR یک رابط وب برای مرور مخزن سیستم کنترل نسخه (VCS). .IP "\fBVcs\-Arch:\fR \fIurl\fR" 4 .IX Item "Vcs-Arch: url" .PD 0 .IP "\fBVcs\-Bzr:\fR \fIurl\fR" 4 .IX Item "Vcs-Bzr: url" .IP "\fBVcs\-Cvs:\fR \fIurl\fR" 4 .IX Item "Vcs-Cvs: url" .IP "\fBVcs\-Darcs:\fR \fIurl\fR" 4 .IX Item "Vcs-Darcs: url" .IP "\fBVcs\-Git:\fR \fIurl\fR" 4 .IX Item "Vcs-Git: url" .IP "\fBVcs\-Hg:\fR \fIurl\fR" 4 .IX Item "Vcs-Hg: url" .IP "\fBVcs\-Mtn:\fR \fIurl\fR" 4 .IX Item "Vcs-Mtn: url" .IP "\fBVcs\-Svn:\fR \fIurl\fR" 4 .IX Item "Vcs-Svn: url" .PD این فیلدها \fIurl\fR مخزن سیستم کنترل نسخهٔ مورد استفاده برای نگه‌داری بسته را اعلام می‌کنند. برای جزئیات بیشتر به \fBdeb\-src\-control\fR\|(5) مراجعه کنید. .IP "\fBTestsuite:\fR \fIname\-list\fR" 4 .IX Item "Testsuite: name-list" این فیلد اعلام می‌کند که بستهٔ منبع حاوی مجموعه‌های آزمون مشخص‌شده است. مقدار آن فهرستی از مجموعه‌های آزمون است که با کاما از هم جدا شده‌اند. اگر مقدار \fBautopkgtest\fR موجود باشد، انتظار می‌رود فایل \fIdebian/tests/control\fR وجود داشته باشد؛ اگر این فایل وجود داشته باشد اما مقدار آن ذکر نشده باشد، \fBdpkg\-source\fR به‌طور خودکار با حفظ مقادیر قبلی، آن را اضافه خواهد کرد. .IP "\fBTestsuite\-Triggers:\fR \fIpackage\-list\fR" 4 .IX Item "Testsuite-Triggers: package-list" این فیلد اجتماع تمام وابستگی‌های آزمون (فیلدهای \fBDepends\fR در فایل \fIdebian/tests/control\fR) را با حذف تمام محدودیت‌ها و تبدیل وابستگی‌های OR به روابط AND مجزا اعلام می‌کند؛ به‌جز بسته‌های باینری تولیدشده توسط همین بستهٔ منبع و معادل فراداده‌ای وابستگی آن یعنی \fB@\fR. .Sp \&\fBدلیل وجودی\fR: این فیلد ضروری است زیرا در غیر این صورت برای به دست آوردن وابستگی‌های آزمون، لازم بود هر بستهٔ منبع استخراج (unpack) شود. .IP "\fBBuild\-Depends:\fR \fIpackage\-list\fR" 4 .IX Item "Build-Depends: package-list" .PD 0 .IP "\fBBuild\-Depends\-Arch:\fR \fIpackage\-list\fR" 4 .IX Item "Build-Depends-Arch: package-list" .IP "\fBBuild\-Depends\-Indep:\fR \fIpackage\-list\fR" 4 .IX Item "Build-Depends-Indep: package-list" .IP "\fBBuild\-Conflicts:\fR \fIpackage\-list\fR" 4 .IX Item "Build-Conflicts: package-list" .IP "\fBBuild\-Conflicts\-Arch:\fR \fIpackage\-list\fR" 4 .IX Item "Build-Conflicts-Arch: package-list" .IP "\fBBuild\-Conflicts\-Indep:\fR \fIpackage\-list\fR" 4 .IX Item "Build-Conflicts-Indep: package-list" .PD این فیلدها روابط بین بستهٔ منبع و بسته‌های مورد نیاز برای ساخت آن را مشخص می‌کنند. توضیحات تکمیلی پیرامون این موارد در صفحه راهنمای \fBdeb\-src\-control\fR\|(5) آمده است. .IP \fBPackage\-List:\fR 4 .IX Item "Package-List:" .PD 0 .IP "\ \fIpackage\fR \fIpackage\-type\fR \fIsection\fR \fIpriority\fR \fIkey\-value\-list\fR" 4 .IX Item " package package-type section priority key-value-list" .PD این فیلد چندخطی حاوی فهرستی از بسته‌های باینری تولیدشده توسط این بستهٔ منبع است. .Sp مقدار \fIpackage\fR نام بستهٔ باینری است. .Sp مقدار \fIpackage\-type\fR نوع بستهٔ باینری است؛ معمولاً \fBdeb\fR، و مقدار رایج دیگر \fBudeb\fR می‌باشد. .Sp مقادیر \fIsection\fR و \fIpriority\fR با فیلدهای همنام در بستهٔ باینری مطابقت دارند، و در صورت حذف شدن به‌طور پیش‌فرض به ترتیب \fBunknown\fR و \fBoptional\fR خواهند بود (از نسخه dpkg 1.22.13 به بعد). .Sp مقدار \fIkey\-value\-list\fR فهرستی از زوج‌های \fIkey\fR\fB=\fR\fIvalue\fR جداشده با فاصله است و کلیدهای اختیاری شناخته‌شده در حال حاضر عبارتند از: .RS 4 .IP \fBarch\fR 4 .IX Item "arch" محدودیت معماری برگرفته از فیلد \fBArchitecture\fR بستهٔ باینری، که فاصله‌ها در آن به \(oq,\(cq تبدیل شده‌اند. .IP \fBprofile\fR 4 .IX Item "profile" فرمول نرمال‌شدهٔ محدودیت نمایه ساخت (build-profile) برگرفته از فیلد \fBBuild\-Profile\fR بستهٔ باینری، با تبدیل ANDها (فاصله داخل قلاب‌های شکسته) به \(oq,\(cq، و ORها (فاصله بین قلاب‌های شکسته) به \(oq+\(cq. تمامی قلاب‌های شکسته در طی نرمال‌سازی حذف می‌شوند. .Sp از نسخه 1.23.0 dpkg منسوخ شده و \fBprofile:v1\fR جایگزین آن شده است. .IP \fBprofile:v1\fR 4 .IX Item "profile:v1" فرمول نرمال‌شدهٔ محدودیت نمایه ساخت برگرفته از فیلد \fBBuild\-Profile\fR بستهٔ باینری، با تبدیل ANDها (فاصله داخل قلاب‌های شکسته) به \(oq&\(cq، و ORها (فاصله بین قلاب‌های شکسته) به \(oq|\(cq. تمامی قلاب‌های شکسته در طی نرمال‌سازی حذف می‌شوند. .Sp از نسخه 1.23.0 dpkg پشتیبانی می‌شود. .IP \fBprotected\fR 4 .IX Item "protected" اگر بستهٔ باینری محافظت‌شده (protected) باشد، این کلید حاوی مقدار فیلد \fBProtected\fR یعنی مقدار \fByes\fR خواهد بود. .Sp از نسخه 1.20.1 dpkg پشتیبانی می‌شود. .IP \fBessential\fR 4 .IX Item "essential" اگر بستهٔ باینری حیاتی (essential) باشد، این کلید حاوی مقدار فیلد \fBEssential\fR یعنی مقدار \fByes\fR خواهد بود. .RE .RS 4 .RE .IP "\fBFiles:\fR (الزامی، ضعیف)" 4 .IX Item "Files: (required, weak)" .PD 0 .IP "\fBChecksums\-Sha1:\fR (الزامی، ضعیف)" 4 .IX Item "Checksums-Sha1: (required, weak)" .IP "\fBChecksums\-Sha256:\fR (الزامی، قوی)" 4 .IX Item "Checksums-Sha256: (required, strong)" .IP "\ \fIchecksum\fR \fIsize\fR \fIfilename\fR" 4 .IX Item " checksum size filename" .PD این فیلدهای چندخطی حاوی فهرستی از فایل‌ها به همراه جمع‌آزمای (checksum) و اندازه برای هر کدام هستند. این فیلدها ساختار نحوی یکسانی دارند و تنها در الگوریتم جمع‌آزمای استفاده‌شده با یکدیگر تفاوت دارند: MD5 برای \fBFiles\fR، SHA\-1 برای \fBChecksums\-Sha1\fR و SHA\-256 برای \&\fBChecksums\-Sha256\fR. .Sp خط اول مقدار فیلد (بخشی که در همان خط نام فیلد پس از دونقطه قرار دارد) همیشه خالی است. محتوای فیلد به‌صورت خطوط ادامه‌دار، یک خط به ازای هر فایل، درج می‌شود. هر خط شامل جمع‌آزما، یک فاصله، اندازهٔ فایل، یک فاصله، و نام فایل است. .Sp این فیلدها تمام فایل‌هایی را که بستهٔ منبع را تشکیل می‌دهند فهرست می‌کنند. فهرست فایل‌ها در این فیلدها باید دقیقاً با فهرست فایل‌ها در سایر فیلدهای مرتبط مطابقت داشته باشد. .Sp \&\fBنکته\fR: جمع‌آزماهای MD5 و SHA\-1 ضعیف در نظر گرفته می‌شوند و هرگز نباید آن‌ها را برای اعتبارسنجی امن کافی دانست. .SH "گزارش باگ‌ها (BUGS)" .IX Header "BUGS" فیلد \fBFormat\fR قالب خود فایل \fB.dsc\fR و قالب بستهٔ منبع استخراج‌شده را با هم ترکیب و خلط می‌کند. .SH "همچنین ببینید (SEE ALSO)" .IX Header "SEE ALSO" \&\fBdeb822\fR\|(5)، \&\fBdeb\-src\-control\fR\|(5)، \&\fBdeb\-version\fR\|(7)، \&\fBdpkg\-source\fR\|(1).