.\" -*- 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 "deb822 5"
.TH deb822 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)"
deb822 \- قالب استاندارد داده‌های متنی دبیان با ساختار RFC822
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
سیستم مدیریت بسته، داده‌های ارائه‌شده در یک قالب مشترک را مدیریت می‌کند که با نام
\fIداده‌های کنترل\fR
شناخته می‌شوند و در
\fIفایل‌های کنترل\fR
ذخیره می‌گردند.
فایل‌های کنترل برای بسته‌های سورس (منبع)، بسته‌های باینری و فایل‌های
\&\fB.changes\fR
که نصب فایل‌های بارگذاری‌شده را کنترل می‌کنند، به کار می‌روند
(پایگاه‌های داده داخلی
\fBdpkg\fR
نیز دارای قالب مشابهی هستند).
.SH "سینتکس (SYNTAX)"
.IX Header "SYNTAX"
یک فایل کنترل از یک یا چند بند (یا پاراگراف) از فیلدها تشکیل شده است
(در گذشته گاهی به این بندها، پاراگراف گفته می‌شد).
بندها با خطوط خالی از یکدیگر جدا می‌شوند.
تجزیه‌کننده‌ها ممکن است خطوطی را که منحصراً شامل
U+0020 \fBSPACE\fR
و
U+0009 \fBTAB\fR
هستند به عنوان جداکننده بند بپذیرند، اما فایل‌های کنترل باید از خطوط خالی استفاده کنند.
برخی از فایل‌های کنترل تنها یک بند را مجاز می‌دانند؛ برخی دیگر چندین بند را مجاز می‌شمارند که در این حالت، هر بند معمولاً به یک بسته متفاوت اشاره دارد.
(به عنوان مثال، در بسته‌های سورس، بند اول به بسته سورس اشاره دارد و بندهای بعدی به بسته‌های باینری تولیدشده از سورس اشاره می‌کنند.)
ترتیب قرارگیری بندها در فایل‌های کنترل حائز اهمیت است.
.PP
هر بند از مجموعه‌ای از فیلدهای داده تشکیل می‌شود.
هر فیلد شامل نام فیلد است که در پی آن یک دونقطه
(U+003A \(oq\fB:\fR\(cq)
و سپس داده/مقدار مربوط به آن فیلد می‌آید.
نام فیلد از نویسه‌های US\-ASCII تشکیل می‌شود، به استثنای نویسه‌های کنترلی، فاصله و دونقطه (یعنی نویسه‌ها در بازه
U+0021 \(oq\fB!\fR\(cq
تا
U+0039 \(oq\fB9\fR\(cq
و
U+003B \(oq\fB;\fR\(cq
تا
U+007E \(oq\fB~\fR\(cq،
شامل خود آن‌ها).
نام‌های فیلد نباید با نویسه توضیح
(U+0023 \(oq\fB#\fR\(cq)
یا نویسه خط تیره
(U+002D \(oq\fB\-\fR\(cq)
آغاز شوند.
.PP
فیلد در پایان خط یا در پایان آخرین خط ادامه‌دار (پایین را ببینید) خاتمه می‌یابد.
فاصله‌های خالی افقی
(U+0020 \fBSPACE\fR و U+0009 \fBTAB\fR)
ممکن است بلافاصله قبل یا بعد از مقدار قرار گیرند و در آنجا نادیده گرفته می‌شوند؛ مرسوم است که پس از دونقطه یک فاصله قرار داده شود.
برای مثال، یک فیلد می‌تواند به شکل زیر باشد:
.Sp
.Vb 1
\& Package: dpkg
.Ve
.PP
که در آن نام فیلد
\fBPackage\fR
و مقدار فیلد
\fBdpkg\fR
است.
.PP
مقادیر خالی فیلد فقط در فایل‌های کنترل بسته سورس
(\fIdebian/control\fR)
مجاز هستند.
این فیلدها نادیده گرفته می‌شوند.
.PP
یک بند نباید شامل بیش از یک نمونه از یک نام فیلد خاص باشد.
.PP
سه نوع فیلد وجود دارد:
.RS 4
.IP \fBsimple\fR 4
.IX Item "simple"
فیلد، شامل مقدار آن، باید در یک خط واحد باشد.
تا کردن فیلد مجاز نیست.
اگر تعریف فیلد نوع متفاوتی را مشخص نکرده باشد، این نوع فیلد به عنوان نوع پیش‌فرض در نظر گرفته می‌شود.
.IP \fBfolded\fR 4
.IX Item "folded"
مقدار یک فیلد تاشده یک خط منطقی است که می‌تواند در چند خط گسترده شود.
خطوط پس از خط اول، خطوط ادامه نامیده می‌شوند و باید با یک
U+0020 \fBSPACE\fR
یا یک
U+0009 \fBTAB\fR
آغاز گردند.
فاصله خالی، از جمله هرگونه نویسه خط جدید، در مقادیر فیلدهای تاشده اهمیت معناداری ندارد.
.Sp
این روش تا کردن مشابه با RFC5322 است که به فایل‌های کنترل حاوی تنها یک بند و بدون فیلدهای چندخطی امکان می‌دهد توسط تجزیه‌کننده‌های نوشته‌شده برای RFC5322 خوانده شوند.
.IP \fBmultiline\fR 4
.IX Item "multiline"
مقدار یک فیلد چندخطی ممکن است شامل چندین خط ادامه‌دار باشد.
خط اول مقدار، یعنی بخشی که در همان خطِ نام فیلد قرار دارد، اغلب اهمیت خاصی دارد یا ممکن است لازم باشد خالی باشد.
سایر خطوط با پیروی از همان قواعد نحوی خطوط ادامه‌دار فیلدهای تاشده اضافه می‌شوند.
فاصله‌های خالی، شامل خطوط جدید، در مقادیر فیلدهای چندخطی معنادار هستند.
.RE
.RS 4
.Sp
فاصله خالی نباید در داخل نام‌ها (نام بسته‌ها، معماری‌ها، فایل‌ها یا هر چیز دیگری) یا شماره‌های نسخه، یا بین نویسه‌های روابط چندنویسه‌ای نسخه قرار گیرد.
.Sp
حضور و هدف یک فیلد و نحو مقدار آن ممکن است بین انواع مختلف فایل‌های کنترل متفاوت باشد.
.Sp
نام‌های فیلد به بزرگی و کوچکی حروف حساس نیستند، اما معمول است که نام فیلدها با استفاده از حروف بزرگ و کوچک ترکیبی مطابق آنچه در ادامه آمده است نوشته شوند.
مقادیر فیلدها به بزرگی و کوچکی حروف حساس هستند مگر اینکه در توضیحات فیلد خلاف آن ذکر شده باشد.
.Sp
جداکننده‌های بند (خطوط خالی) و خطوطی که منحصراً شامل
U+0020 \fBSPACE\fR
و
U+0009 \fBTAB\fR
هستند، در داخل مقادیر فیلدها یا بین فیلدها مجاز نمی‌باشند.
خطوط خالی در مقادیر فیلدها معمولاً با نشان دادن آن‌ها توسط یک
U+0020 \fBSPACE\fR
به دنبال یک نقطه
(U+002E \(oq\fB.\fR\(cq)
اسکیپ می‌شوند.
.Sp
خطوطی که بدون هیچ فاصله خالی ابتدایی با
U+0023 \(oq\fB#\fR\(cq
شروع می‌شوند خطوط توضیح هستند که فقط در فایل‌های کنترل بسته سورس
(\fIdebian/control\fR)
و در فایل‌های
\fBdeb\-origin\fR\|(5)
مجاز می‌باشند.
این خطوط توضیح حتی اگر بین دو خط ادامه قرار داشته باشند نادیده گرفته می‌شوند.
آن‌ها خطوط منطقی را پایان نمی‌دهند.
.Sp
تمام فایل‌های کنترل باید با کدگذاری UTF\-8 باشند.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
\&\fBRFC822\fR,
\&\fBRFC5322\fR.