نام (NAME)

mfsbdev - دیمون و ابزار مدیریت دستگاه بلوکی MooseFS

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

mfsbdev start [-H masterhost] [-P masterport] [-B masterbind] [-S masterpath] [-p masterpassword | -x passwordfile] [-l linksocket] [-i init_mappings_file] [-o options]

mfsbdev stop [-l linksocket]

mfsbdev map [-l linksocket] -f mfsfile [-d nbddevice] [-n linkname] [-s bdevsize] [-b blocksize | -5 | -1 | -2 | -4] [-r] [-i]

mfsbdev unmap [-l linksocket] ( -f mfsfile | -d nbddevice | -n linkname )

mfsbdev list [-l linksocket] [-t m|u|i]

mfsbdev resize [-l linksocket] ( -f mfsfile | -d nbddevice | -n linkname ) [-s bdevsize]

توضیحات (DESCRIPTION)

این ابزار برای مدیریت دستگاه‌های بلوکی استفاده می‌شود. این ابزار فقط در لینوکس کار می‌کند. برای عملکرد صحیح این ابزار، ماژول هسته nbd باید بارگذاری شده باشد.

گزینه‌ها (OPTIONS)

-H - میزبان مستر؛ پیش‌فرض 'mfsmaster' است

-P - پورت مستر؛ پیش‌فرض '9421' است

-S - مسیر مستر (پوشه فرعی در MFS که به عنوان ریشه برای همه نگاشت‌های دستگاه بلوکی استفاده خواهد شد)؛ پیش‌فرض '/' است

-p - گذرواژه مستر؛ ناسازگار با گزینه -x (مانعة‌الجمع)؛ اگر نه -p و نه -x ارائه نشوند، ابزار تلاش می‌کند بدون گذرواژه متصل شود

-x - مسیر یک فایل حاوی گذرواژه مستر؛ ناسازگار با گزینه -p (مانعة‌الجمع)؛ اگر نه -p و نه -x ارائه نشوند، ابزار تلاش می‌کند بدون گذرواژه متصل شود

-l - مسیر سوکت ارتباطی؛ پیش‌فرض /dev/mfs/nbdsock است

-f - مسیر فایل mfs مورد استفاده برای نگاشت دستگاه بلوکی

-d - مسیر دستگاه بلوکی شبکه ('/dev/nbdX')؛ به‌طور پیش‌فرض (در صورت عدم ارائه این پارامتر) نخستین دستگاه در دسترس با دستور map استفاده می‌شود

-n - نام پیوند نمادین ایجادشده در '/dev/mfs' که به دستگاه بلوکی شبکه ایجادشده با دستور map اشاره می‌کند؛ پیش‌فرض ترکیبی از نام میزبان مستر، پورت و نام فایل mfs است

-s - اندازه دستگاه بلوکی، هر دو پسوند SI و IEC قابل استفاده هستند؛ پیش‌فرض اندازه فایلی است که دستگاه بلوکی به آن نگاشت شده است

-b - اندازه بلوک به بایت

-5 - استفاده از اندازه بلوک ۵۱۲ بایت (معادل -b 512)

-1 - استفاده از اندازه بلوک ۱۰۲۴ بایت (معادل -b 1024)

-2 - استفاده از اندازه بلوک ۲۰۴۸ بایت (معادل -b 2048)

-4 - استفاده از اندازه بلوک ۴۰۹۶ بایت (معادل -b 4096)

-r - دستگاه بلوکی را به صورت فقط‌خواندنی نگاشت می‌کند (امکان نگاشت‌های متعدد از یک فایل را فراهم می‌سازد)

-i (map) - نادیده گرفتن قفل‌ها؛ یک فایل ممکن است به بیش از یک دستگاه بلوکی نگاشت شود، هر عملیات نگاشت سعی می‌کند قفل مناسب را دریافت کند (اشتراکی برای ro، انحصاری برای rw)، اما حتی اگر قفل دریافت نشود نیز با موفقیت انجام می‌شود

-t - دستور list را وادار می‌کند اطلاعات را در قالبی آماده برای استفاده با دستور map (پارامتر m) یا دستور unmap (پارامتر u) یا قالب فایل mfsbdev.cfg در MooseFS (پارامتر i) نمایش دهد

-i (start) - استفاده از فایل پیکربندی ارائه‌شده در پارامتر برای راه‌اندازی دستگاه‌های بلوکی اولیه؛ برای قالب‌بندی فایل پیکربندی به mfsbdev.cfg(5) مراجعه کنید

-o - پارامترهای اضافی، به سبک mfsmount، پارامترهای متعددی را می‌توان با ویرگول انگلیسی (comma) جدا کرد:

mfswritecachesize=N

تعیین اندازه حافظه نهان نوشتن به مبی‌بایت (در بازه: 16..2048 - پیش‌فرض: 128)

mfsreadaheadsize=N

