.\" ----------------------------------------------------------------------------
.\" Update the date below if you make any significant change.
.\" ----------------------------------------------------------------------------
.
.TH MULTIPATH 8 2023-09-08 Linux
.
.
.\" ----------------------------------------------------------------------------
.SH "نام (NAME)"
.\" ----------------------------------------------------------------------------
.
multipath \- پیکربندی خودکار مقصدهای نگاشت‌کننده دستگاه (Device Mapper).
.
.
.\" ----------------------------------------------------------------------------
.SH "خلاصه دستور (SYNOPSIS)"
.\" ----------------------------------------------------------------------------
.
.B multipath
.RB [\| \-v\ \c
.IR level \|]
.RB [\| \-B | \-d | \-i | \-q | \-r \|]
.RB [\| \-b\ \c
.IR file \|]
.RB [\| \-p\ \c
.IR policy \|]
.RB [\| device \|]
.
.LP
.B multipath
.RB [\| \-v\ \c
.IR level \|]
.RB [\| \-R\ \c
.IR retries \|]
.B \-f device
.
.LP
.B multipath
.RB [\| \-v\ \c
.IR level \|]
.RB [\| \-R\ \c
.IR retries \|]
.B \-F
.
.LP
.B multipath
.RB [\| \-v\ \c
.IR level \|]
.RB [\| \-l | \-ll \|]
.RB [\| device \|]
.
.LP
.B multipath
.RB [\| \-v\ \c
.IR level \|]
.RB [\| \-a | \-w \|]
.B device
.
.LP
.B multipath
.RB [\| \-v\ \c
.IR level \|]
.B \-W
.
.LP
.B multipath
.RB [\| \-v\ \c
.IR level \|]
.RB [\| \-i \|]
.RB [\| \-c | \-C \|]
.B device
.
.LP
.B multipath
.RB [\| \-v\ \c
.IR level \|]
.RB [\| \-i \|]
.RB [\| \-u | \-U \|]
.
.LP
.B multipath
.RB [\| \-h | \-t | \-T \|]
.
.\" ----------------------------------------------------------------------------
.SH "توضیحات (DESCRIPTION)"
.\" ----------------------------------------------------------------------------
.
دستور
.B multipath
برای شناسایی و ادغام چندین مسیر به سمت دستگاه‌ها، به منظور جایگزینی در صورت خرابی (fail-over) یا بهبود کارایی استفاده می‌شود.
.
.\" ----------------------------------------------------------------------------
.SH "آرگومان‌ها (ARGUMENTS)"
.\" ----------------------------------------------------------------------------
.
آرگومان \fBdevice\fR عملکرد \fBmultipath\fR را فقط به دستگاه‌هایی که با عبارت داده‌شده مطابقت دارند محدود می‌کند. این آرگومان می‌تواند به یک نگاشت چندمسیره یا به اجزای آن (\(dqمسیرها\(dq) اشاره داشته باشد. این عبارت می‌تواند در یکی از قالب‌های زیر باشد:
.
.TP
.B گره دستگاه (device node)
نام فایل یک گره دستگاه، به عنوان مثال \fI/dev/dm-10\fR یا \fI/dev/sda\fR. اگر این گره به یک دستگاه نگاشت‌کننده دستگاه موجود که نماینده یک نگاشت چندمسیره است اشاره کند، بسته به حالت عملکرد، این نگاشت یا مسیرهای آن انتخاب می‌شوند. در غیر این صورت، یک دستگاه مسیر انتخاب خواهد شد.
.
.TP
.B شناسه دستگاه (device ID)
شماره دستگاه در هسته که با شماره‌های \fImajor:minor\fR مشخص می‌شود، مانند \fI65:16\fR. این قالب فقط برای دستگاه‌های مسیر قابل استفاده است.
.
.TP
.B شناسه سراسری (WWID)
یک شناسه سراسری (World Wide Identifier) که با یک نگاشت چندمسیره یا مسیرهای آن مطابقت دارد. برای فهرست کردن WWID دستگاه‌های موجود در سیستم، می‌توانید برای نمونه از دستور \fImultipath \-d \-v3 2>/dev/null\fR استفاده کنید.
.
.\" ----------------------------------------------------------------------------
.SH "حالت‌های عملکرد (OPERATION MODES)"
.\" ----------------------------------------------------------------------------
.
حالت عملکرد پیش‌فرض، شناسایی و راه‌اندازی نگاشت‌های چندمسیره از روی دستگاه‌های یافت‌شده در سیستم است.
.
حالت‌های عملکرد دیگر با استفاده از یکی از سوییچ‌های خط فرمان زیر انتخاب می‌شوند:
.TP
.B \-f
تخلیه (حذف) یک نگاشت دستگاه چندمسیره مشخص‌شده به عنوان پارامتر، در صورتی که استفاده نشود. این عملیات در صورت در حال اجرا بودن دیمن \fBmultipathd\fR به آن واگذار می‌شود.
.
.TP
.B \-F
تخلیه (حذف) تمام نگاشت‌های استفاده‌نشده دستگاه‌های چندمسیره. این عملیات در صورت در حال اجرا بودن دیمن \fBmultipathd\fR به آن واگذار می‌شود.
.
.TP
.B \-l
نمایش (\(dqفهرست کردن\(dq) توپولوژی فعلی چندمسیره با استفاده از اطلاعات دریافت شده از \fIsysfs\fR و نگاشت‌کننده دستگاه (device-mapper).
.
.TP
.B \-ll
نمایش (\(dqفهرست کردن\(dq) توپولوژی فعلی چندمسیره از روی تمامی اطلاعات موجود (\fIsysfs\fR، نگاشت‌کننده دستگاه، بررسی‌کننده‌های مسیر و...).
.
.TP
.B \-a
افزودن WWID مربوط به دستگاه مشخص‌شده به فایل WWIDها.
.
.TP
.B \-w
حذف WWID مربوط به دستگاه مشخص‌شده از فایل WWIDها.
.
.TP
.B \-W
بازنشانی فایل WWIDها به طوری که فقط شامل دستگاه‌های چندمسیره فعلی باشد.
.
.TP
.B \-c
بررسی اینکه آیا یک دستگاه بلوکی باید به عنوان مسیری در یک دستگاه چندمسیره باشد یا خیر.
.
.TP
.B \-C
بررسی اینکه آیا یک دستگاه چندمسیره دارای مسیرهای قابل استفاده است یا خیر. این مورد می‌تواند برای آزمایش اینکه آیا ورودی/خروجی (I/O) روی این دستگاه محتملاً موفق خواهد بود یا خیر استفاده شود. خود دستور تلاشی برای انجام I/O روی دستگاه انجام نمی‌دهد.
.
.TP
.B \-u
بررسی اینکه آیا دستگاه مشخص‌شده در متغیرهای محیطی برنامه باید مسیری در یک دستگاه چندمسیره باشد یا خیر.
.
.TP
.B \-U
بررسی اینکه آیا دستگاه مشخص‌شده در متغیرهای محیطی برنامه یک دستگاه چندمسیره با مسیرهای قابل استفاده است یا خیر. گزینه
.B \-C
را ببینید.
.
.TP
.B \-h
چاپ متن راهنمای استفاده از دستور.
.
.TP
.B \-t
نمایش پیکربندی فعلی مورد استفاده توسط \fBmultipathd\fR.
.
.TP
.B \-T
نمایش پیکربندی فعلی مورد استفاده توسط \fBmultipathd\fR، با محدود کردن خروجی فقط به دستگاه‌هایی که واقعاً در سیستم حضور دارند. این خروجی می‌تواند به عنوان الگویی برای ایجاد \fI/etc/multipath.conf\fR استفاده شود.
.
.\" ----------------------------------------------------------------------------
.SH "گزینه‌ها (OPTIONS)"
.\" ----------------------------------------------------------------------------
.
.TP
.BI \-v " level"
میزان جزئیات (Verbosity) اطلاعات چاپ‌شده در خروجی استاندارد (\fIstdout\fR) در حالت‌های عملکرد پیش‌فرض و \(dqفهرست کردن\(dq (list). مقدار پیش‌فرض \fI\-v 2\fR است.
.RS
.TP
.I 0
هیچ پیامی چاپ نمی‌شود.
.TP
.I 1
در حالت پیش‌فرض، نام‌ها/WWIDهای نگاشت‌های چندمسیره ایجادشده یا تغییریافته چاپ می‌شوند. در حالت فهرست، WWIDهای تمامی نگاشت‌های چندمسیره چاپ می‌شوند.
.TP
.I 2
در حالت پیش‌فرض، توپولوژی نگاشت‌های چندمسیره ایجادشده یا تغییریافته چاپ می‌شود. در حالت فهرست، توپولوژی تمامی نگاشت‌های چندمسیره چاپ می‌شود.
.TP
.I 3
تمام مسیرهای شناسایی‌شده و توپولوژی تمامی نگاشت‌های چندمسیره چاپ می‌شوند.
.
.LP
.
سطح پرگویی همچنین سطح پیام‌های گزارش (log) و اشکال‌زدایی چاپ‌شده در خروجی خطای استاندارد (\fIstderr\fR) را کنترل می‌کند. سطح پیش‌فرض متناظر با \fILOG_NOTICE\fR است (پیام‌های مهمی که در عملکرد عادی نباید نادیده گرفته شوند).
.
.RE
.TP
.B \-d
اجرای آزمایشی (Dry run)؛ نگاشت‌های دستگاه (devmaps) را ایجاد یا به‌روزرسانی نمی‌کند.
.
.TP
.B \-e
فعال‌سازی تمامی کتابخانه‌های خارجی (foreign). این گزینه مقدار
.I enable_foreign
در
.BR multipath.conf (5)
را بازنویسی می‌کند.
.
.TP
.B \-i
نادیده گرفتن فایل WWIDها هنگام پردازش دستگاه‌ها. اگر
\fIfind_multipaths strict\fR
یا
\fIfind_multipaths no\fR
در فایل
\fI/etc/multipath.conf\fR
تنظیم شده باشد، multipath تنها دستگاه‌هایی را در نظر می‌گیرد که در فایل WWIDها فهرست شده باشند. این گزینه آن رفتار را بازنویسی می‌کند. برای سایر مقادیر
\fIfind_multipaths\fR،
این گزینه هیچ تأثیری ندارد. توضیحات
\fIfind_multipaths\fR
را در
.BR /etc/multipath.conf (5)
ببینید. این گزینه فقط باید در شرایط نادر استفاده شود.
.
.TP
.B \-B
تلقی کردن فایل نگاشت‌ها (bindings file) به صورت فقط‌خواندنی.
.
.TP
.BI \-b " file"
(\fBمنسوخ‌شده، استفاده نکنید\fR) تعیین مکان فایل نگاشت‌های \fIuser_friendly_names\fR. مقدار پیش‌فرض
\fI/etc/multipath/bindings\fR
است.
.
.TP
.B \-q
ویژگی \fIqueue_if_no_path\fR نگاشت‌کننده دستگاه را برای نگاشت‌های چندمسیره غیرفعال (unset) نکنید. در حالت عادی، اگر \fBmultipathd\fR در حال اجرا نباشد، \fBmultipath\fR این ویژگی را غیرفعال می‌کند؛ زیرا تنها یک دیمن چندمسیره در حال اجرا تضمین می‌کند که مسیرهای غیرقابل استفاده پس از در دسترس قرار گرفتن مجدد بازیابی شوند.
.
.TP
.BI \-p " policy"
وادار کردن نگاشت‌های جدید به استفاده از خط‌مشی (policy) مشخص‌شده، که پیکربندی موجود در
\fBmultipath.conf(5)\fR
را بازنویسی می‌کند. مقادیر مجاز برای
\fIpolicy\fR
همانند مقادیر
\fIpath_grouping_policy\fR
در
\fBmultipath.conf(5)\fR
هستند. نگاشت‌های موجود تغییر نمی‌کنند.
.
.TP
.B \-r
بارگذاری مجدد اجباری تمام نگاشت‌های چندمسیره موجود. این دستور در صورت در حال اجرا بودن دیمن multipathd به آن واگذار می‌شود. در این حالت، سایر سوییچ‌های خط فرمان دستور \fImultipath\fR هیچ تأثیری نخواهند داشت.
.
.TP
.BI \-R " retries"
تعداد دفعات تلاش مجدد برای پاکسازی (flush) دستگاه‌های چندمسیره‌ای که در حال استفاده هستند. مقدار پیش‌فرض
\fI0\fR
است.
.
.\" ----------------------------------------------------------------------------
.SH "همچنین ببینید (SEE ALSO)"
.\" ----------------------------------------------------------------------------
.
.BR multipathd (8),
.BR multipath.conf (5),
.BR kpartx (8),
.BR udev (8),
.BR dmsetup (8),
.BR hotplug (8).
.
.
.\" ----------------------------------------------------------------------------
.SH "نویسندگان (AUTHORS)"
.\" ----------------------------------------------------------------------------
.
بسته \fImultipath-tools\fR توسط Christophe Varoqui <christophe.varoqui@opensvc.com> و دیگران توسعه یافته است.
.\" EOF