نام (NAME)

systemd-mstack, mount.mstack - پشته‌های مانت تصاویر دیسک قابل‌کشف (DDIs)

خلاصه دستور (SYNOPSIS)

systemd-mstack [OPTIONS...] IMAGE

systemd-mstack [OPTIONS...] [--mount] IMAGE PATH

systemd-mstack [OPTIONS...] [--umount] PATH

توضیحات (DESCRIPTION)

systemd-mstack ابزاری برای بازرسی و تعامل با دایرکتوری‌های پشته مانت .mstack/ است، همان‌طور که در systemd.mstack(7) شرح داده شده است. این ابزار از سه عملیات مختلف پشتیبانی می‌کند:

1.نمایش اطلاعات عمومی پشته مانت، از جمله تمام لایه‌های "overlayfs" توصیف‌شده و مانت‌های متصل (bind mounts).

2.مانت کردن یک پشته مانت در یک دایرکتوری محلی.

3.آن‌مانت کردن یک پشته مانت از یک دایرکتوری محلی.

دستور systemd-mstack می‌تواند به‌صورت mount.mstack فراخوانی شود که در این حالت رابط «کمک‌کننده خارجی» (external helper) دستور mount(8) را پیاده‌سازی می‌کند. این ویژگی تضمین می‌کند که دایرکتوری‌های پشته مانت سازگار با systemd-mstack بتوانند مستقیماً توسط mount و fstab(5) مانت شوند. برای جزئیات به بخش‌های بعد مراجعه کنید.

به‌جای مسیر تصویر، می‌توان یک دایرکتوری دارای نسخه ".v/" را مشخص کرد؛ برای جزئیات systemd.v(7) را ببینید.

دستورات (COMMANDS)

اگر هیچ‌یک از سوئیچ‌های دستوری فهرست‌شده در زیر ارسال نشوند، پشته مانت مشخص‌شده باز شده و اطلاعات کلی درباره آن، از جمله فهرستی از تمام لایه‌های تعریف‌شده، نمایش داده می‌شود.

--mount, -m

پشته مانت مشخص‌شده را در دایرکتوری تعیین‌شده مانت می‌کند.

برای آن‌مانت کردن دایرکتوری پشته مانتی که به این روش مانت شده است، از عملیات --umount استفاده کنید.

توجه داشته باشید که این قابلیت در mount(8) از طریق دستوری مانند mount -t mstack mystack.mstack targetdir/ و همچنین در fstab(5) نیز در دسترس است. برای جزئیات، به بخش‌های بعد مراجعه کنید.

در نسخه 260 اضافه شد.

-M

این یک میانبر برای --mount --mkdir است.

در نسخه 260 اضافه شد.

--umount, -u

یک پشته مانت را از دایرکتوری مشخص‌شده آن‌مانت می‌کند. این دستور یک آرگومان می‌پذیرد: دایرکتوری‌ای که پشته مانت در آن مانت شده بود.

تمام مانت‌های انجام‌شده به‌صورت بازگشتی آن‌مانت خواهند شد.

در نسخه 260 اضافه شد.

-U

این یک میانبر برای --umount --rmdir است.

در نسخه 260 اضافه شد.

-h, --help

یک متن راهنمای کوتاه را چاپ کرده و خارج می‌شود.

--version

یک رشته نسخه کوتاه را چاپ کرده و خارج می‌شود.

گزینه‌ها (OPTIONS)

گزینه‌های زیر پشتیبانی می‌شوند:

--read-only, -r

در حالت فقط‌خواندنی عمل می‌کند. به‌طور پیش‌فرض، --mount نقاط مانت با قابلیت نوشتن ایجاد می‌کند. اگر این گزینه مشخص شود، آن‌ها در حالت فقط‌خواندنی ایجاد می‌شوند.

در نسخه 260 اضافه شد.

--mkdir

