.\" -*- 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-split 1"
.TH dpkg-split 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\-split \- ابزار تقسیم و اتصال آرشیو بسته‌های دبیان
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "خلاصه دستور (SYNOPSIS)"
\&\fBdpkg\-split\fR
[\fIگزینه\fR...] \fIدستور\fR
.SH "توضیحات (DESCRIPTION)"
.IX Header "توضیحات (DESCRIPTION)"
دستور
\&\fBdpkg\-split\fR
فایل‌های بسته باینری دبیان را به بخش‌های کوچکتری تقسیم کرده و آنها را مجدداً به هم متصل (سرهم) می‌کند تا از ذخیره‌سازی فایل‌های بسته حجیم بر روی رسانه‌های کوچک مانند فلاپی‌دیسک‌ها پشتیبانی کند.
.PP
این ابزار می‌تواند به‌صورت دستی با استفاده از گزینه‌های
\&\fB\-\-split\fR، \fB\-\-join\fR
و
\&\fB\-\-info\fR
به‌کار گرفته شود.
.PP
همچنین دارای یک حالت خودکار است که با استفاده از گزینه
\&\fB\-\-auto\fR
فراخوانی می‌شود؛ در این حالت صفی از بخش‌های دیده‌شده ولی هنوز سرهم‌نشده را نگهداری کرده و هنگامی که تمام بخش‌های یک فایل بسته را مشاهده کرد، آن را بازسازی می‌کند.
گزینه‌های
\&\fB\-\-listq\fR
و
\&\fB\-\-discard\fR
امکان مدیریت این صف را فراهم می‌کنند.
.PP
تمامی عملیات تقسیم، اتصال و صف‌بندی، پیام‌های اطلاع‌رسانی روی خروجی استاندارد تولید می‌کنند؛ این پیام‌ها را می‌توان با خیال راحت نادیده گرفت.
.SH "دستورها (COMMANDS)"
.IX Header "دستورها (COMMANDS)"
.IP "\fB\-s\fR, \fB\-\-split\fR \fIcomplete\-archive\fR [\fIprefix\fR]" 4
.IX Item "-s, --split complete-archive [prefix]"
یک بسته باینری منفرد دبیان را به چندین بخش تقسیم می‌کند.
.Sp
نام‌گذاری بخش‌ها به‌صورت
\&\fIprefix\fR\fB.\fR\fIN\fR\fBof\fR\fIM\fR\fB.deb\fR
خواهد بود که در آن
\&\fIN\fR
شماره بخش (با شروع از ۱) و
\&\fIM\fR
تعداد کل بخش‌ها است (هر دو در مبنای ده).
.Sp
اگر هیچ
\&\fIprefix\fR
(پیشوندی) ارائه نشود، نام فایل
\&\fIcomplete\-archive\fR
(آرشیو کامل)، از جمله مسیر دایرکتوری آن، با حذف پسوند انتهایی
\&\fB.deb\fR
در نظر گرفته می‌شود.
.IP "\fB\-j\fR, \fB\-\-join\fR \fIpart\fR..." 4
.IX Item "-j, --join part..."
بخش‌های یک فایل بسته را به یکدیگر متصل کرده و فایل اصلی را به همان صورتی که قبل از تقسیم بود بازسازی می‌کند.
.Sp
فایل‌های بخشی که به‌عنوان آرگومان داده می‌شوند باید دقیقاً تمام بخش‌های همان فایل باینری اصلی باشند.
هر بخش باید دقیقاً یک بار در فهرست آرگومان‌ها بیاید، هرچند نیازی نیست که بخش‌ها به ترتیب فهرست شوند.
.Sp
البته تمام بخش‌ها باید با اندازه بخش یکسانی که در زمان تقسیم مشخص شده بود ایجاد شده باشند، به این معنی که معمولاً باید توسط یک بار اجرای یکسان
\&\fBdpkg\-split \-\-split\fR
تولید شده باشند.
.Sp
نام فایل بخش‌ها برای فرآیند بازسازی و سرهم‌بندی اهمیتی ندارد.
.Sp
به‌طور پیش‌فرض، نام فایل خروجی به‌صورت
\&\fIpackage\fR\fB_\fR\fIversion\fR\fB_\fR\fIarch\fR\fB.deb\fR
خواهد بود.
.IP "\fB\-I\fR, \fB\-\-info\fR \fIpart\fR..." 4
.IX Item "-I, --info part..."
اطلاعات مربوط به فایل(های) بخش مشخص‌شده را در قالبی خوانا برای انسان چاپ می‌کند.
آرگومان‌هایی که بخش‌های بسته باینری نیستند، در عوض پیامی مبنی بر این موضوع تولید می‌کنند (اما همچنان در خروجی استاندارد).
.IP "\fB\-a\fR, \fB\-\-auto \-o\fR \fIcomplete\-output\fR \fIpart\fR" 4
.IX Item "-a, --auto -o complete-output part"
بخش‌ها را به‌طور خودکار در صف قرار می‌دهد و در صورت امکان بسته را بازسازی می‌کند.
.Sp
بخش
\&\fIpart\fR
مشخص‌شده بررسی شده و با سایر بخش‌های همان بسته (در صورت وجود) در صف بخش‌های فایل بسته‌ها مقایسه می‌شود.
.Sp
اگر تمام بخش‌های فایل بسته‌ای که
\&\fIpart\fR
بخشی از آن است موجود باشند، بسته سرهم شده و در
\&\fIcomplete\-output\fR
نوشته می‌شود (که معمولاً نباید از قبل وجود داشته باشد، هرچند وجود آن خطا محسوب نمی‌شود).
.Sp
در غیر این صورت،
\&\fIpart\fR
در صف کپی شده و
\&\fIcomplete\-output\fR
ایجاد نمی‌شود.
.Sp
اگر
\&\fIpart\fR
یک بخش از بسته باینری تقسیم‌شده نباشد،
\&\fBdpkg\-split\fR
با وضعیت خروج \fB1\fR خارج می‌شود؛ اگر مشکل دیگری رخ دهد، با وضعیت \fB2\fR خارج خواهد شد.
.Sp
هنگام استفاده از
\&\fB\-\-auto\fR
باید گزینه
\&\fB\-\-output\fR
یا
\&\fB\-o\fR
ارائه شود.
(اگر این امر اجباری نبود، برنامه فراخواننده نمی‌دانست چه فایل خروجی را انتظار داشته باشد.)
.IP "\fB\-l\fR, \fB\-\-listq\fR" 4
.IX Item "-l, --listq"
محتویات صف بسته‌های در انتظار بازسازی را فهرست می‌کند.
.Sp
برای هر فایل بسته‌ای که بخش‌هایی از آن در صف قرار دارند، خروجی نام بسته، بخش‌های موجود در صف و تعداد کل بایت‌های ذخیره‌شده در صف را نشان می‌دهد.
.IP "\fB\-d\fR, \fB\-\-discard\fR [\fIpackage\fR...]" 4
.IX Item "-d, --discard [package...]"
بخش‌هایی را که در صف منتظر بخش‌های باقیمانده بسته‌های خود هستند دور می‌ریزد (حذف می‌کند).
.Sp
اگر هیچ
\&\fIpackage\fR
(بسته‌ای) مشخص نشود، صف به‌طور کامل پاک می‌شود؛ اگر بسته‌ای مشخص شود، فقط بخش‌های بسته(های) مربوطه حذف می‌شوند.
.IP "\fB\-?\fR, \fB\-\-help\fR" 4
.IX Item "-?, --help"
پیام راهنمای نحوه استفاده را نمایش داده و خارج می‌شود.
.IP \fB\-\-version\fR 4
.IX Item "--version"
نسخه برنامه را نمایش داده و خارج می‌شود.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "گزینه‌ها (OPTIONS)"
.IP "\fB\-\-depotdir\fR \fIdirectory\fR" 4
.IX Item "--depotdir directory"
یک دایرکتوری جایگزین برای صف بخش‌های در انتظار بازسازی خودکار مشخص می‌کند.
مقدار پیش‌فرض
\&\fB/var/lib/dpkg/parts\fR
است.
.IP "\fB\-\-admindir\fR \fIdirectory\fR" 4
.IX Item "--admindir directory"
دایرکتوری مدیریتی را روی \fIdirectory\fR تنظیم می‌کند (از dpkg 1.21.10).
این مکان جایی است که فایل \fIstatoverride\fR ذخیره می‌شود.
در صورتی که \fBDPKG_ADMINDIR\fR تنظیم نشده باشد، مقدار پیش‌فرض \(Fo\fI/var/lib/dpkg\fR\(Fc خواهد بود.
.IP "\fB\-\-root\fR \fIdirectory\fR" 4
.IX Item "--root directory"
دایرکتوری ریشه را روی \fBdirectory\fR تنظیم می‌کند (از dpkg 1.21.10)،
که در صورت تنظیم نشدن \fBDPKG_ROOT\fR، دایرکتوری نصب را روی \(Fo\fIdirectory\fR\(Fc و
دایرکتوری مدیریتی را روی \(Fo\fIdirectory\fR\fB/var/lib/dpkg\fR\(Fc
تنظیم می‌کند.
.IP "\fB\-S\fR, \fB\-\-partsize\fR \fIkibibytes\fR" 4
.IX Item "-S, --partsize kibibytes"
حداکثر اندازه هر بخش را هنگام تقسیم، بر حسب کیبی‌بایت (۱۰۲۴ بایت) مشخص می‌کند.
مقدار پیش‌فرض 450 KiB است.
.IP "\fB\-o\fR, \fB\-\-output\fR \fIcomplete\-output\fR" 4
.IX Item "-o, --output complete-output"
نام فایل خروجی را برای بازسازی مشخص می‌کند.
.Sp
این گزینه مقدار پیش‌فرض را برای بازسازی دستی
(\fB\-\-join\fR)
بازنویسی کرده و برای صف‌بندی یا بازسازی خودکار
(\fB\-\-auto\fR)
اجباری است.
.IP "\fB\-Q\fR, \fB\-\-npquiet\fR" 4
.IX Item "-Q, --npquiet"
هنگام انجام صف‌بندی یا بازسازی خودکار،
\&\fBdpkg\-split\fR
معمولاً در صورتی که فایلی به آن داده شود که بخشی از یک بسته باینری نباشد، پیامی را چاپ می‌کند.
این گزینه این پیام را بی‌صدا (سرکوب) می‌کند تا برنامه‌هایی مانند
\&\fBdpkg\fR
بتوانند بدون تولید پیام‌های اضافی و ناخواسته، با هر دو نوع بسته‌های تقسیم‌شده و تقسیم‌نشده کار کنند.
.IP \fB\-\-msdos\fR 4
.IX Item "--msdos"
گزینه منسوخ‌شده و بدون اثر (از dpkg 1.23.0).
.SH "وضعیت خروج (EXIT STATUS)"
.IX Header "وضعیت خروج (EXIT STATUS)"
.IP \fB0\fR 4
.IX Item "0"
تقسیم، ادغام یا دستور درخواستی دیگر با موفقیت انجام شد.
دستورهای
\&\fB\-\-info\fR
حتی اگر فایل‌ها بخش‌های بسته باینری نباشند نیز موفقیت‌آمیز محسوب می‌شوند.
.IP \fB1\fR 4
.IX Item "1"
فقط با
\&\fB\-\-auto\fR
رخ می‌دهد و نشان می‌دهد که فایل
\&\fIpart\fR
بخشی از یک بسته باینری نبوده است.
.IP \fB2\fR 4
.IX Item "2"
خطای مهلک یا غیرقابل برگشت به دلیل استفاده نادرست از خط فرمان، فایلی که شبیه به فایل بخش بسته بود اما خراب شده بود، یا تداخل در تعامل با سیستم، مانند دسترسی به پایگاه‌داده، تخصیص حافظه و غیره.
.SH "محیط (ENVIRONMENT)"
.IX Header "محیط (ENVIRONMENT)"
.IP \fBDPKG_ROOT\fR 4
.IX Item "DPKG_ROOT"
اگر تنظیم شده باشد و گزینه \fB\-\-root\fR مشخص نشده باشد،
به‌عنوان دایرکتوری ریشه سیستم فایل استفاده خواهد شد (از dpkg 1.21.10).
.IP \fBDPKG_ADMINDIR\fR 4
.IX Item "DPKG_ADMINDIR"
اگر تنظیم شده باشد و گزینه‌های \fB\-\-admindir\fR یا \fB\-\-root\fR مشخص نشده باشند،
به‌عنوان دایرکتوری داده‌های \fBdpkg\fR استفاده خواهد شد (از dpkg 1.21.10).
.IP \fBDPKG_DEBUG\fR 4
.IX Item "DPKG_DEBUG"
ماسک اشکال‌زدایی را از یک مقدار هشت‌هشتی (octal) تنظیم می‌کند (از dpkg 1.21.10).
فلگ‌های پذیرفته‌شده کنونی در گزینه \fBdpkg \-\-debug\fR شرح داده شده‌اند،
اما ممکن است همه این فلگ‌ها روی این برنامه تأثیری نداشته باشند.
.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.22.7).
مقادیر پذیرفته‌شده عبارتند از: \fB0\fR و \fB1\fR (پیش‌فرض).
.IP \fBSOURCE_DATE_EPOCH\fR 4
.IX Item "SOURCE_DATE_EPOCH"
اگر تنظیم شده باشد، به‌عنوان برچسب زمان (به‌صورت ثانیه‌ها از مبدا epoch) در
کانتینر \fBar\fR\|(5) مربوط به \fBdeb\-split\fR\|(5) استفاده خواهد شد.
.Sp
از dpkg 1.18.11.
.SH "فایل‌ها (FILES)"
.IX Header "فایل‌ها (FILES)"
.IP \fI/var/lib/dpkg/parts\fR 4
.IX Item "/var/lib/dpkg/parts"
دایرکتوری پیش‌فرض صف برای فایل‌های بخش در انتظار بازسازی خودکار.
.Sp
نام‌فایل‌های استفاده‌شده در این دایرکتوری در قالبی هستند که برای
\&\fBdpkg\-split\fR
داخلی است و بعید است برای سایر برنامه‌ها مفید باشد، و در هر صورت نباید به قالب نام‌فایل‌ها اتکا کرد.
.SH "امنیت (SECURITY)"
.IX Header "امنیت (SECURITY)"
بررسی یا اتصال آرشیو بسته‌های تقسیم‌شده غیرقابل اعتماد باید یک مرز امنیتی در نظر گرفته شود، و هرگونه شکستن این مرز ناشی از این عملیات باید یک آسیب‌پذیری امنیتی تلقی شود.
انجام این عملیات روی داده‌های غیرقابل اعتماد با کاربر ریشه (root) اکیداً منع می‌شود.
.PP
انباشت خودکار و دور ریختن بخش‌های بسته تقسیم‌شده عملیات ممتاز (دارای سطح دسترسی بالا) در نظر گرفته می‌شوند که ممکن است امکان ارتقای دسترسی به ریشه را فراهم کنند.
این عملیات هرگز نباید به یک کاربر غیرقابل اعتماد واگذار شود یا روی بسته‌های غیرقابل اعتماد انجام گیرد، زیرا ممکن است امکان دسترسی ریشه به سیستم را بدهد.
.PP
تقسیم آرشیو بسته‌ها باید فقط روی داده‌های قابل اعتماد انجام شود.
.SH "اشکالات (BUGS)"
.IX Header "اشکالات (BUGS)"
دریافت جزئیات کامل بسته‌های موجود در صف، بدون کاوش مستقیم در دایرکتوری صف غیرممکن است.
.PP
هیچ روش آسانی برای آزمایش این که آیا فایلی که ممکن است بخشی از یک بسته باینری باشد واقعاً چنین است یا خیر، وجود ندارد.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "همچنین ببینید (SEE ALSO)"
\&\fBdeb\fR\|(5),
\&\fBdeb\-control\fR\|(5),
\&\fBdpkg\-deb\fR\|(1),
\&\fBdpkg\fR\|(1).