'\" t
.TH "SYSTEMD\-STORAGE\-FS@\&.SERVICE" "8" "" "systemd 261.2" "systemd-storage-fs@.service"
.\" -----------------------------------------------------------------
.\" * 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-storage-fs@.service, systemd-storage-fs.socket, systemd-storage-fs \- سرویس مدیریت و سوار کردن سیستم‌های فایل ذخیره‌سازی
.SH "خلاصه دستور (SYNOPSIS)"
.PP
systemd\-storage\-fs@\&.service
.PP
systemd\-storage\-fs\&.socket
.SH "توضیحات (DESCRIPTION)"
.PP
systemd\-storage\-fs@\&.service
سرویسی است که رابط
\fBio\&.systemd\&.StorageProvider\fR
\m[blue]\fBVarlink\fR\m[]\&\s-2\u[1]\d\s+2
را پیاده‌سازی می‌کند، و فایل‌ها و دایرکتوری‌های معمولی در
/var/lib/storage/*\&.volume
(در صورت استفاده در حالت سیستمی) یا
$XDG_STATE_HOME/storage
(در صورت استفاده در حالت کاربری) را به عنوان حجم‌های ذخیره‌سازی در دسترس قرار می‌دهد\&. حجم‌های دریافت‌شده به صورت توصیف‌کننده‌های فایل به فراخوان بازگردانده می‌شوند\&. برخلاف
\fBsystemd-storage-block@.service\fR(8)،
این پیاده‌سازی از ایجاد حجم‌های جدید در صورت تقاضا از مجموعه‌ای کوچک از الگوهای درون‌ساخت نیز پشتیبانی می‌کند\&.
.PP
این سرویس از طریق
systemd\-storage\-fs\&.socket
به‌صورت سوکت‌محور فعال (socket\-activated) می‌شود\&. در حالت سیستمی به سوکت AF_UNIX در مسیر
/run/systemd/io\&.systemd\&.StorageProvider/fs
و در حالت کاربری در مسیر
$XDG_RUNTIME_DIR/systemd/io\&.systemd\&.StorageProvider/fs
گوش می‌دهد\&. برای یک ابزار شمارش به
\fBstoragectl\fR(1)
مراجعه کنید\&.
.PP
همچنین برای یک پیاده‌سازی مکمل که دستگاه‌های بلوکی محلی را به عنوان حجم‌های ذخیره‌سازی در دسترس قرار می‌دهد، به
\fBsystemd-storage-block@.service\fR(8)
مراجعه کنید\&.
.SH "حجم‌ها (VOLUMES)"
.PP
حجم‌ها در زیر دایرکتوری ذخیره‌سازی نگهداری می‌شوند:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
/var/lib/storage/
هنگام اجرا در حالت سیستمی\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
$XDG_STATE_HOME/storage/
(معمولاً
~/\&.local/state/storage/)
هنگام اجرا در حالت کاربری\&.
.RE
.PP
هر حجم روی دیسک به عنوان یک مدخل دایرکتوری با پسوند
\&.volume
در دایرکتوری ذخیره‌سازی نگهداری می‌شود\&. مدخل‌هایی که فایل‌های معمولی هستند به عنوان حجم‌هایی از نوع
\fBreg\fR
در دسترس قرار می‌گیرند؛ مدخل‌هایی که دایرکتوری هستند به عنوان حجم‌هایی از نوع
\fBdir\fR
ارائه می‌شوند\&. علاوه بر این، گره‌های دستگاه بلوکی می‌توانند پیوند نمادین (یا bind mount) شوند درون دایرکتوری، که سپس به عنوان حجم‌هایی از نوع
\fBblk\fR
در دسترس قرار می‌گیرند\&.
.PP
برای حجم‌های دایرکتوری، ریشهٔ سیستم‌فایل ارسال‌شده به کلاینت‌ها در زیردایرکتوری
root/
از دایرکتوری
\fINAME\fR\&.volume
قرار می‌گیرد\&. مورد اول (و تمام inodeهای زیر آن) باید متعلق به محدودهٔ UID خارجی باشند، و مورد دوم متعلق به کاربر root میزبان باشد\&.
.PP
هنگام دریافت یک حجم، پیوندهای نمادین دنبال می‌شوند\&.
.PP
یک مدیر مجاز است سلسله‌مراتب حجم‌ها را مستقیماً دستکاری کند مادامی که قواعد شرح داده شده در بالا رعایت شوند\&. به‌ویژه، کپی کردن، سوار کردن (mount) یا پیوند نمادین منابع خارجی دلخواه (صرف‌نظر از اینکه دایرکتوری، فایل معمولی یا بلوکی باشند) به داخل دایرکتوری حجم‌ها مجاز است، تا به عنوان حجم‌های اضافی در دسترس قرار گیرند\&.
.SH "الگوها (TEMPLATES)"
.PP
این ارائه‌دهنده از ایجاد خودکار حجم‌های جدید هنگام دریافت آنها پشتیبانی می‌کند\&. فراخوان می‌تواند یک
\fIالگو (template)\fR
انتخاب کند که جزئیات پیکربندی حجم ایجادشونده را تعیین می‌کند\&. الگوهای درون‌ساخت زیر در دسترس هستند:
.PP
\fBsparse\-file\fR
.RS 4
حجمی ایجاد می‌کند که توسط یک فایل معمولی کم‌پشت (sparse file) پشتیبانی می‌شود\&. این الگوی پیش‌فرض هنگام ایجاد حجم فایل معمولی است\&. (نوع حجم
"reg"
است\&.)
.sp
اضافه‌شده در نگارش 261\&.
.RE
.PP
\fBallocated\-file\fR
.RS 4
حجمی ایجاد می‌کند که توسط یک فایل معمولی کاملاً تخصیص‌یافته پشتیبانی می‌شود\&. (نوع حجم
"reg"
است\&.)
.sp
اضافه‌شده در نگارش 261\&.
.RE
.PP
\fBdirectory\fR
.RS 4
حجمی ایجاد می‌کند که توسط یک دایرکتوری معمولی پشتیبانی می‌شود\&. (نوع حجم
"dir"
است\&.)
.sp
اضافه‌شده در نگارش 261\&.
.RE
.PP
\fBsubvolume\fR
.RS 4
یک زیرحجم (subvolume) سامانه btrfs را به عنوان inode پشتیبان ایجاد می‌کند (در صورتی که دایرکتوری ذخیره‌سازی روی btrfs نباشد، به یک دایرکتوری معمولی بازمی‌گردد)\&. این الگوی پیش‌فرض هنگام ایجاد یک حجم دایرکتوری است\&. (نوع حجم
"dir"
است\&.)
.sp
اضافه‌شده در نگارش 261\&.
.RE
.SH "گزینه‌ها (OPTIONS)"
.PP
گزینه‌های خط فرمان زیر پشتیبانی می‌شوند:
.PP
\fB\-\-system\fR
.RS 4
در حالت سیستمی کار می‌کند\&. حجم‌ها در زیر
/var/lib/storage/
ذخیره می‌شوند\&. این مقدار پیش‌فرض هنگام فراخوانی از
systemd\-storage\-fs@\&.service
در مدیر سیستم است\&.
.sp
اضافه‌شده در نگارش 261\&.
.RE
.PP
\fB\-\-user\fR
.RS 4
در حالت کاربری کار می‌کند\&. حجم‌ها در زیر
$XDG_STATE_HOME/storage/
ذخیره می‌شوند\&. این مقدار پیش‌فرض هنگام فراخوانی از
systemd\-storage\-fs@\&.service
در مدیر کاربر است\&.
.sp
اضافه‌شده در نگارش 261\&.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
یک متن راهنمای کوتاه را چاپ کرده و خارج می‌شود\&.
.RE
.PP
\fB\-\-version\fR
.RS 4
یک رشته نسخه کوتاه را چاپ کرده و خارج می‌شود\&.
.RE
.SH "فایل‌ها (FILES)"
.PP
/var/lib/storage/, $XDG_STATE_HOME/storage/
.RS 4
دایرکتوری ذخیره‌سازی که به ترتیب برای پشتیبانی از نمونه‌های سرویس در حالت سیستمی و کاربری استفاده می‌شود\&. هر حجم به عنوان یک مدخل با پسوند
\&.volume
در زیر این دایرکتوری ذخیره می‌شود\&.
.sp
اضافه‌شده در نگارش 261\&.
.RE
.PP
/run/systemd/io\&.systemd\&.StorageProvider/fs, $XDG_RUNTIME_DIR/systemd/io\&.systemd\&.StorageProvider/fs
.RS 4
سوکت‌های AF_UNIX که سرویس به ترتیب در حالت سیستمی و کاربری به آنها گوش می‌دهد\&. اینها مکان‌های استاندارد برای ارائه‌دهنده ذخیره‌سازی
"fs"
هستند، و توسط
\fBstoragectl providers\fR
شمارش می‌شوند\&.
.sp
اضافه‌شده در نگارش 261\&.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBsystemd\fR(1), \fBstoragectl\fR(1), \fBsystemd-storage-block@.service\fR(8)
.SH "یادداشت‌ها (NOTES)"
.IP " 1." 4
Varlink
.RS 4
\%https://varlink.org
.RE