'\" t
.TH "SYSTEMD\-MSTACK" "1" "" "systemd 261.2" "systemd-mstack"
.\" -----------------------------------------------------------------
.\" * 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-mstack, mount.mstack \- پشته‌های مانت تصاویر دیسک قابل‌کشف (DDIs)
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBsystemd\-mstack\fR\ 'u
\fBsystemd\-mstack\fR [OPTIONS...] \fIIMAGE\fR
.HP \w'\fBsystemd\-mstack\fR\ 'u
\fBsystemd\-mstack\fR [OPTIONS...] [\-\-mount] \fIIMAGE\fR \fIPATH\fR
.HP \w'\fBsystemd\-mstack\fR\ 'u
\fBsystemd\-mstack\fR [OPTIONS...] [\-\-umount] \fIPATH\fR
.SH "توضیحات (DESCRIPTION)"
.PP
\fBsystemd\-mstack\fR
ابزاری برای بازرسی و تعامل با دایرکتوری‌های پشته مانت
\&.mstack/
است، همان‌طور که در
\fBsystemd.mstack\fR(7)
شرح داده شده است\&. این ابزار از سه عملیات مختلف پشتیبانی می‌کند:
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  1." 4.2
.\}
نمایش اطلاعات عمومی پشته مانت، از جمله تمام لایه‌های
"overlayfs"
توصیف‌شده و مانت‌های متصل (bind mounts)\&.
.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
.\}
آن‌مانت کردن یک پشته مانت از یک دایرکتوری محلی\&.
.RE
.PP
دستور
\fBsystemd\-mstack\fR
می‌تواند به‌صورت
\fBmount\&.mstack\fR
فراخوانی شود که در این حالت رابط «کمک‌کننده خارجی» (external helper) دستور
\fBmount\fR(8)
را پیاده‌سازی می‌کند\&. این ویژگی تضمین می‌کند که دایرکتوری‌های پشته مانت سازگار با
\fBsystemd\-mstack\fR
بتوانند مستقیماً توسط
\fBmount\fR
و
\fBfstab\fR(5)
مانت شوند\&. برای جزئیات به بخش‌های بعد مراجعه کنید\&.
.PP
به‌جای مسیر تصویر، می‌توان یک دایرکتوری دارای نسخه
"\&.v/"
را مشخص کرد؛ برای جزئیات
\fBsystemd.v\fR(7)
را ببینید\&.
.SH "دستورات (COMMANDS)"
.PP
اگر هیچ‌یک از سوئیچ‌های دستوری فهرست‌شده در زیر ارسال نشوند، پشته مانت مشخص‌شده باز شده و اطلاعات کلی درباره آن، از جمله فهرستی از تمام لایه‌های تعریف‌شده، نمایش داده می‌شود\&.
.PP
\fB\-\-mount\fR, \fB\-m\fR
.RS 4
پشته مانت مشخص‌شده را در دایرکتوری تعیین‌شده مانت می‌کند\&.
.sp
برای آن‌مانت کردن دایرکتوری پشته مانتی که به این روش مانت شده است، از عملیات
\fB\-\-umount\fR
استفاده کنید\&.
.sp
توجه داشته باشید که این قابلیت در
\fBmount\fR(8)
از طریق دستوری مانند
\fBmount \-t mstack mystack\&.mstack targetdir/\fR
و همچنین در
\fBfstab\fR(5)
نیز در دسترس است\&. برای جزئیات، به بخش‌های بعد مراجعه کنید\&.
.sp
در نسخه 260 اضافه شد\&.
.RE
.PP
\fB\-M\fR
.RS 4
این یک میانبر برای
\fB\-\-mount \-\-mkdir\fR
است\&.
.sp
در نسخه 260 اضافه شد\&.
.RE
.PP
\fB\-\-umount\fR, \fB\-u\fR
.RS 4
یک پشته مانت را از دایرکتوری مشخص‌شده آن‌مانت می‌کند\&. این دستور یک آرگومان می‌پذیرد: دایرکتوری‌ای که پشته مانت در آن مانت شده بود\&.
.sp
تمام مانت‌های انجام‌شده به‌صورت بازگشتی آن‌مانت خواهند شد\&.
.sp
در نسخه 260 اضافه شد\&.
.RE
.PP
\fB\-U\fR
.RS 4
این یک میانبر برای
\fB\-\-umount \-\-rmdir\fR
است\&.
.sp
در نسخه 260 اضافه شد\&.
.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
در نسخه 260 اضافه شد\&.
.RE
.PP
\fB\-\-mkdir\fR
.RS 4
اگر با
\fB\-\-mount\fR
ترکیب شود، دایرکتوری مورد نظر برای مانت کردن پشته مانت در صورت عدم وجود، ایجاد می‌شود\&. توجه داشته باشید که با آن‌مانت شدن مجدد پشته مانت، دایرکتوری به‌طور خودکار حذف نخواهد شد\&.
.sp
در نسخه 260 اضافه شد\&.
.RE
.PP
\fB\-\-rmdir\fR
.RS 4
اگر با
\fB\-\-umount\fR
ترکیب شود، دایرکتوری مشخص‌شده‌ای که پشته مانت در آن مانت شده است پس از آن‌مانت کردن حذف می‌شود\&.
.sp
در نسخه 260 اضافه شد\&.
.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 برگردانده می‌شود، و در غیر این صورت یک کد خطای غیرصفر\&.
.SH "فراخوانی به‌صورت /sbin/mount.mstack (INVOCATION AS /SBIN/MOUNT\&.MSTACK)"
.PP
فایل اجرایی
\fBsystemd\-mstack\fR
می‌تواند به
/sbin/mount\&.mstack
پیوند نمادین (symlink) داده شود\&. اگر از این طریق فراخوانی شود، رابط «کمک‌کننده خارجی» دستور
\fBmount\fR(8)
را برای نوع (شبه) سیستم‌فایل
"mstack"
پیاده‌سازی می‌کند\&. این بدان معناست که دایرکتوری‌های پشته مانت سازگار را می‌توان مستقیماً از طریق
.sp
.if n \{\
.RS 4
.\}
.nf
# mount \-t mstack mystack\&.mstack targetdir/
.fi
.if n \{\
.RE
.\}
.PP
به روشی که تا حد زیادی معادل دستور زیر است، مانت کرد:
.sp
.if n \{\
.RS 4
.\}
.nf
# systemd\-mstack \-\-mount mystack\&.mstack targetdir/
.fi
.if n \{\
.RE
.\}
.PP
توجه داشته باشید از آنجا که یک پشته مانت منفرد ممکن است حاوی چندین نقطه مانت باشد، بعداً باید با دستور
\fBumount \-R targetdir/\fR
برای عملکرد بازگشتی، آن‌مانت شود\&.
.PP
این قابلیت به‌ویژه برای مانت خودکار پشته‌های مانت در هنگام بوت از طریق ورودی‌های ساده
/etc/fstab
بسیار مفید است\&. برای مثال:
.sp
.if n \{\
.RS 4
.\}
.nf
/path/to/mystack\&.nspawn /images/mystack/ mstack defaults 0 0
.fi
.if n \{\
.RE
.\}
.PP
هنگامی که به این روش فراخوانی می‌شود، گزینه‌های مانت
"ro"
و
"rw"
به گزینه‌های متناظر فهرست‌شده در بالا نگاشت می‌شوند (یعنی
\fB\-\-read\-only\fR)\&.
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBsystemd\fR(1), \fBsystemd.mstack\fR(7), \fBsystemd-nspawn\fR(1), \fBsystemd.exec\fR(5), \fBmount\fR(8), \fBumount\fR(8)