.TH "mbuffer" "1" "R20260511" "Thomas Maier-Komor" "console utility"
.SH "نام (NAME)"
mbuffer \- ابزار بافر حافظه جهت افزایش سرعت انتقال داده‌ها بین ورودی و خروجی
.SH "خلاصه دستور (SYNOPSIS)"
.LP
mbuffer [\fIگزینه‌ها\fP]
.SH "توضیحات (DESCRIPTION)"
.LP
دستور
.B mbuffer
عملیات ورودی/خروجی (I/O) را بافر کرده و نرخ توان عملیاتی (throughput) را نمایش می‌دهد. این برنامه چندریسمانی است، از اتصالات شبکه، چندین مقصد خروجی و گزینه‌های بسیار بیشتری نسبت به دستور استاندارد
.B buffer
پشتیبانی می‌کند.
.SH "گزینه‌ها (OPTIONS)"
.LP
.TP
\fB\-b\fR <\fIتعداد\fP>
استفاده از
.I تعداد
بلوک برای بافر (مقدار پیش‌فرض در زمان راه‌اندازی تعیین می‌شود).
.TP
\fB\-s\fR <\fIاندازه\fP>
استفاده از بلوک‌هایی با
.I اندازه
بایت برای بافر (مقدار پیش‌فرض در زمان راه‌اندازی تعیین می‌شود).
.TP
\fB\-m\fR <\fIاندازه\fP>
استفاده از مجموع
.I اندازه
بایت برای بافر (پیش‌فرض ۲٪ از حافظه در دسترس) \- اندازه را می‌توان با پسوند مشخص کرد (b و B برای بایت، k برای کیلوبایت، M برای مگابایت، G برای گیگابایت و % برای درصدی از کل حافظه فیزیکی).
.TP
\fB\-L\fR
قفل کردن بافر در حافظه رم \- این گزینه برای بافرهای مبتنی بر فایل در دسترس نیست و نیازمند تنظیم مجوز set-UID root برای mbuffer است (با احتیاط استفاده شود).
.TP
\fB\-d\fR
استفاده از اندازه بلوک دستگاه برای خروجی (برای برخی دستگاه‌ها لازم است، اما سرعت خروجی را کاهش می‌دهد).
.TP
\fB\-D\fR <\fIاندازه\fP>
فرض حجم خروجی برابر با
.I اندازه
بایت (پیش‌فرض بی‌نهایت) که پس از آن تعویض حجم (volume change) آغاز می‌شود. مقادیر کوچک برای آزمایش به‌موقع اجراهای چندجلدی و مقادیر دقیق برای زمانی مناسبند که دستگاه شما پایان رسانه را به درستی اعلام نمی‌کند. اندازه را می‌توان با پسوند تعیین کرد (b و B برای بایت، k برای کیلوبایت، M برای مگابایت یا G برای گیگابایت).
.TP
\fB\-P\fR <\fIدرصد\fP>
شروع نوشتن پس از پر شدن بافر تا
.I درصد
مشخص‌شده (پیش‌فرض ۰ \- شروع فوری).
.TP
\fB\-p\fR <\fIدرصد\fP>
شروع خواندن پس از افت نسبت پر بودن بافر به زیر
.I درصد
مشخص‌شده (پیش‌فرض ۱۰۰ \- شروع فوری).
.TP
\fB\-i\fR <\fIنام_فایل\fP>
استفاده از
.I نام_فایل
به عنوان ورودی به جای ورودی استاندارد (برای پشتیبانی از چند رسانه/جلد الزامی است). اگر
.I نام_فایل
برابر با \- باشد، ورودی از ورودی استاندارد خوانده می‌شود.
.TP
\fB\-o\fR <\fIنام_فایل\fP>
استفاده از
.I نام_فایل
به عنوان خروجی به جای خروجی استاندارد (برای پشتیبانی از چند رسانه/جلد الزامی است؛ در صورت در دسترس بودن، استفاده از sendfile را فعال می‌کند). اگر
.I نام_فایل
برابر با \- باشد، خروجی در خروجی استاندارد نوشته می‌شود. گزینه
.B \-o
را می‌توان چندین بار برای مشخص کردن چندین خروجی تکرار کرد.
.TP
\fB\-\-append\fR
باز کردن فایل خروجی بعدی مشخص‌شده با گزینه
.B \-o
در حالت الحاق (append).
.TP
\fB\-\-truncate\fR
کوتاه و خالی کردن (truncate) فایل خروجی بعدی مشخص‌شده با گزینه
.B \-o
هنگام باز کردن آن.
.TP
\fB\-I\fR <\fI[میزبان:]درگاه[@رابط]\fP>
استفاده از درگاه شبکه
.I درگاه
به عنوان ورودی به جای ورودی استاندارد. اگر نام میزبان و درگاه به صورت
.I میزبان:درگاه
داده شود، تنها میزبان تعیین‌شده مجاز به اتصال است. در صورت مشخص شدن
.IR رابط ،
اتصالات تنها روی همان رابط شبکه پذیرفته می‌شوند.
.TP
\fB\-O\fR <\fIمیزبان:درگاه\fP>
نوشتن خروجی روی
.I میزبان:درگاه
به جای خروجی استاندارد (در صورت در دسترس بودن، استفاده از sendfile را فعال می‌کند). این گزینه را می‌توان چندین بار برای ارسال داده به چندین ماشین به کار برد.
.TP
\fB\-n\fR <\fIتعداد\fP>
تعداد
.I تعداد
جلد در دستگاه ورودی (نیازمند استفاده از گزینه
.B \-i
جهت مشخص کردن دستگاه ورودی است؛ در صورتی که mbuffer باید برای هر جلد جدید اعلان درخواست نمایش دهد، عدد ۰ را به عنوان آرگومان بدهید).
.TP
\fB\-t\fR
استفاده از یک فایل موقت نگاشت‌شده در حافظه (memory-mapped) به عنوان بافر (مناسب برای بافرهای بسیار بزرگ).
.TP
\fB\-T\fR <\fIفایل\fP>
مشابه
.B \-t
اما با استفاده از
.I فایل
مشخص‌شده به عنوان بافر.
.TP
\fB\-l\fR <\fIفایل\fP>
ثبت پیام‌ها در
.I فایل
به جای خروجی خطای استاندارد.
.TP
\fB\-u\fR <\fIتعداد\fP>
توقف به مدت
.I تعداد
میکروثانیه پس از هر عمل نوشتن \- ممکن است کارایی را در برخی درایوهای با سرعت بسیار پایین (کمتر از ۱ مگابایت بر ثانیه) افزایش دهد.
.TP
\fB\-r\fR <\fIنرخ\fP>
تنظیم حداکثر نرخ خواندن روی
.IR نرخ .
مقدار
.I نرخ
را می‌توان بر حسب بایت، کیلوبایت، مگابایت یا گیگابایت بر ثانیه با پسوند مناسب (مانند k, M, G) مشخص کرد. این گزینه زمانی مفید است که یک درایو نوار داده‌ها را سریع‌تر از توان پردازش میزبان انتقال می‌دهد. در این حالت می‌توانید سرعت انتقال را محدود کرده و نوار را پیوسته در حال حرکت نگه دارید. این کار هم برای درایو نوار مفید است و هم با جلوگیری از توقف و حرکت متناوب نوار، کارایی کلی را بهبود می‌بخشد.
.TP
\fB\-R\fR <\fIنرخ\fP>
مشابه گزینه بالا، ولی برای تنظیم محدودیت نرخ انتقال بخش نویسنده (خروجی).
.TP
\fB\-M\fR <\fIنرخ\fP>
تنظیم حداقل نرخ برای محدودسازی پویا نرخ انتقال. نرخ انتقال داده به صورت پویا بین مقادیر حد بالا و حد پایین (گزینه‌های
.B \-p
و
.BR \-P )
که باید آنها نیز ارائه شوند، تنظیم می‌شود.
.PP
در حالت ورودی، نرخ داده با مقدار گزینه
.B \-r
آغاز شده و بر اساس میزان پر بودن بافر تا مقدار
.B \-M
کاهش می‌یابد.
.PP
در حالت خروجی، نرخ داده به شکل مشابهی تنظیم می‌شود، اما از حداقل نرخ شروع شده و تا نرخ
.B \-R
برای خروجی افزایش می‌یابد.
.TP
\fB\-f\fR
بازنویسی روی فایل خروجی در صورتی که از قبل وجود داشته باشد.
.TP
\fB\-a\fR <\fIزمان\fP>
دستگاه مورد استفاده یک بارگذار خودکار (autoloader) است که بارگذاری نوار جدید در آن
.I زمان
ثانیه طول می‌کشد.
.TP
\fB\-A\fR <\fIدستور\fP>
دستگاه مورد استفاده یک بارگذار خودکار است که از
.I دستور
برای بارگذاری جلد بعدی استفاده می‌کند. برای جلوگیری از نمایش پیام هشدار در زمان اجرای بدون ترمینال کنترلی (مانند اجرا از طریق cron)، مقدار
.I /bin/false
را به عنوان دستور بارگذاری خودکار ارسال کنید. در این حالت بارگذاری خودکار با خطا مواجه شده و mbuffer پس از رسیدن به انتهای نوار با پیام خطا متوقف می‌شود.
.TP
\fB\-v\fR <\fIسطح\fP>
تنظیم سطح گزارش‌دهی جزئیات (verbose) روی
.IR سطح .
مقادیر معتبر بین ۰ تا ۶ هستند (۰ = هیچ، ۱ = خطاها، ۲ = هشدارها، ۴ = پیام‌های اطلاعاتی، ۵ = پیام‌های اشکال‌زدایی، ۶ = اشکال‌زدایی ورودی/خروجی). سطوح بالاتر شامل پیام‌های سطوح پایین‌تر نیز می‌شوند.
.TP
\fB\-q\fR
حالت خاموش \- وضعیت را در خروجی خطای استاندارد نمایش نده.
.TP
\fB\-Q\fR
حالت کاملاً خاموش \- وضعیت را در فایل لاگ ثبت نکن.
.TP
\fB\-c\fR
نوشتن همراه با پشتیبانی از یکپارچگی همگام داده‌ها \- این گزینه باعث می‌شود قبل از ادامه کار، تمام عملیات نوشتن کامل شوند. این امر امکان گزارش سریع‌تر و دقیق‌تر خطاها را فراهم می‌کند، اما ممکن است کارایی را کاهش دهد؛ به ویژه سیستم‌هایی با سطح بالای یکپارچگی داده دچار افت شدید کارایی می‌شوند.
.TP
\fB\-e\fR
توقف پردازش در صورت بروز هرگونه خطا.
.TP
\fB\-H, \-\-md5\fR
تولید هش MD5 از داده‌های انتقال‌یافته.
.TP
\fB\-\-hash\fR <\fIالگوریتم\fP>
استفاده از الگوریتم
.IR الگوریتم ؛
اگر مقدار
.I list
داده شود، لیست الگوریتم‌های پشتیبانی‌شده نمایش داده می‌شود.
.TP
\fB\-\-pid\fR
چاپ شناسه فرآیند (PID) این نمونه. این گزینه در شناسایی و بستن نمونه‌ای از mbuffer که به دلیل مشکل شبکه متوقف شده است، کمک می‌کند. چاپ PID را می‌توان با افزودن عبارت "printpid = 1" در فایل
.I .mbuffer.rc
نیز فعال کرد.
.TP
\fB\-W\fR <\fIمهلت\fP>
فعال‌سازی ناظر (watchdog) که هر
.I مهلت
ثانیه بررسی می‌کند آیا فعالیت ورودی/خروجی متوقف شده است یا خیر. اگر هر کانال به اندازه یک دوره کامل متوقف بماند، ناظر پیامی نوشته و mbuffer را با سیگنال SIGINT متوقف می‌کند. توجه داشته باشید که ناظر از عملیات تعویض نوار آگاه نیست؛ بنابراین مهلت ناظر را بیشتر از بدترین زمان تعویض نوار تعیین کنید. ناظر پس از پردازش گزینه
.B \-W
یا پس از پردازش تمام گزینه‌ها فعال می‌شود. برای جلوگیری از فعال شدن ناظر در حین راه‌اندازی شبکه، گزینه
.B \-W
را پس از
.B \-I
و
.B \-O
قرار دهید.
.TP
\fB\-4\fR
اجبار به استفاده از پروتکل IPv4 برای گزینه‌های ورودی/خروجی شبکه در خط فرمان.
.TP
\fB\-6\fR
اجبار به استفاده از پروتکل IPv6 برای گزینه‌های ورودی/خروجی شبکه در خط فرمان.
.TP
\fB\-0\fR
انتخاب خودکار بین IPv4/IPv6 بر حسب نیاز.
.TP
\fB\-\-no\-direct\fR
عدم استفاده از O_DIRECT \- به عنوان مثال برای فعال‌سازی فشرده‌سازی در فایل‌سیستم btrfs.
.TP
\fB\-\-tcpbuffer\fR
اندازه بافر TCP بر حسب بایت. اندازه را می‌توان با پسوند مشخص کرد (b و B برای بایت، k برای کیلوبایت، M برای مگابایت یا G برای گیگابایت).
.TP
\fB\-\-tcptimeo\fR <\fIزمان\fP>
تنظیم آستانه مهلت زمانی TCP. مقدار پیش‌فرض 10s است. مقادیر بدون واحد به صورت میکروثانیه تفسیر می‌شوند. واحدهای معتبر عبارتند از: us, ms, s یا sec, m یا min, h.
.TP
\fB\-\-tapeaware\fR
ادامه نوشتن تا آخرین نقطه ممکن از نوار. درایوهای LTO با نزدیک شدن به انتهای نوار به سیستم‌عامل اطلاع می‌دهند و لینوکس با بازگرداندن خطای 'no space left' در هر دو عملیات نوشتن، این موضوع را به فضای کاربری منتقل می‌کند. به طور معمول اولین خطا به منزله پایان نوار در نظر گرفته شده و نوار بعدی درخواست می‌شود، اما با این گزینه، نوشتن تا زمانی که دو بار متوالی خطای 'no space left' رخ دهد ادامه می‌یابد که نشان‌دهنده پایان واقعی نوار است. این کار امکان قرارگیری مقدار کمی داده بیشتر روی هر نوار را فراهم می‌کند.
.TP
\fB\-\-direct\fR
استفاده از ورودی/خروجی مستقیم (Direct I/O) برای بافر فایل موقت.
.TP
\fB\-h, \-\-help\fR
نمایش اطلاعات راهنما و خروج.
.TP
\fB\-V, \-\-version\fR
نمایش اطلاعات نسخه و خروج.
.SH "مقادیر پیش‌فرض (DEFAULT VALUES)"
مقادیر پیش‌فرض اکثر گزینه‌ها را می‌توان به صورت جفت‌های
.I کلید = مقدار
در یک یا چند فایل پیکربندی تنظیم کرد. فایل‌های نمونه
.I mbuffer.rc
را برای مشاهده گزینه‌های موجود و مقادیر پیش‌فرض آنها بررسی کنید. فایل‌های پیکربندی به ترتیب زیر خوانده می‌شوند:
.LP
.br
- \fI/etc/mbuffer.rc\fR
.br
- \fB$PREFIX\fI/etc/mbuffer.rc\fR
.br
- \fB$HOME\fI/.mbuffer.rc\fR
.br
- \fB$MBUFFERRC\fR
.br
.LP
مقادیر پیش‌فرض داده‌شده در فایل‌های بالا توسط گزینه‌های ارسال‌شده در خط فرمان بازنویسی می‌شوند.

