.\" -*- 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 "dpkg-gencontrol 1"
.TH dpkg-gencontrol 1 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)"
dpkg\-gencontrol \- تولید فایل‌های کنترل دبیان
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "خلاصه دستور (SYNOPSIS)"
\&\fBdpkg\-gencontrol\fR
[\fIگزینه\fR...]
.SH "توضیحات (DESCRIPTION)"
.IX Header "توضیحات (DESCRIPTION)"
دستور
\&\fBdpkg\-gencontrol\fR
اطلاعات را از یک درخت منبع بازشدهٔ دبیان می‌خواند و یک فایل کنترل بستهٔ باینری (که به‌طور پیش‌فرض
\&\fBdebian/tmp/DEBIAN/control\fR
است) تولید می‌کند؛ در طول این فرآیند، فیلدهای رابطه را ساده‌سازی می‌نماید.
.PP
بدین ترتیب، فیلدهای
\&\fBPre\-Depends\fR،
\&\fBDepends\fR،
\&\fBRecommends\fR
و
\&\fBSuggests\fR
به همین ترتیب با حذف وابستگی‌هایی که با توجه به وابستگی‌های قوی‌ترِ پیش‌تر پردازش‌شده صادق هستند، ساده‌سازی می‌شوند.
همچنین هرگونه وابستگی به خود (self-dependency) را حذف می‌کند
(در واقع هر وابستگی‌ای را که با توجه به نسخهٔ فعلی بسته به عنوان بستهٔ نصب‌شده برقرار باشد، حذف خواهد کرد).
از نظر منطقی، این دستور اشتراک وابستگی‌های چندگانه روی یک بستهٔ یکسان را نگه می‌دارد.
ترتیب وابستگی‌ها تا حد امکان حفظ می‌شود: اگر وابستگی‌ای به دلیل وجود وابستگی دیگری در ادامهٔ فیلد باید کنار گذاشته شود، وابستگی جایگزین جای وابستگی حذف‌شده را خواهد گرفت.
.PP
سایر فیلدهای رابطه
(\fBEnhances\fR،
\&\fBConflicts\fR،
\&\fBBreaks\fR،
\&\fBReplaces\fR
و
\&\fBProvides\fR)
نیز هنگامی که یک بسته چندین بار در فیلد فهرست شده باشد، با محاسبهٔ اجتماع وابستگی‌های گوناگون به‌طور جداگانه ساده‌سازی می‌شوند.
.PP
دستور
\&\fBdpkg\-gencontrol\fR
همچنین یک مدخل برای بستهٔ باینری به فایل
\&\fBdebian/files\fR
اضافه می‌کند.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "گزینه‌ها (OPTIONS)"
.IP \fB\-v\fR\fIversion\fR 4
.IX Item "-vversion"
شماره نسخهٔ بستهٔ باینری‌ای را که تولید خواهد شد تعیین می‌کند.
.IP \fB\-V\fR\fIname\fR\fB=\fR\fIvalue\fR 4
.IX Item "-Vname=value"
یک متغیر جایگزینی خروجی را تنظیم می‌کند.
برای بررسی و توضیحات پیرامون جایگزینی در خروجی،
\&\fBdeb\-substvars\fR\|(5)
را ببینید.
.IP \fB\-T\fR\fIsubstvars\-file\fR 4
.IX Item "-Tsubstvars-file"
متغیرهای جایگزینی را در
\&\fIsubstvars\-file\fR
می‌خواند؛ مقدار پیش‌فرض
\&\fBdebian/substvars\fR
است.
این گزینه می‌تواند چندین بار برای خواندن متغیرهای جایگزینی از چندین فایل استفاده شود (از dpkg نسخه 1.15.6 به بعد).
.IP \fB\-D\fR\fIfield\fR\fB=\fR\fIvalue\fR 4
.IX Item "-Dfield=value"
یک فیلد فایل کنترل خروجی را جایگزین کرده یا می‌افزاید.
.IP \fB\-U\fR\fIfield\fR 4
.IX Item "-Ufield"
یک فیلد فایل کنترل خروجی را حذف می‌کند.
.IP \fB\-c\fR\fIcontrol\-file\fR 4
.IX Item "-ccontrol-file"
فایل اصلی کنترل منبع را برای خواندن اطلاعات مشخص می‌کند.
مقدار پیش‌فرض
\&\fBdebian/control\fR
است.
.IP \fB\-l\fR\fIchangelog\-file\fR 4
.IX Item "-lchangelog-file"
فایل گزارش تغییرات را برای خواندن اطلاعات مشخص می‌کند.
مقدار پیش‌فرض
\&\fBdebian/changelog\fR
است.
.IP \fB\-f\fR\fIfiles\-list\-file\fR 4
.IX Item "-ffiles-list-file"
فهرست فایل‌هایی را که باید بارگذاری شوند در اینجا می‌خواند یا می‌نویسد، به جای استفاده از
\&\fBdebian/files\fR.
.IP \fB\-F\fR\fIchangelog\-format\fR 4
.IX Item "-Fchangelog-format"
قالب گزارش تغییرات را مشخص می‌کند.
برای اطلاعات بیشتر دربارهٔ قالب‌های جایگزین،
\&\fBdpkg\-parsechangelog\fR\|(1)
را ببینید.
.IP \fB\-p\fR\fIpackage\fR 4
.IX Item "-ppackage"
اطلاعات را برای بستهٔ باینری
\&\fIpackage\fR
تولید می‌کند.
اگر فایل کنترل منبع تنها یک بستهٔ باینری را فهرست کند، این گزینه ممکن است نادیده گرفته شود؛ در غیر این صورت، انتخاب اینکه اطلاعات کدام بستهٔ باینری تولید شود ضروری است.
.IP \fB\-n\fR\fIfilename\fR 4
.IX Item "-nfilename"
فرض می‌کند نام فایل بسته به جای نام معمول package_version_arch.deb، برابر با
\&\fIfilename\fR
خواهد بود.
.IP "\fB\-is\fR, \fB\-ip\fR, \fB\-isp\fR" 4
.IX Item "-is, -ip, -isp"
این گزینه‌ها برای سازگاری با نسخه‌های قدیمی‌تر اسکریپت‌های ساخت dpkg نادیده گرفته می‌شوند، اما اکنون منسوخ شده‌اند.
پیش‌تر از آن‌ها استفاده می‌شد تا به
\&\fBdpkg\-gencontrol\fR
اعلام کنند فیلدهای Section و Priority را در فایل کنترل بگنجاند.
این مورد اکنون رفتار پیش‌فرض است.
اگر می‌خواهید رفتار پیشین را به دست آورید، می‌توانید از گزینهٔ
\&\fB\-U\fR
برای حذف این فیلدها از فایل کنترل استفاده کنید.
.IP \fB\-P\fR\fIpackage\-build\-dir\fR 4
.IX Item "-Ppackage-build-dir"
به جای
\&\fBdebian/tmp\fR،
دایرکتوری
\&\fIpackage\-build\-dir\fR
را بررسی (پویش) می‌کند.
این مقدار برای یافتن مقدار پیش‌فرض متغیر جایگزینی و فیلد فایل کنترل
\&\fBInstalled\-Size\fR،
و همچنین برای محل پیش‌فرض فایل خروجی استفاده می‌شود.
.IP \fB\-O\fR[\fIfilename\fR] 4
.IX Item "-O[filename]"
فایل کنترل را در خروجی استاندارد (یا در صورت تعیین، در
\&\fIfilename\fR،
از dpkg نسخه 1.17.2 به بعد) چاپ می‌کند، به جای چاپ در
\&\fBdebian/tmp/DEBIAN/control\fR
(یا
\&\fIpackage\-build\-dir\fR\fB/DEBIAN/control\fR
اگر از
\&\fB\-P\fR
استفاده شده باشد).
.IP "\fB\-?\fR, \fB\-\-help\fR" 4
.IX Item "-?, --help"
پیام راهنمای استفاده را نمایش داده و خارج می‌شود.
.IP \fB\-\-version\fR 4
.IX Item "--version"
اطلاعات نسخه را نمایش داده و خارج می‌شود.
.SH "محیط (ENVIRONMENT)"
.IX Header "محیط (ENVIRONMENT)"
.IP \fBDEB_HOST_ARCH\fR 4
.IX Item "DEB_HOST_ARCH"
معماری میزبان را تعیین می‌کند.
.IP \fBDPKG_COLORS\fR 4
.IX Item "DPKG_COLORS"
حالت رنگ را تعیین می‌کند (از dpkg نسخه 1.18.5 به بعد).
مقادیر پذیرفته‌شده در حال حاضر عبارتند از:
\&\fBauto\fR
(پیش‌فرض)،
\&\fBalways\fR
و
\&\fBnever\fR.
.IP \fBDPKG_NLS\fR 4
.IX Item "DPKG_NLS"
در صورت تنظیم، برای تصمیم‌گیری در مورد فعال‌سازی پشتیبانی از زبان بومی (Native Language Support)، که به عنوان پشتیبانی از بین‌المللی‌سازی (یا i18n) نیز شناخته می‌شود، به کار می‌رود (از dpkg نسخه 1.19.0 به بعد).
مقادیر پذیرفته‌شده عبارتند از:
\&\fB0\fR
و
\&\fB1\fR
(پیش‌فرض).
.SH "فایل‌ها (FILES)"
.IX Header "فایل‌ها (FILES)"
.IP \fBdebian/control\fR 4
.IX Item "debian/control"
فایل الگوی کنترل بستهٔ منبع، که اطلاعات مستقل از نسخه را دربارهٔ بستهٔ منبع و بسته‌های باینری‌ای که می‌تواند تولید کند، ارائه می‌دهد.
.IP \fBdebian/files\fR 4
.IX Item "debian/files"
فهرست فایل‌های تولیدشده که بخشی از بارگذاری در حال آماده‌سازی هستند.
دستور
\&\fBdpkg\-gencontrol\fR
نام‌های فرضی بسته‌های باینری‌ای را که فایل‌های کنترل آن‌ها را تولید می‌کند، در اینجا اضافه می‌نماید.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "همچنین ببینید (SEE ALSO)"
\&\fBdeb\-substvars\fR\|(5),
\&\fBdeb\-src\-control\fR\|(5),
\&\fBdeb\-changelog\fR\|(5),
\&\fBdeb\-control\fR\|(5).