تعیین اندازه کل بافرهای پیش‌خوانی به مبی‌بایت (در بازه: 16..2048 - پیش‌فرض: 128)

mfsreadaheadleng=N

تعیین میزان بایت‌هایی که باید اضافی خوانده شوند (در بازه: 128KiB..2MiB - پیش‌فرض: 2097152 = 2MiB)

mfsreadaheadtrigger=N

تعیین مقدار بایت‌های خوانده‌شده متوالی که پیش‌خوانی را فعال می‌کند (پیش‌فرض: 20971520)

mfserroronlostchunk

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

mfserroronnospace

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

mfsioretries=N

تعیین تعداد دفعات تلاش مجدد قبل از بازگرداندن خطای ورودی/خروجی (پیش‌فرض: 30)

mfstimeout=N

تعیین حداکثر مهلت زمانی به ثانیه قبل از بازگرداندن خطای ورودی/خروجی (پیش‌فرض: 0 - به معنای بدون مهلت زمانی)

mfslogretry=N

تعیین حداقل شمارنده تلاش مجدد که پس از آن سیستم شروع به ثبت پیام‌های ورودی/خروجی در لاگ می‌کند (پیش‌فرض: 5)

mfsmaster=HOST

اتصال به مستر MooseFS در HOST (پیش‌فرض mfsmaster است) - معادل -H

mfsport=PORT

اتصال به مستر MooseFS در PORT (پیش‌فرض 9421 است) - معادل -P

mfsbind=IP

آدرس محلی مورد استفاده برای اتصال به مستر به جای آدرس پیش‌فرض - معادل -B

mfssubfolder=PATH

مونت کردن دایرکتوری مشخص‌شده از MooseFS (پیش‌فرض / است، یعنی کل سیستم فایل) - معادل -S

mfspassword=PASSWORD

احراز هویت در مستر MooseFS با PASSWORD

mfspreflabels=LABELEXPR

تعیین برچسب‌های ترجیحی برای انتخاب چانک‌سرورها در طول عملیات ورودی/خروجی

mfsnbdtimeout=N

تعیین حداکثر مهلت زمانی به ثانیه قبل از انصراف هسته (پیش‌فرض: 1800)

فایل‌ها (FILES)

mfsbdev.cfg

فایل پیکربندی برای دیمون دستگاه بلوکی MooseFS؛ برای جزئیات به راهنمای mfsbdev.cfg(5) مراجعه کنید

مثال‌ها (EXAMPLES)

mfsbdev start - راه‌اندازی دیمون nbd با گزینه‌های پیش‌فرض (masterhost = mfsmaster، masterport = 9421، linksocket = /dev/mfs/nbdsock، احراز هویت بدون گذرواژه)

mfsbdev start -H mfsmaster.my.domain -P 9521 -x /etc/mfs/mastersecret - راه‌اندازی دیمون nbd که به مستر mfsmaster.my.domain روی پورت 9521 با استفاده از گذرواژه خوانده‌شده از فایل /etc/mfs/mastersecret متصل می‌شود

mfsbdev stop -l /tmp/mynbdinstance - متوقف کردن دیمون nbd که از سوکت یونیکس /tmp/mynbdinstance برای ارتباط استفاده می‌کند

mfsbdev map -f devices/mybdev1.bin -s 2Ti -n mytestvm - افزودن نگاشت به دیمونی که از سوکت پیش‌فرض (/dev/mfs/nbdsock) برای ارتباط استفاده می‌کند. دستگاه به‌طور خودکار اختصاص داده می‌شود، فایل devices/mybdev1.bin به این دستگاه نگاشت شده، پیوند '/dev/mfs/mytestvm' به این دستگاه ایجاد خواهد شد و دستگاه بلوکی اندازه‌ای برابر با 2TiB خواهد داشت.

mfsbdev unmap -n mytestvm - حذف نگاشتی که پیوندی با نام mytestvm دارد (از پیوند /dev/mfs/mytestvm استفاده می‌کند).

گزارش باگ‌ها (REPORTING BUGS)

گزارش باگ‌ها به <bugs@moosefs.com>.

حق نشر (COPYRIGHT)

Copyright (C) 2026 Jakub Kruszona-Zawadzki, Saglabs SA

این فایل بخشی از MooseFS است.

نرم‌افزار MooseFS یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط مجوز عمومی همگانی گنو که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است، نسخه ۲ (صرفاً)، بازتوزیع کرده یا تغییر دهید.

نرم‌افزار MooseFS با این امید توزیع شده است که مفید باشد، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابل فروش بودن یا مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر به مجوز عمومی همگانی گنو مراجعه کنید.

شما باید به همراه این برنامه یک نسخه از مجوز عمومی همگانی گنو را دریافت کرده باشید؛ در غیر این صورت، ببینید: https://www.gnu.org/licenses.

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

mfsmount(8), mfsbdev.cfg(5)