'\" t
.TH "SYSTEMD\-DISSECT" "1" "" "systemd 261.2" "systemd-dissect"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
systemd-dissect, mount.ddi \- بازرسی، تشریح و مانت تصاویر دیسک سیستم‌عامل
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBsystemd\-dissect\fR\ 'u
\fBsystemd\-dissect\fR [OPTIONS...] \fIIMAGE\fR
.HP \w'\fBsystemd\-dissect\fR\ 'u
\fBsystemd\-dissect\fR [OPTIONS...] [\-\-mount] \fIIMAGE\fR \fIPATH\fR
.HP \w'\fBsystemd\-dissect\fR\ 'u
\fBsystemd\-dissect\fR [OPTIONS...] [\-\-umount] \fIPATH\fR
.HP \w'\fBsystemd\-dissect\fR\ 'u
\fBsystemd\-dissect\fR [OPTIONS...] [\-\-attach] \fIIMAGE\fR
.HP \w'\fBsystemd\-dissect\fR\ 'u
\fBsystemd\-dissect\fR [OPTIONS...] [\-\-detach] \fIPATH\fR
.HP \w'\fBsystemd\-dissect\fR\ 'u
\fBsystemd\-dissect\fR [OPTIONS...] [\-\-list] \fIIMAGE\fR
.HP \w'\fBsystemd\-dissect\fR\ 'u
\fBsystemd\-dissect\fR [OPTIONS...] [\-\-mtree] \fIIMAGE\fR
.HP \w'\fBsystemd\-dissect\fR\ 'u
\fBsystemd\-dissect\fR [OPTIONS...] [\-\-with] \fIIMAGE\fR [\fICOMMAND\fR...]
.HP \w'\fBsystemd\-dissect\fR\ 'u
\fBsystemd\-dissect\fR [OPTIONS...] [\-\-copy\-from] \fIIMAGE\fR \fIPATH\fR [\fITARGET\fR]
.HP \w'\fBsystemd\-dissect\fR\ 'u
\fBsystemd\-dissect\fR [OPTIONS...] [\-\-copy\-to] \fIIMAGE\fR [\fISOURCE\fR] \fIPATH\fR
.HP \w'\fBsystemd\-dissect\fR\ 'u
\fBsystemd\-dissect\fR [OPTIONS...] [\-\-make\-archive] \fIIMAGE\fR [\fITARGET\fR]
.HP \w'\fBsystemd\-dissect\fR\ 'u
\fBsystemd\-dissect\fR [OPTIONS...] [\-\-discover]
.HP \w'\fBsystemd\-dissect\fR\ 'u
\fBsystemd\-dissect\fR [OPTIONS...] [\-\-validate] \fIIMAGE\fR
.HP \w'\fBsystemd\-dissect\fR\ 'u
\fBsystemd\-dissect\fR [OPTIONS...] [\-\-shift] \fIIMAGE\fR \fIUIDBASE\fR
.SH "توضیحات (DESCRIPTION)"
.PP
\fBsystemd\-dissect\fR
ابزاری برای بازرسی، کالبدشکافی و تعامل با تصاویر دیسک سیستم‌عامل در سطح سیستم فایل، به ویژه «تصاویر دیسک قابل‌کشف» (Discoverable Disk Images یا DDIs) است\&. این ابزار از چهار عملیات مختلف پشتیبانی می‌کند:
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  1." 4.2
.\}
نمایش اطلاعات عمومی تصویر سیستم‌عامل، از جمله داده‌های
\fBos-release\fR(5)
تصویر، شناسه ماشین (machine ID)، اطلاعات پارتیشن‌ها و موارد دیگر\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  2." 4.2
.\}
مانت کردن یک تصویر سیستم‌عامل در یک دایرکتوری محلی\&. در این حالت، تصویر سیستم‌عامل را تشریح کرده و پارتیشن‌های موجود در آن را با توجه به کاربرد و شناسه آن‌ها بر روی یک دایرکتوری و احتمالاً زیردایرکتوری‌های آن مانت می‌کند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 3.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  3." 4.2
.\}
آن‌مانت کردن تصویر سیستم‌عامل از یک دایرکتوری محلی\&. در این حالت، پارتیشن‌های مانت‌شده را به صورت بازگشتی آن‌مانت کرده و دستگاه حلقه‌ای (loop device) زیرین را همراه با تمام زیردستگاه‌های پارتیشن آن حذف می‌کند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 4.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  4." 4.2
.\}
کپی کردن فایل‌ها و دایرکتوری‌ها به داخل و خارج از تصویر سیستم‌عامل\&.
.RE
.PP
این ابزار می‌تواند روی سه نوع تصویر سیستم‌عامل عمل کند:
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  1." 4.2
.\}
تصاویر دیسک سیستم‌عامل که شامل یک پوسته جدول پارتیشن GPT هستند و پارتیشن‌های آن‌ها مطابق با
\m[blue]\fBUAPI\&.2 Discoverable Partitions Specification\fR\m[]\&\s-2\u[1]\d\s+2
علامت‌گذاری شده‌اند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  2." 4.2
.\}
تصاویر دیسک سیستم‌عامل که صرفاً شامل یک سیستم فایل ساده بدون جدول پارتیشن پیرامونی هستند\&. (فرض می‌شود این سیستم فایل، سیستم فایل ریشه سیستم‌عامل است\&.)
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 3.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  3." 4.2
.\}
تصاویر دیسک سیستم‌عامل شامل جدول پارتیشن GPT یا MBR که تنها یک پارتیشن منفرد دارند\&. (فرض می‌شود این پارتیشن حاوی سیستم فایل ریشه سیستم‌عامل است\&.)
.RE
.PP
تصاویر سیستم‌عامل ممکن است از هر نوع سیستم فایل پشتیبانی‌شده در لینوکس استفاده کنند\&. علاوه بر این، ممکن است از رمزنگاری دیسک LUKS استفاده نمایند و حاوی اطلاعات یکپارچگی Verity باشند\&. توجه داشته باشید که تصاویر سیستم‌عامل واجد شرایط را می‌توان با سوییچ
\fB\-\-image=\fR
دستور
\fBsystemd-nspawn\fR(1)
بوت کرد، و با استفاده از تنظیم
\fIRootImage=\fR
در فایل واحد (unit file) به عنوان سیستم فایل ریشه برای سرویس‌های سیستمی استفاده نمود؛
\fBsystemd.exec\fR(5)
را ببینید\&.
.PP
توجه داشته باشید که جدول پارتیشن نمایش‌داده‌شده هنگام فراخوانی بدون سوییچ دستور (همان‌طور که در زیر فهرست شده است) لزوماً همه پارتیشن‌های موجود در تصویر را نشان نمی‌دهد، بلکه صرفاً پارتیشن‌هایی را نمایش می‌دهد که شناخته شده‌اند و بخشی از تصویر دیسک سیستم‌عامل به شمار می‌روند\&. به طور خاص، پارتیشن‌های با نوع ناشناخته و همچنین پارتیشن‌های تکراری (یعنی بیش از یک مورد برای هر نوع پارتیشن) نادیده گرفته می‌شوند، همان‌طور که پارتیشن‌های ریشه و
/usr/
مربوط به معماری‌هایی که با سیستم محلی ناسازگارند نادیده گرفته می‌شوند\&. به عبارت دیگر: این ابزار مواردی را نمایش می‌دهد که هنگام مانت کردن تصویر با آن‌ها کار می‌کند\&. برای نمایش فهرست کامل پارتیشن‌ها از ابزاری مانند
\fBfdisk\fR(8)
استفاده کنید\&.
.PP
دستور
\fBsystemd\-dissect\fR
می‌تواند به عنوان
\fBmount\&.ddi\fR
نیز فراخوانی شود که در این صورت رابط "کمک‌کننده خارجی" (external helper) دستور
\fBmount\fR(8)
را پیاده‌سازی می‌کند\&. این ویژگی تضمین می‌کند که تصاویر دیسک سازگار با
\fBsystemd\-dissect\fR
را می‌توان مستقیماً توسط
\fBmount\fR
و
\fBfstab\fR(5)
مانت کرد\&. برای جزئیات، بخش‌های زیر را ببینید\&.
.PP
به جای مسیر تصویر، می‌توان یک دایرکتوری نسخه‌بندی‌شده
"\&.v/"
را مشخص کرد؛ برای جزئیات
\fBsystemd.v\fR(7)
را ببینید\&.
.SH "دستورات (COMMANDS)"
.PP
اگر هیچ‌یک از سوییچ‌های دستور فهرست‌شده در زیر ارسال نشوند، تصویر دیسک مشخص‌شده باز می‌شود و اطلاعات عمومی درباره تصویر، پارتیشن‌های موجود در آن و نحوه استفاده از آن‌ها نمایش داده می‌شود\&.
.PP
\fB\-\-mount\fR, \fB\-m\fR
.RS 4
تصویر سیستم‌عامل مشخص‌شده را در دایرکتوری تعیین‌شده مانت می‌کند\&. این کار تصویر را کالبدشکافی کرده، سیستم فایل ریشه سیستم‌عامل \(em و احتمالاً سایر پارتیشن‌ها را \(em شناسایی می‌کند و آن‌ها را در دایرکتوری مشخص‌شده مانت می‌نماید\&. اگر تصویر سیستم‌عامل شامل چندین پارتیشن باشد که مطابق با
\m[blue]\fBUAPI\&.2 Discoverable Partitions Specification\fR\m[]\&\s-2\u[1]\d\s+2
علامت‌گذاری شده‌اند، چندین مانت تودرتو برقرار می‌شود\&. این دستور به دو آرگومان نیاز دارد: یک مسیر به فایل تصویر و یک مسیر به دایرکتوری که تصویر باید در آن مانت شود\&.
.sp
برای آن‌مانت کردن تصویر سیستم‌عاملی که به این شکل مانت شده است، از عملیات
\fB\-\-umount\fR
استفاده کنید\&.
.sp
هنگامی که تصویر سیستم‌عامل حاوی سیستم‌های فایل رمزنگاری‌شده با LUKS یا محافظت‌شده با اعتبارسنجی یکپارچگی Verity باشد، حجم‌های مناسب به طور خودکار راه‌اندازی می‌شوند و برای جداسازی و غیرفعال‌سازی خودکار هنگام آن‌مانت شدن تصویر علامت‌گذاری می‌گردند\&.
.sp
تصویر سیستم‌عامل می‌تواند به عنوان مسیر یک فایل معمولی حاوی تصویر، یا به عنوان یک گره دستگاه بلوکی مشخص شود (در حالت دوم، دستگاه بلوکی باید دستگاه "کامل" باشد، یعنی دستگاه یک پارتیشن نباشد)\&. (سایر دستورات پشتیبانی‌شده که در اینجا توضیح داده شده‌اند نیز از این قابلیت پشتیبانی می‌کنند)\&.
.sp
تمامی سیستم‌های فایل مانت‌شده با پیاده‌سازی مناسب
\fBfsck\fR(8)
در حالت تعمیر خودکار بررسی می‌شوند، مگر اینکه به صراحت خاموش شده باشد (\fB\-\-fsck=no\fR) یا عملیات فقط‌خواندنی درخواست شده باشد (\fB\-\-read\-only\fR)\&.
.sp
توجه داشته باشید که این قابلیت در
\fBmount\fR(8)
نیز از طریق دستوری مانند
\fBmount \-t ddi myimage\&.raw targetdir/\fR،
و همچنین در
\fBfstab\fR(5)
در دسترس است\&. برای جزئیات، بخش‌های زیر را ببینید\&.
.sp
در نسخه 247 اضافه شد\&.
.RE
.PP
\fB\-M\fR
.RS 4
یک میانبر برای
\fB\-\-mount \-\-mkdir\fR
است\&.
.sp
در نسخه 247 اضافه شد\&.
.RE
.PP
\fB\-\-umount\fR, \fB\-u\fR
.RS 4
آن‌مانت کردن تصویر سیستم‌عامل از دایرکتوری مشخص‌شده\&. این دستور به یک آرگومان نیاز دارد: دایرکتوری‌ای که تصویر سیستم‌عامل در آن مانت شده است\&.
.sp
تمام پارتیشن‌های مانت‌شده به صورت بازگشتی آن‌مانت خواهند شد و دستگاه حلقه‌ای (loop device) زیرین همراه با تمام زیردستگاه‌های پارتیشن آن حذف می‌شود\&.
.sp
در نسخه 252 اضافه شد\&.
.RE
.PP
\fB\-U\fR
.RS 4
یک میانبر برای
\fB\-\-umount \-\-rmdir\fR
است\&.
.sp
در نسخه 252 اضافه شد\&.
.RE
.PP
\fB\-\-attach\fR
.RS 4
تصویر دیسک مشخص‌شده را به یک دستگاه بلوکی لوپ‌بک با تخصیص خودکار متصل می‌کند، و مسیر دستگاه بلوکی لوپ‌بک را در خروجی استاندارد چاپ می‌نماید\&. این شبیه به فراخوانی
\fBlosetup \-\-find \-\-show \-\-partscan\fR
است، اما تصویر را پیش از اتصال به عنوان DDI اعتبارسنجی می‌کند و اندازه سکتور مناسب را به صورت خودکار به دست می‌آورد\&. علاوه بر این، اطمینان حاصل می‌کند که دستگاه‌های بلوکی مربوط به هر پارتیشن قبل از بازگشت دستور ایجاد شده‌اند و در صورت امکان سعی می‌کند حالت ورودی/خروجی مستقیم (direct IO) را فعال کند\&. مسیر یک فایل تصویر دیسک را به عنوان ورودی می‌گیرد\&.
.sp
اگر با
\fB\-\-quiet\fR
ترکیب شود، خروجی نام دستگاه بلوکی سرکوب می‌شود\&.
.sp
در نسخه 254 اضافه شد\&.
.RE
.PP
\fB\-\-detach\fR
.RS 4
تصویر دیسک مشخص‌شده را از دستگاه بلوکی لوپ‌بک جدا می‌کند\&. این کار اثر
\fB\-\-attach\fR
در بالا را لغو می‌کند\&. این دستور یا مسیر یک دستگاه بلوکی لوپ‌بک را به عنوان آرگومان می‌پذیرد یا مسیر فایل تصویر پشتیبان را\&. در حالت دوم، به طور خودکار دستگاه مناسب برای جداسازی را شناسایی می‌کند\&.
.sp
در نسخه 254 اضافه شد\&.
.RE
.PP
\fB\-\-list\fR, \fB\-l\fR
.RS 4
مسیرهای تمام فایل‌ها و دایرکتوری‌های موجود در تصویر سیستم‌عامل یا دایرکتوری مشخص‌شده را در خروجی استاندارد چاپ می‌کند\&.
.sp
در نسخه 253 اضافه شد\&.
.RE
.PP
\fB\-\-mtree\fR
.RS 4
یک مانیفست فایل سازگار با
\fBmtree\fR(8)
سیستم BSD از تصویر دیسک یا دایرکتوری مشخص‌شده تولید می‌کند\&. این ویژگی برای مقایسه دقیق محتویات تصویر، از جمله اطلاعات اینود (inode) و سایر متادیتاها مفید است\&. گرچه مانیفست تولیدشده حاوی اطلاعات دقیق اینود خواهد بود، اما در حال حاضر ویژگی‌های گسترش‌یافته، قابلیت‌های سیستم فایل، برچسب‌های MAC، فلگ‌های فایل
\fBchattr\fR(1)،
اطلاعات زیرحجم
\fBbtrfs\fR(5)،
و متادیتاهای مختلف دیگر فایل را در بر نمی‌گیرد\&. اطلاعات محتوای فایل از طریق شناسه خلاصه SHA256 نشان داده می‌شود\&. ممکن است فیلدهای اضافی در آینده اضافه شوند\&. توجه داشته باشید که اطلاعات اینود مانند تعداد پیوندها، شماره‌های اینود و برچسب‌های زمانی عمداً از خروجی حذف شده‌اند، زیرا معمولاً قابلیت بازتولیدپذیری را پیچیده می‌کنند\&.
.sp
در نسخه 253 اضافه شد\&.
.RE
.PP
\fB\-\-with\fR
.RS 4
دستور مشخص‌شده را در حالی که تصویر سیستم‌عامل مانت شده است اجرا می‌کند\&. این دستور تصویر را در یک دایرکتوری موقت مانت کرده، دایرکتوری کاری فعلی را به آن تغییر می‌دهد، و خط فرمان مشخص‌شده را به عنوان یک فرآیند فرزند اجرا می‌نماید\&. پس از پایان فرآیند، تصویر را دوباره آن‌مانت کرده و دایرکتوری موقت را حذف می‌کند\&. اگر دستوری مشخص نشود، یک پوسته اجرا می‌شود\&. تصویر به صورت قابل‌نوشتن مانت می‌شود؛ برای تغییر به عملیات فقط‌خواندنی از
\fB\-\-read\-only\fR
استفاده کنید\&. در فرآیند فراخوانی‌شده، متغیر محیطی
\fI$SYSTEMD_DISSECT_ROOT\fR
تنظیم خواهد شد که حاوی نام مسیر مطلق نقطه مانت موقت است، یعنی همان دایرکتوری که به عنوان دایرکتوری کاری فعلی تنظیم شده است\&. همچنین متغیر محیطی
\fI$SYSTEMD_DISSECT_DEVICE\fR
تنظیم خواهد شد که شامل مسیر مطلق دستگاه لوپ است که تصویر به آن متصل شده است\&.
.sp
در نسخه 253 اضافه شد\&.
.RE
.PP
\fB\-\-copy\-from\fR, \fB\-x\fR
.RS 4
یک فایل یا دایرکتوری را از تصویر سیستم‌عامل یا دایرکتوری مشخص‌شده به مکان تعیین‌شده در سیستم فایل میزبان کپی می‌کند\&. به سه آرگومان نیاز دارد: مسیر یک فایل تصویر یا دایرکتوری، یک مسیر مبدا (نسبت به دایرکتوری ریشه تصویر) و یک مسیر مقصد (نسبت به دایرکتوری کاری فعلی، یا یک مسیر مطلق، که هر دو در خارج از تصویر قرار دارند)\&. اگر مسیر مقصد حذف شود یا به عنوان خط تیره ("\-") مشخص گردد، فایل مشخص‌شده در خروجی استاندارد نوشته می‌شود\&. اگر مسیر مبدا در سیستم فایل تصویر به یک فایل معمولی اشاره کند، به مسیر مقصد کپی می‌شود\&. در این حالت، حالت دسترسی، ویژگی‌های گسترش‌یافته و برچسب‌های زمانی نیز کپی می‌شوند، اما مالکیت فایل کپی نمی‌شود\&. اگر مسیر مبدا در تصویر به یک دایرکتوری اشاره کند، به همراه تمام فایل‌ها و دایرکتوری‌های درون آن به صورت بازگشتی در مسیر مقصد کپی می‌شود، در دایرکتوری‌های موجود ادغام می‌گردد و فایل‌های موجود به‌روزرسانی می‌شوند\&. در این حالت، مالکیت فایل نیز کپی می‌شود\&.
.sp
در نسخه 247 اضافه شد\&.
.RE
.PP
\fB\-\-copy\-to\fR, \fB\-a\fR
.RS 4
یک فایل یا دایرکتوری را از مکان مشخص‌شده در سیستم فایل میزبان به داخل تصویر سیستم‌عامل یا دایرکتوری تعیین‌شده کپی می‌کند\&. به سه آرگومان نیاز دارد: مسیر یک فایل تصویر یا دایرکتوری، یک مسیر مبدا (نسبت به دایرکتوری کاری فعلی، یا یک مسیر مطلق، که هر دو در خارج از تصویر هستند) و یک مسیر مقصد (نسبت به دایرکتوری ریشه تصویر)\&. اگر مسیر مبدا حذف شود یا به عنوان خط تیره ("\-") مشخص گردد، داده‌های مورد نظر برای نوشتن از ورودی استاندارد خوانده می‌شوند\&. اگر مسیر مبدا در سیستم فایل میزبان به یک فایل معمولی اشاره کند، به مسیر مقصد کپی می‌شود\&. در این حالت، حالت دسترسی، ویژگی‌های گسترش‌یافته و برچسب‌های زمانی نیز کپی می‌شوند، اما مالکیت فایل کپی نمی‌شود\&. اگر مسیر مبدا در سیستم فایل میزبان به یک دایرکتوری اشاره کند، به همراه تمام فایل‌ها و دایرکتوری‌های موجود در آن به صورت بازگشتی در مسیر مقصد کپی می‌شود، در دایرکتوری‌های موجود ادغام می‌گردد و فایل‌های موجود را به‌روزرسانی می‌کند\&. در این حالت، مالکیت فایل نیز کپی می‌شود\&.
.sp
همانند
\fB\-\-mount\fR،
بررسی‌های سیستم فایل پیش از شروع عملیات کپی به صورت ضمنی اجرا می‌شوند\&.
.sp
در نسخه 247 اضافه شد\&.
.RE
.PP
\fB\-\-make\-archive\fR
.RS 4
یک فایل آرشیو از تصویر دیسک مشخص‌شده تولید می‌کند\&. به دو آرگومان نیاز دارد: مسیر تصویر دیسک و به صورت اختیاری مسیر فایل آرشیو خروجی\&. در صورت حذف مورد دوم، آرشیو در خروجی استاندارد نوشته می‌شود\&. قالب فایل آرشیو به طور خودکار بر اساس نام فایل آرشیو خروجی مشخص‌شده تعیین می‌شود؛ برای مثال، هر مسیری با پسوند
"\&.tar\&.xz"
منجر به یک تاربال یونیکس فشرده‌شده با xz خواهد شد (اگر مسیر حذف شود، یک تاربال یونیکس فشرده‌نشده ایجاد می‌شود)\&. برای فهرستی از قالب‌های آرشیو و روش‌های فشرده‌سازی پشتیبانی‌شده،
\fBlibarchive\fR(3)
را ببینید\&.
.sp
در نسخه 256 اضافه شد\&.
.RE
.PP
\fB\-\-discover\fR
.RS 4
فهرستی از DDIها را در دایرکتوری‌های شناخته‌شده نمایش می‌دهد\&. این دستور تصاویر دیسک مربوط به ماشین‌ها، سرویس‌های قابل‌حمل (portable services) و افزونه‌های پیکربندی/سیستمی را در دایرکتوری‌های معمول
/usr/lib/machines/،
/usr/lib/portables/،
/usr/lib/confexts/،
/var/lib/machines/،
/var/lib/portables/،
/var/lib/extensions/
و غیره نمایش می‌دهد\&.
.sp
در نسخه 253 اضافه شد\&.
.RE
.PP
\fB\-\-validate\fR
.RS 4
آرایش پارتیشن‌های یک تصویر دیسک (DDI) را اعتبارسنجی می‌کند و اطمینان حاصل می‌نماید که با سیاست تصویر مشخص‌شده از طریق
\fB\-\-image\-policy=\fR
(در صورت تعیین شدن) مطابقت دارد\&. این دستور جدول پارتیشن را تجزیه کرده و سیستم‌های فایل موجود در تصویر را کاوش می‌کند، اما تلاشی برای مانت کردن آن‌ها انجام نمی‌دهد (و همچنین رمزنگاری/احراز هویت دیسک را از طریق LUKS/Verity راه‌اندازی نمی‌کند)\&. این عمل با در نظر گرفتن سیاست تشریح تصویر پیکربندی‌شده انجام می‌شود\&. از آنجا که این عملیات سیستم‌های فایل را مانت نمی‌کند، این دستور \(em برخلاف سایر دستورات پیاده‌سازی‌شده توسط این ابزار \(em به هیچ مجوزی به جز توانایی دسترسی به فایل مشخص‌شده نیاز ندارد\&. در صورتی که تصویر به نظر درست برسد و با سیاست تشریح تصویر مشخص‌شده مطابقت داشته باشد، "OK" را چاپ کرده و صفر برمی‌گرداند\&. در غیر این صورت، یک پیام خطا چاپ کرده و مقداری غیر صفر برمی‌گرداند\&.
.sp
در نسخه 254 اضافه شد\&.
.RE
.PP
\fB\-\-shift\fR
.RS 4
به صورت بازگشتی تمام اینودهای تصویر مشخص‌شده را پیمایش می‌کند و شناسه‌های UID و GID که اینودها متعلق به آن‌ها هستند را به محدوده UID مشخص‌شده تغییر می‌دهد\&. یک مسیر تصویر و یک پایه UID را به عنوان پارامتر می‌گیرد\&. پایه UID می‌تواند به صورت عددی مشخص شود (که در این صورت باید مضربی از 65536 باشد و صفر یا در محدوده UID کانتینر یا UID بیگانه باشد، مطابق با
\m[blue]\fBUsers, Groups, UIDs and GIDs on systemd Systems\fR\m[]\&\s-2\u[2]\d\s+2)،
یا به عنوان شناسه نمادین
"foreign"
که یک نام کوتاه برای پایه UID بیگانه است\&. این دستور برای آماده‌سازی تصاویر کانتینری دایرکتوری به منظور استفاده بدون امتیاز مفید است\&. توجه داشته باشید که این دستور فقط برای تصاویری در نظر گرفته شده است که از محدوده 16 بیتی UIDها/GIDها استفاده می‌کنند، و همیشه 16 بیت بالایی مالکیت فعلی UID/GID را نادیده می‌گیرد و 16 بیت پایینی را با پایه UID هدف ترکیب می‌کند\&.
.sp
از
\fBsystemd\-dissect \-\-shift /some/container/tree foreign\fR
برای شیفت دادن تصویر کانتینر به محدوده UID بیگانه، یا از
\fBsystemd\-dissect \-\-shift /some/container/tree 0\fR
برای شیفت دادن آن به محدوده UID میزبان استفاده کنید\&.
.sp
در نسخه 258 اضافه شد\&.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
یک متن راهنمای کوتاه را چاپ کرده و خارج می‌شود\&.
.RE
.PP
\fB\-\-version\fR
.RS 4
یک رشته کوتاه نسخه را چاپ کرده و خارج می‌شود\&.
.RE
.SH "گزینه‌ها (OPTIONS)"
.PP
گزینه‌های زیر پشتیبانی می‌شوند:
.PP
\fB\-\-read\-only\fR, \fB\-r\fR
.RS 4
کار در حالت فقط‌خواندنی\&. به طور پیش‌فرض،
\fB\-\-mount\fR
نقاط مانت را به صورت قابل‌نوشتن برقرار می‌کند\&. در صورت مشخص شدن این گزینه، در عوض در حالت فقط‌خواندنی برقرار خواهند شد\&.
.sp
در نسخه 247 اضافه شد\&.
.RE
.PP
\fB\-\-fsck=no\fR
.RS 4
بررسی خودکار سیستم فایل را خاموش می‌کند\&. به طور پیش‌فرض، هنگامی که به یک تصویر برای نوشتن دسترسی پیدا می‌شود (توسط
\fB\-\-mount\fR
یا
\fB\-\-copy\-to\fR)،
سیستم‌های فایل موجود در تصویر سیستم‌عامل به طور خودکار با استفاده از دستور مناسب
\fBfsck\fR(8)،
در حالت تعمیر خودکار بررسی می‌شوند\&. این رفتار را می‌توان با استفاده از
\fB\-\-fsck=no\fR
خاموش کرد\&.
.sp
در نسخه 247 اضافه شد\&.
.RE
.PP
\fB\-\-growfs=no\fR
.RS 4
افزایش خودکار اندازه سیستم‌های فایلِ مورداستفاده به اندازه پارتیشن آن‌ها را خاموش می‌کند، در صورتی که در جدول پارتیشن GPT برای این کار علامت‌گذاری شده باشند\&. به طور پیش‌فرض، هنگامی که به یک تصویر برای نوشتن دسترسی پیدا می‌شود (توسط
\fB\-\-mount\fR
یا
\fB\-\-copy\-to\fR)،
سیستم‌های فایل موجود در تصویر سیستم‌عامل به طور خودکار به اندازه پارتیشن‌هایشان گسترش می‌یابند، در صورتی که بیت 59 در فلگ‌های پارتیشن GPT برای نوع پارتیشن‌های تعریف‌شده توسط
\m[blue]\fBUAPI\&.2 Discoverable Partitions Specification\fR\m[]\&\s-2\u[1]\d\s+2
تنظیم شده باشد\&. این رفتار را می‌توان با استفاده از
\fB\-\-growfs=no\fR
خاموش کرد\&. سیستم‌های فایل در هنگام دسترسی به طور خودکار افزایش اندازه می‌یابند در صورتی که همه شرایط زیر برقرار باشند:
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  1." 4.2
.\}
سیستم فایل به صورت قابل‌نوشتن مانت شده باشد
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  2." 4.2
.\}
سیستم فایل در حال حاضر از پارتیشنی که در آن قرار دارد کوچکتراست (و بنابراین امکان گسترش دارد)
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 3.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  3." 4.2
.\}
تصویر حاوی جدول پارتیشن GPT باشد
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 4.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  4." 4.2
.\}
سیستم فایل روی پارتیشنی ذخیره شده باشد که توسط Discoverable Partitions Specification تعریف شده است
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 5.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  5." 4.2
.\}
بیت 59 فلگ‌های پارتیشن GPT برای این پارتیشن طبق مشخصات تنظیم شده باشد
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 6.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  6." 4.2
.\}
گزینه
\fB\-\-growfs=no\fR
ارسال نشده باشد\&.
.RE
.sp
در نسخه 249 اضافه شد\&.
.RE
.PP
\fB\-\-mkdir\fR
.RS 4
در صورت ترکیب با
\fB\-\-mount\fR،
دایرکتوری مقصد برای مانت کردن تصویر سیستم‌عامل در صورت عدم وجود ایجاد می‌شود\&. توجه داشته باشید که دایرکتوری پس از آن‌مانت شدن مجدد تصویر دیسک به طور خودکار حذف نمی‌شود\&.
.sp
در نسخه 247 اضافه شد\&.
.RE
.PP
\fB\-\-rmdir\fR
.RS 4
در صورت ترکیب با
\fB\-\-umount\fR،
دایرکتوری مشخص‌شده‌ای که تصویر سیستم‌عامل در آن مانت شده بود پس از آن‌مانت کردن تصویر حذف می‌شود\&.
.sp
در نسخه 252 اضافه شد\&.
.RE
.PP
\fB\-\-discard=\fR
.RS 4
یکی از مقادیر
"disabled"،
"loop"،
"all"،
"crypto"
را می‌پذیرد\&. اگر
"disabled"
باشد، دسترسی به تصویر با غیرفعال بودن آزادسازی بلوک‌های خالی انجام می‌شود\&. اگر
"loop"
باشد، آزادسازی در صورت کار بر روی یک فایل معمولی فعال می‌گردد\&. اگر
"crypt"
باشد، آزادسازی حتی روی سیستم‌های فایل رمزنگاری‌شده نیز فعال می‌شود\&. اگر
"all"
باشد، آزادسازی به صورت بدون قید و شرط فعال می‌گردد\&.
.sp
در نسخه 247 اضافه شد\&.
.RE
.PP
\fB\-\-in\-memory\fR
.RS 4
در صورت تعیین شدن، از یک کپی در حافظه از تصویر دیسک مشخص‌شده استفاده می‌شود\&. این گزینه می‌تواند برای کار با دسترسی نوشتن روی یک تصویر (احتمالاً فقط‌خواندنی) استفاده شود، بدون اینکه فایل اصلی تغییر کند\&. همچنین می‌توان از این گزینه برای کار روی یک تصویر دیسک استفاده کرد بدون اینکه سیستم فایل مبدا مشغول نگه داشته شود، تا امکان آن‌مانت کردن آن فراهم گردد\&.
.sp
در نسخه 253 اضافه شد\&.
.RE
.PP
\fB\-\-root\-hash=\fR, \fB\-\-root\-hash\-sig=\fR, \fB\-\-verity\-data=\fR
.RS 4
جنبه‌های مختلف یکپارچگی داده‌های Verity را برای تصویر سیستم‌عامل پیکربندی می‌کند\&. گزینه
\fB\-\-root\-hash=\fR
یک هش Verity سطح‌بالای هگزادسیمال را برای راه‌اندازی حفاظت یکپارچگی Verity مشخص می‌کند\&. گزینه
\fB\-\-root\-hash\-sig=\fR
مسیر فایلی حاوی یک امضای PKCS#7 برای هش را مشخص می‌نماید\&. این امضا هنگام فعال‌سازی به هسته ارسال می‌شود، و هسته آن را با کلیدهای امضای موجود در دسته‌کلید هسته تطبیق می‌دهد\&. گزینه
\fB\-\-verity\-data=\fR
مسیری را به فایلی حاوی داده‌های Verity برای استفاده در تصویر سیستم‌عامل مشخص می‌کند، در صورتی که در یک فایل جداگانه ذخیره شده باشد\&. توصیه می‌شود داده‌های Verity با استفاده از سازوکارهای Verity در
\m[blue]\fBUAPI\&.2 Discoverable Partitions Specification\fR\m[]\&\s-2\u[1]\d\s+2
مستقیماً در داخل تصویر تعبیه شوند\&.
.sp
در نسخه 247 اضافه شد\&.
.RE
.PP
\fB\-\-usr\-hash=\fR, \fB\-\-usr\-hash\-sig=\fR
.RS 4
مشابه
\fB\-\-root\-hash=\fR
و
\fB\-\-root\-hash\-sig=\fR
است، اما هش و امضا را برای پارتیشن
/usr/
مشخص می‌کند\&. توجه داشته باشید که می‌توان گزینه‌های مربوط به پارتیشن ریشه یا گزینه‌های مربوط به
/usr/
را استفاده کرد، اما استفاده همزمان از هر دو مجاز نیست\&.
.sp
در نسخه 258 اضافه شد\&.
.RE
.PP
\fB\-\-loop\-ref=\fR
.RS 4
رشته "مرجع" (reference) را که هسته باید به عنوان فایل پشتیبان برای دستگاه بلوکی لوپ‌بک گزارش کند، پیکربندی می‌نماید\&. گرچه فرض بر این است که این رشته یک مسیر یا نام فایل ارجاع‌دهنده به فایل پشتیبان باشد، اما این امر الزامی نیست و هسته رشته‌های دلخواه با قالب آزاد را که توسط کاربر انتخاب شده باشند می‌پذیرد\&. رشته‌های دلخواه تا طول 63 کاراکتر را می‌پذیرد\&. این تنظیم، فیلد
"\&.lo_file_name"
هسته را برای دستگاه بلوکی تنظیم می‌کند\&. توجه داشته باشید که این مورد با فایل ویژگی
/sys/class/block/loopX/loop/backing_file
که همیشه مسیری ارجاع‌دهنده به فایل پشتیبان واقعی را گزارش می‌دهد تفاوت دارد\&. دومی مشمول ترجمه فضای‌نام مانت است، در حالی که اولی این‌طور نیست\&.
.sp
این تنظیم به ویژه در ترکیب با دستور
\fB\-\-attach\fR
بسیار مفید است، زیرا امکان ارجاع بعدی به دستگاه لوپ تخصیص‌یافته را از طریق پیوندهای نمادین
/dev/disk/by\-loop\-ref/\&...
فراهم می‌سازد\&. مثال: ابتدا دستگاه لوپ‌بک را از طریق
\fBsystemd\-dissect attach \-\-loop\-ref=quux foo\&.raw\fR
راه‌اندازی کنید، و سپس در یک دستور از طریق نام فایل مشخص‌شده به آن ارجاع دهید:
\fBcfdisk /dev/disk/by\-loop\-ref/quux\fR\&.
.sp
در نسخه 254 اضافه شد\&.
.RE
.PP
\fB\-\-loop\-ref\-auto\fR
.RS 4
مشابه
\fB\-\-loop\-ref=\fR
است، اما رشته مرجع را به طور خودکار از نام فایل پشتیبان مشخص‌شده استخراج می‌کند و در صورت نیاز آن را کوتاه می‌نماید\&.
.sp
در نسخه 258 اضافه شد\&.
.RE
.PP
\fB\-\-mtree\-hash=no\fR
.RS 4
اگر با
\fB\-\-mtree\fR
ترکیب شود، گنجاندن هش فایل‌ها را در خروجی mtree خاموش می‌کند\&. این امر باعث می‌شود دستور
\fB\-\-mtree\fR
هنگام کار روی تصاویر حجیم سریع‌تر عمل کند\&.
.sp
در نسخه 254 اضافه شد\&.
.RE
.PP
\fB\-\-copy\-ownership=\fR
.RS 4
کنترل می‌کند که آیا هنگام کپی کردن فایل‌ها با
\fB\-\-copy\-from\fR
یا
\fB\-\-copy\-to\fR،
مالکیت فایل (کاربر و گروه) حفظ شود یا خیر\&. یک مقدار بولی یا
\fBauto\fR
می‌پذیرد\&. اگر
"yes"
باشد، مالکیت همیشه حفظ می‌شود\&. اگر
"no"
باشد، مالکیت هرگز حفظ نمی‌شود و به جای آن از UID/GID کاربر فعلی استفاده می‌گردد\&. اگر مشخص نشود یا برابر با
\fBauto\fR
باشد، مالکیت هنگام کپی کردن درخت‌های دایرکتوری حفظ می‌شود، اما هنگام کپی کردن فایل‌های معمولی تکی حفظ نخواهد شد\&.
.sp
در نسخه 260 اضافه شد\&.
.RE
.PP
\fB\-\-system\fR, \fB\-\-user\fR
.RS 4
هنگامی که همراه با
\fB\-\-discover\fR
استفاده شوند، کنترل می‌کنند که آیا جستجوی تصاویر به صورت سراسری در کل سیستم انجام شود یا در دایرکتوری‌های کاربر در
\fI$HOME\fR\&.
اگر هیچ‌یک از سوییچ‌ها مشخص نشوند، در هر دو دامنه جستجو خواهد شد\&.
.sp
در نسخه 258 اضافه شد\&.
.RE
.PP
\fB\-\-all\fR
.RS 4
اگر با
\fB\-\-discover\fR
ترکیب شود، تصاویری را که با یک نقطه شروع می‌شوند (یعنی تصاویر پنهان) نیز نمایش می‌دهد\&.
.sp
در نسخه 258 اضافه شد\&.
.RE
.PP
\fB\-\-quiet\fR, \fB\-q\fR
.RS 4
در صورت ترکیب با
\fB\-\-attach\fR،
چاپ مسیر دستگاه بلوکی لوپ‌بک استفاده‌شده را سرکوب می‌کند\&.
.sp
در نسخه 258 اضافه شد\&.
.RE
.PP
\fB\-\-image\-policy=\fR\fB\fIpolicy\fR\fR
.RS 4
یک رشته سیاست تصویر را مطابق با
\fBsystemd.image-policy\fR(7)
به عنوان آرگومان می‌گیرد\&. این سیاست هنگام کار بر روی تصویر دیسک مشخص‌شده از طریق
\fB\-\-image=\fR
اعمال می‌شود؛ بالا را ببینید\&. اگر مشخص نشود، به طور پیش‌فرض روی سیاست
"*"
تنظیم می‌گردد، یعنی تمام سیستم‌های فایل شناخته‌شده در تصویر استفاده می‌شوند\&.
.RE
.PP
\fB\-\-image\-filter=\fR\fB\fIfilter\fR\fR
.RS 4
یک رشته فیلتر تصویر را مطابق با
\fBsystemd.image-filter\fR(7)
به عنوان آرگومان می‌گیرد\&. این فیلتر هنگام کار روی تصویر دیسک مشخص‌شده از طریق
\fB\-\-image=\fR
مد نظر قرار می‌گیرد؛ بالا را ببینید\&. اگر مشخص نشود، هیچ فیلتری اعمال نخواهد شد\&.
.RE
.PP
\fB\-\-no\-pager\fR
.RS 4
خروجی را به یک صفحه‌بند (pager) هدایت نمی‌کند\&.
.RE
.PP
\fB\-\-no\-legend\fR
.RS 4
راهنما (legend) را چاپ نمی‌کند، یعنی سرستون‌ها و پاورقی حاوی نکات توضیحی حذف می‌شوند\&.
.RE
.PP
\fB\-\-json=\fR\fB\fIMODE\fR\fR
.RS 4
خروجی را با فرمت JSON نمایش می‌دهد\&. یکی از مقادیر
"short"
(برای کوتاه‌ترین خروجی ممکن بدون فاصله‌ها یا خطوط خالی اضافی)،
"pretty"
(برای نسخه خوانا با تورفتگی و شکستن خطوط) یا
"off"
(برای خاموش کردن خروجی JSON، که حالت پیش‌فرض است) را می‌پذیرد\&.
.RE
.SH "کدهای خروج (EXIT STATUS)"
.PP
در صورت موفقیت، 0 برگردانده می‌شود، و در غیر این صورت یک کد خطای غیر صفر\&. اگر از دستور
\fB\-\-with\fR
استفاده شود، کد خروج دستور فراخوانی‌شده بازگردانده می‌شود\&.
.SH "فراخوانی به‌صورت /sbin/mount.ddi (INVOCATION AS /SBIN/MOUNT\&.DDI)"
.PP
فایل اجرایی
\fBsystemd\-dissect\fR
می‌تواند به
/sbin/mount\&.ddi
پیوند نمادین داده شود\&. اگر از این طریق فراخوانی شود، رابط "کمک‌کننده خارجی" دستور
\fBmount\fR(8)
را برای نوع شبه‌سیستم‌فایل
"ddi"
پیاده‌سازی می‌کند\&. این بدان معناست که تصاویر دیسک سازگار را می‌توان مستقیماً از طریق
.sp
.if n \{\
.RS 4
.\}
.nf
# mount \-t ddi myimage\&.raw targetdir/
.fi
.if n \{\
.RE
.\}
.PP
به روشی که تا حد زیادی معادل دستور زیر است، مانت کرد:
.sp
.if n \{\
.RS 4
.\}
.nf
# systemd\-dissect \-\-mount myimage\&.raw targetdir/
.fi
.if n \{\
.RE
.\}
.PP
توجه داشته باشید از آنجا که یک DDI منفرد ممکن است حاوی چندین سیستم فایل باشد، بعداً باید با دستور
\fBumount \-R targetdir/\fR
آن‌مانت شود تا عملیات به صورت بازگشتی انجام گیرد\&.
.PP
این قابلیت به ویژه برای مانت خودکار DDIها در هنگام بوت از طریق ورودی‌های ساده در
/etc/fstab
بسیار مفید است\&. برای مثال:
.sp
.if n \{\
.RS 4
.\}
.nf
/path/to/myimage\&.raw /images/myimage/ ddi defaults 0 0
.fi
.if n \{\
.RE
.\}
.PP
هنگامی که به این شیوه فراخوانی می‌شود، گزینه‌های مانت
"ro"،
"rw"،
"discard"،
"nodiscard"
به گزینه‌های متناظر فهرست‌شده در بالا نگاشت می‌شوند (یعنی
\fB\-\-read\-only\fR،
\fB\-\-discard=all\fR،
\fB\-\-discard=disabled\fR)\&.
گزینه‌های مانت به طور عمومی به سیستم‌های فایل درون تصاویر منتقل
\fIنمی‌شوند\fR\&.
.SH "مثال‌ها (EXAMPLES)"
.PP
\fBمثال\ \&۱.\ \&تولید یک تاربال از تصویر دیسک سیستم‌عامل (\-\-with)\fR
.sp
.if n \{\
.RS 4
.\}
.nf
# systemd\-dissect \-\-with foo\&.raw tar cz \&. >foo\&.tar\&.gz
.fi
.if n \{\
.RE
.\}
.PP
یا به عنوان روش جایگزین، به سادگی:
.PP
\fBمثال\ \&۲.\ \&تولید یک تاربال از تصویر دیسک سیستم‌عامل (\-\-make\-archive)\fR
.sp
.if n \{\
.RS 4
.\}
.nf
# systemd\-dissect \-\-make\-archive foo\&.raw foo\&.tar\&.gz
.fi
.if n \{\
.RE
.\}
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBsystemd\fR(1), \fBsystemd-nspawn\fR(1), \fBsystemd.exec\fR(5), \fBsystemd.v\fR(7), \m[blue]\fBUAPI\&.2 Discoverable Partitions Specification\fR\m[]\&\s-2\u[1]\d\s+2, \fBmount\fR(8), \fBumount\fR(8), \fBfdisk\fR(8)
.SH "یادداشت‌ها (NOTES)"
.IP " 1." 4
مشخصات UAPI.2 Discoverable Partitions Specification
.RS 4
\%https://uapi-group.org/specifications/specs/discoverable_partitions_specification
.RE
.IP " 2." 4
راهنمای Users, Groups, UIDs and GIDs on systemd Systems
.RS 4
\%https://systemd.io/UIDS-GIDS
.RE