.\" -*- 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 "deb-changes 5"
.TH deb-changes 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)"
deb\-changes \- قالب پرونده کنترل تغییرات بارگذاری دبیان
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "خلاصه دستور (SYNOPSIS)"
\&\fIfilename\fR\fB.changes\fR
.SH "توضیحات (DESCRIPTION)"
.IX Header "توضیحات (DESCRIPTION)"
هر بارگذاری دبیان از یک پروندهٔ کنترل \fB.changes\fR تشکیل شده است که حاوی تعدادی فیلد در قالب \fBdeb822\fR\|(5) است.
.PP
هر فیلد با یک برچسب آغاز می‌شود، مانند
\&\fBSource\fR
یا
\&\fBBinary\fR
(غیرحساس به حروف کوچک و بزرگ)، که به دنبال آن یک دونقطه (:) و سپس بدنهٔ فیلد
(حساس به حروف کوچک و بزرگ مگر خلاف آن قید شده باشد) می‌آید.
فیلدها فقط با برچسب‌های فیلد جدا می‌شوند.
به عبارت دیگر، متن فیلد ممکن است چندین خط باشد، اما ابزارهای نصب هنگام پردازش بدنهٔ فیلد، خطوط را به هم متصل می‌کنند (به‌جز در مورد فیلدهای چندخطی
\&\fBDescription\fR، \fBChanges\fR، \fBFiles\fR، \fBChecksums\-Sha1\fR
و
\&\fBChecksums\-Sha256\fR،
به ادامه مراجعه کنید).
.PP
داده‌های کنترلی ممکن است در یک امضای محصور OpenPGP ASCII Armored، همان‌طور که در RFC9580 مشخص شده است، قرار گیرند.
.SH "فیلدها (FIELDS)"
.IX Header "فیلدها (FIELDS)"
.IP "\fBFormat:\fR \fIformat\-version\fR (لازم)" 4
.IX Item "Format: format-version (required)"
مقدار این فیلد، نسخهٔ قالب پرونده را مشخص می‌کند.
نحو مقدار فیلد، یک شمارهٔ نسخه با دو بخش اصلی (major) و فرعی (minor) است.
تغییرات ناسازگار با نسخه‌های پیشین باعث افزایش نسخهٔ اصلی می‌شوند و تغییرات سازگار با گذشته (مانند افزودن فیلدها) نسخهٔ فرعی را افزایش می‌دهند.
نسخهٔ کنونی این قالب \fB1.8\fR است.
.IP "\fBDate:\fR \fIrelease\-date\fR (لازم)" 4
.IX Item "Date: release-date (required)"
تاریخی که بسته ساخته شده یا آخرین بار ویرایش شده است.
باید دقیقاً در همان قالب تاریخ در یک مدخل \fBdeb\-changelog\fR\|(5)
باشد.
.Sp
مقدار این فیلد معمولاً از پروندهٔ \fIdebian/changelog\fR
استخراج می‌شود.
.IP "\fBSource:\fR \fIsource\-name\fR [\fB(\fR\fIsource\-version\fR\fB)\fR] (لازم)" 4
.IX Item "Source: source-name [(source-version)] (required)"
نام بستهٔ مبدأ.
اگر نسخهٔ مبدأ با نسخهٔ باینری متفاوت باشد، پس از
\&\fIsource\-name\fR یک \fIsource\-version\fR داخل پرانتز قرار می‌گیرد.
این حالت زمانی رخ می‌دهد که بارگذاری از نوع صرفاً باینری توسط غیر نگه‌دارنده (binNMU) باشد.
.IP "\fBBinary:\fR \fIbinary\-package\-list\fR (بسته به زمینه لازم است)" 4
.IX Item "Binary: binary-package-list (required in context)"
این فیلد ادغام‌شده، فهرستی از بسته‌های باینری برای بارگذاری است که با فاصله از هم جدا شده‌اند.
اگر بارگذاری صرفاً مبدأ (source-only) باشد، این فیلد حذف می‌شود (از نسخهٔ dpkg 1.19.3 به بعد).
.IP "\fBArchitecture:\fR \fIarch\-list\fR" 4
.IX Item "Architecture: arch-list"
معماری‌های پرونده‌هایی را که در حال حاضر بارگذاری می‌شوند فهرست می‌کند.
.Sp
معماری‌های رایج عبارتند از \fBamd64\fR، \fBarmel\fR، \fBi386\fR و غیره.
توجه داشته باشید که مقدار ویژهٔ \fBall\fR برای بسته‌هایی در نظر گرفته شده که مستقل از معماری هستند (مانند اسکریپت‌های شل و Perl یا مستندات).
اگر مبدأ بسته نیز در حال بارگذاری باشد، ورودی ویژهٔ
\&\fBsource\fR نیز درج می‌شود.
.Sp
\&\fBنکته:\fR نویسه‌های عام (wildcard) معماری در این زمینه مجاز نیستند.
.IP "\fBVersion:\fR \fIversion\-string\fR (لازم)" 4
.IX Item "Version: version-string (required)"
به‌طور معمول، این مقدار همان شمارهٔ نسخهٔ اصلی بسته به هر شکلی است که نویسندهٔ برنامه به کار برده است.
همچنین ممکن است شامل یک شماره بازنگری دبیان (برای بسته‌های غیربومی) باشد.
قالب دقیق و الگوریتم مرتب‌سازی در
\&\fBdeb\-version\fR\|(7)
شرح داده شده است.
.Sp
\&\fBنکته\fR: در برخی توزیع‌ها،
dpkg طوری ساخته شده است که اجازه می‌دهد سورس‌های بومی دارای نسخه‌های غیربومی باشند؛ این موضوع باعث ناهمخوانی و سردرگمی در این مفهوم شده و علاوه بر این معمولاً دامی برای اشتباهات تصادفی است.
.IP "\fBDistribution:\fR \fIdistribution\fRs (لازم)" 4
.IX Item "Distribution: distributions (required)"
یک یا چند توزیع را فهرست می‌کند که با فاصله از هم جدا شده‌اند و نشان می‌دهد این نسخه پس از بارگذاری در آرشیو باید در کجا نصب شود.
.IP "\fBUrgency:\fR \fIurgency\fR (پیشنهاد‌شده)" 4
.IX Item "Urgency: urgency (recommended)"
میزان فوریت بارگذاری.
مقادیر شناخته‌شدهٔ کنونی، به ترتیب صعودی فوریت عبارتند از:
\&\fBlow\fR، \fBmedium\fR، \fBhigh\fR، \fBcritical\fR و \fBemergency\fR.
.IP "\fBMaintainer:\fR \fIfullname\-email\fR (لازم)" 4
.IX Item "Maintainer: fullname-email (required)"
باید در قالب \(lqJoe Bloggs <jbloggs@example.org>\(rq باشد و معمولاً شخصی است که بسته را ایجاد کرده است، برخلاف نویسندهٔ نرم‌افزاری که بسته‌بندی شده است.
.IP "\fBChanged\-By:\fR \fIfullname\-email\fR" 4
.IX Item "Changed-By: fullname-email"
باید در قالب \(lqJoe Bloggs <jbloggs@example.org>\(rq باشد و معمولاً شخصی است که تغییرات بسته را برای این انتشار آماده کرده است.
.IP "\fBDescription:\fR (پیشنهاد‌شده)" 4
.IX Item "Description: (recommended)"
.PD 0
.IP "\ \fIbinary\-package\-name\fR \fB\-\fR \fIbinary\-package\-summary\fR" 4
.IX Item " binary-package-name - binary-package-summary"
.PD
این فیلد چندخطی حاوی فهرستی از نام‌های بسته‌های باینری است که به دنبال آن یک فاصله، یک خط تیره (\(oq\fB\-\fR\(cq) و توضیحات کوتاه و احتمالاً کوتاه‌شدهٔ آن‌ها می‌آید.
اگر بارگذاری صرفاً مبدأ (source-only) باشد، این فیلد حذف می‌شود (از نسخهٔ dpkg 1.19.3 به بعد).
.IP "\fBCloses:\fR \fIbug\-number\-list\fR" 4
.IX Item "Closes: bug-number-list"
فهرستی از شماره‌های گزارش اشکال (bug) جداشده با فاصله، برای اشکالاتی که با این بارگذاری حل شده‌اند.
نرم‌افزار آرشیو توزیع ممکن است از این فیلد برای بستن خودکار شماره اشکال‌های ارجاع‌شده در سیستم ردیابی اشکال توزیع استفاده کند.
.IP "\fBBinary\-Only: yes\fR" 4
.IX Item "Binary-Only: yes"
این فیلد نشان می‌دهد که بارگذاری، یک ساخت صرفاً باینری توسط غیر نگه‌دارنده (binNMU) است.
این مقدار از کلید/مقدار \fBbinary\-only=yes\fR در مدخل فرادادهٔ changelog سرچشمه می‌گیرد.
.IP "\fBBuilt\-For\-Profiles:\fR \fIprofile\-list\fR" 4
.IX Item "Built-For-Profiles: profile-list"
این فیلد فهرستی از پروفایل‌های ساخت جداشده با نویسه‌های فاصله را مشخص می‌کند که این بارگذاری با آن‌ها ساخته شده است.
.IP "\fBChanges:\fR (لازم)" 4
.IX Item "Changes: (required)"
.PD 0
.IP "\ \fIchangelog\-entries\fR" 4
.IX Item " changelog-entries"
.PD
این فیلد چندخطی حاوی متن به‌هم‌پیوستهٔ تمام مدخل‌های تغییراتی (changelog) است که بخشی از این بارگذاری هستند.
برای اینکه این فیلد یک فیلد چندخطی معتبر باشد، خطوط خالی با یک نقطهٔ تنها (\(oq.\(cq) جایگزین می‌شوند و همهٔ خطوط به اندازهٔ یک نویسهٔ فاصله دندانه‌دار می‌شوند.
محتوای دقیق به قالب changelog بستگی دارد.
.IP "\fBFiles:\fR (لازم)" 4
.IX Item "Files: (required)"
.PD 0
.IP "\ \fImd5sum\fR \fIsize\fR \fIsection\fR \fIpriority\fR \fIfilename\fR" 4
.IX Item " md5sum size section priority filename"
.PD
این فیلد چندخطی شامل فهرستی از پرونده‌ها به همراه مقدار md5sum، اندازه، بخش (section) و اولویت (priority) برای هر پرونده است.
.Sp
خط اول مقدار فیلد (بخشی که در همان خطِ نام فیلد پس از دونقطه قرار دارد) همیشه خالی است.
محتوای فیلد به صورت خطوط ادامه‌دار، یک خط به ازای هر پرونده، بیان می‌شود.
هر خط شامل ورودی‌هایی است که با فاصله از هم جدا شده‌اند و پرونده را توصیف می‌کنند:
مقدار md5sum، اندازهٔ پرونده، بخش پرونده، اولویت پرونده و نام پرونده.
.Sp
اگر بخش در پروندهٔ کنترل الگوی بستهٔ مبدأ قید نشده باشد، مقدار پیش‌فرض آن \fBunknown\fR خواهد بود
(از نسخهٔ dpkg 1.22.13 به بعد).
.Sp
اگر اولویت در پروندهٔ کنترل الگوی بستهٔ مبدأ قید نشده باشد، مقدار پیش‌فرض آن \fBoptional\fR خواهد بود
(از نسخهٔ dpkg 1.22.13 به بعد).
.Sp
این فیلد تمام پرونده‌هایی را که این بارگذاری را تشکیل می‌دهند فهرست می‌کند.
فهرست پرونده‌ها در این فیلد باید با فهرست پرونده‌ها در سایر فیلدهای مرتبط \fBChecksums\fR مطابقت داشته باشد.
.Sp
\&\fBنکته\fR: جمع‌آزمای MD5 ضعیف در نظر گرفته می‌شود و هرگز نباید برای اعتبارسنجی امن کافی فرض شود، اما این فیلد قابل حذف نیست زیرا فراداده‌هایی را فراهم می‌کند که در هیچ جای دیگر در دسترس نیستند.
.IP "\fBChecksums\-Sha1:\fR (لازم، ضعیف)" 4
.IX Item "Checksums-Sha1: (required, weak)"
.PD 0
.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
این فیلدهای چندخطی حاوی فهرستی از پرونده‌ها به همراه جمع‌آزما و اندازهٔ هر یک هستند.
این فیلدها نحو یکسانی دارند و تنها در الگوریتم جمع‌آزمای استفاده‌شده تفاوت دارند: SHA\-1 برای \fBChecksums\-Sha1\fR و SHA\-256 برای \fBChecksums\-Sha256\fR.
.Sp
خط اول مقدار فیلد (بخشی که در همان خطِ نام فیلد پس از دونقطه قرار دارد) همیشه خالی است.
محتوای فیلد به صورت خطوط ادامه‌دار، یک خط به ازای هر پرونده، بیان می‌شود.
هر خط شامل ورودی‌هایی است که با فاصله از هم جدا شده‌اند و پرونده را توصیف می‌کنند:
جمع‌آزما، اندازهٔ پرونده و نام پرونده.
.Sp
این فیلدها تمام پرونده‌هایی را که این بارگذاری را تشکیل می‌دهند فهرست می‌کند.
فهرست پرونده‌ها در این فیلدها باید با فهرست پرونده‌ها در فیلد
\&\fBFiles\fR و سایر فیلدهای مرتبط \fBChecksums\fR مطابقت داشته باشد.
.Sp
\&\fBنکته\fR: جمع‌آزمای SHA\-1 ضعیف در نظر گرفته می‌شود و هرگز نباید برای اعتبارسنجی امن کافی فرض شود.
.SH "اشکالات (BUGS)"
.IX Header "اشکالات (BUGS)"
فیلد \fBFiles\fR با سایر فیلدهای \fBChecksums\fR ناهمخوان است.
فیلدهای \fBChanged\-By\fR و \fBMaintainer\fR نام‌های گیج‌کننده‌ای دارند.
فیلد \fBDistribution\fR حاوی اطلاعاتی در مورد چیزی است که معمولاً به عنوان یک مجموعه (suite) از آن یاد می‌شود.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "همچنین ببینید (SEE ALSO)"
\&\fBdeb822\fR\|(5)،
\&\fBdeb\-src\-control\fR\|(5)،
\&\fBdeb\-version\fR\|(7).