اگر با --mount ترکیب شود، دایرکتوری مورد نظر برای مانت کردن پشته مانت در صورت عدم وجود، ایجاد می‌شود. توجه داشته باشید که با آن‌مانت شدن مجدد پشته مانت، دایرکتوری به‌طور خودکار حذف نخواهد شد.

در نسخه 260 اضافه شد.

--rmdir

اگر با --umount ترکیب شود، دایرکتوری مشخص‌شده‌ای که پشته مانت در آن مانت شده است پس از آن‌مانت کردن حذف می‌شود.

در نسخه 260 اضافه شد.

--image-policy=policy

یک رشته سیاست تصویر را به‌عنوان آرگومان می‌گیرد، مطابق با systemd.image-policy(7). این سیاست هنگام کار بر روی تصویر دیسک مشخص‌شده از طریق --image= اعمال می‌شود، به بالا مراجعه کنید. اگر مشخص نشود، مقدار پیش‌فرض آن سیاست "*" است، یعنی از تمام سیستم‌های فایل شناسایی‌شده در تصویر استفاده می‌شود.

--image-filter=filter

یک رشته فیلتر تصویر را به‌عنوان آرگومان می‌گیرد، مطابق با systemd.image-filter(7). این فیلتر هنگام کار بر روی تصویر دیسک مشخص‌شده از طریق --image= در نظر گرفته می‌شود، به بالا مراجعه کنید. اگر مشخص نشود هیچ فیلتری اعمال نخواهد شد.

--no-pager

خروجی را به یک صفحه‌بند (pager) هدایت نمی‌کند.

--no-legend

راهنما (legend)، یعنی سرستون‌ها و پاورقی حاوی نکات را چاپ نمی‌کند.

--json=MODE

خروجی قالب‌بندی‌شده به‌صورت JSON را نمایش می‌دهد. یکی از مقادیر "short" (برای کوتاه‌ترین خروجی ممکن بدون هیچ فضای خالی اضافی یا شکست خط)، "pretty" (برای نسخه خواناتر و زیباتر از همان، همراه با تورفتگی و شکست خط) یا "off" (برای خاموش کردن خروجی JSON، که حالت پیش‌فرض است) را می‌پذیرد.

کدهای خروج (EXIT STATUS)

در صورت موفقیت 0 برگردانده می‌شود، و در غیر این صورت یک کد خطای غیرصفر.

فراخوانی به‌صورت /sbin/mount.mstack (INVOCATION AS /SBIN/MOUNT.MSTACK)

فایل اجرایی systemd-mstack می‌تواند به /sbin/mount.mstack پیوند نمادین (symlink) داده شود. اگر از این طریق فراخوانی شود، رابط «کمک‌کننده خارجی» دستور mount(8) را برای نوع (شبه) سیستم‌فایل "mstack" پیاده‌سازی می‌کند. این بدان معناست که دایرکتوری‌های پشته مانت سازگار را می‌توان مستقیماً از طریق

# mount -t mstack mystack.mstack targetdir/

به روشی که تا حد زیادی معادل دستور زیر است، مانت کرد:

# systemd-mstack --mount mystack.mstack targetdir/

توجه داشته باشید از آنجا که یک پشته مانت منفرد ممکن است حاوی چندین نقطه مانت باشد، بعداً باید با دستور umount -R targetdir/ برای عملکرد بازگشتی، آن‌مانت شود.

این قابلیت به‌ویژه برای مانت خودکار پشته‌های مانت در هنگام بوت از طریق ورودی‌های ساده /etc/fstab بسیار مفید است. برای مثال:

/path/to/mystack.nspawn /images/mystack/ mstack defaults 0 0

هنگامی که به این روش فراخوانی می‌شود، گزینه‌های مانت "ro" و "rw" به گزینه‌های متناظر فهرست‌شده در بالا نگاشت می‌شوند (یعنی --read-only).

همچنین ببینید (SEE ALSO)

systemd(1), systemd.mstack(7), systemd-nspawn(1), systemd.exec(5), mount(8), umount(8)