.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
اگر متغیر
.B TMPDIR
تنظیم شده باشد، mbuffer فضای ذخیره‌سازی بافرهای مبتنی بر فایل را در این دایرکتوری اختصاص می‌دهد. در صورت تنظیم نبودن TMPDIR، مسیر
.I /var/tmp
استفاده خواهد شد.
.br
\fBMBUFFERRC\fP برای مشخص کردن فایل پیکربندی سفارشی mbuffer.rc استفاده می‌شود.
.br
\fBMBUFFER_VOL\fP اطلاعات شناسه جلد (برای دستور بارگذاری خودکار تنظیم می‌شود).
.br
\fBMBUFFER_NUMIN\fP تعداد بایت‌های خوانده‌شده (برای دستور بارگذاری خودکار تنظیم می‌شود).
.br
\fBMBUFFER_NUMOUT\fP تعداد بایت‌های نوشته‌شده (برای دستور بارگذاری خودکار تنظیم می‌شود).

.SH "فایل‌ها (FILES)"
.LP
\fI$PREFIX/bin/mbuffer\fP
.br
\fI/var/tmp/mbuffer-*\fP
.br
\fI~/.mbuffer.rc\fP
.SH "مثال‌ها (EXAMPLES)"
.LP
برای اجرای این برنامه با گزینه‌های پیش‌فرض کافی است تایپ کنید:
.LP
mbuffer
.LP
.LP
استفاده از mbuffer برای پشتیبان‌گیری با tar روی دستگاه نوار پیش‌فرض. گزینه‌های این مثال: فایل موقت نگاشت‌شده در حافظه با اندازه ۱۰ مگابایت، شروع نوشتن پس از پر شدن ۸۰٪ بافر.
.LP
tar cf \- mydirectory | gzip | mbuffer \-t \-m 10M \-P 80 \-f \-o $TAPE
.LP
.LP
استفاده از mbuffer با ۳ نوار به عنوان ورودی و استخراج محتویات در دایرکتوری کاری جاری:
.LP
mbuffer \-n 3 \-i $TAPE | gzip \-dc | tar xf \-
.LP
.LP
استفاده از mbuffer برای نوشتن روی چندین جلد نوار:
.LP
tar cf \- /usr | mbuffer \-f \-o $TAPE
.LP
.LP
نوشتن روی چندین نوار و پاک کردن هر نوار قبل از نوشتن:
.LP
tar cf \- /usr | mbuffer \-A "echo next tape; read a < /dev/tty; mt erase $TAPE" \-f \-o $TAPE
.LP
.LP
ایجاد پشتیبان از طریق شبکه:
.LP
\fIسرور نوار: \fPmbuffer \-I 8000 \-f \-o $TAPE
.LP
\fIکلاینت پشتیبان: \fPtar zcf \- /home | mbuffer \-O tapeserver:8000
.LP
.LP
توزیع یک درخت دایرکتوری روی چندین ماشین:
.LP
\fIسرور اصلی: \fPtar cf \- /tree_to_clone | mbuffer \-O clone0:8000 \-O clone1:8000
.LP
\fIکلاینت‌ها: \fPmbuffer \-I master:8000 | tar xf \-
.LP
.LP
کار با درایو نوار با مقیاس‌بندی پویای سرعت:
.LP
tar cf - / | mbuffer -o /dev/tape -p20% -p80% -M 50M -R 120M
.LP
mbuffer -i /dev/tape -p20% -p80% -M 50M -r 120M | tar xf -
.LP
.LP
.SH "کد خروج (EXITCODE)"
.LP
برنامه
.B mbuffer
در صورت موفقیت مقدار ۰ را برمی‌گرداند. هرگونه خطا منجر به مقدار خروج غیرصفر خواهد شد.
.SH "نویسندگان (AUTHORS)"
.LP
Thomas Maier\-Komor <thomas@maier\-komor.de>
.SH "حمایت مالی (DONATIONS)"
.LP
اگر این نرم‌افزار را می‌پسندید و در شرکت خود برای مقاصد تولیدی از آن استفاده می‌کنید، لطفاً برای حمایت از این پروژه کمک مالی در نظر بگیرید.
می‌توانید مستقیماً از طریق PayPal به آدرس ایمیل نویسنده
(thomas@maier\-komor.de)
کمک مالی واریز کنید.
.SH "صفحه خانگی (HOMEPAGE)"
.LP
<http://www.maier\-komor.de/mbuffer.html>
.SH "مجوز (LICENSE)"
.LP
این نرم‌افزار تحت مجوز عمومی گنو نسخه ۳ (GNU General Public License V3) منتشر شده است. برای جزئیات به فایل LICENSE مراجعه کنید.
.SH "همچنین ببینید (SEE ALSO)"
.LP
.BR buffer (1)