.TH SG_TEST_RWBUF "8" "January 2018" "sg3_utils\-1.43" SG3_UTILS
.SH "نام (NAME)"
sg_test_rwbuf \- آزمایش آداپتور میزبان SCSI با صدور نوشتن‌ها و خواندن‌های ساختگی
.SH "خلاصه دستور (SYNOPSIS)"
.B sg_test_rwbuf
[\fI\-\-addrd=AR\fR] [\fI\-\-addwr=AW\fR] [\fI\-\-help\fR]
[\fI\-\-quick\fR] \fI\-\-size=SZ\fR [\fI\-\-times=NUM\fR] [\fI\-\-verbose\fR]
[\fI\-\-version\fR] \fIDEVICE\fR
.PP
یا قالب قدیمی منسوخ‌شده
.B sg_test_rwbuf
\fIDEVICE\fR \fISZ\fR [\fIAW\fR] [\fIAR\fR]
.SH "توضیحات (DESCRIPTION)"
دستور sg_test_rwbuf مقدار \fISZ\fR بایت را در بافر داخلی \fIDEVICE\fR (مانند /dev/sda یا /dev/sg0) نوشته و بازخوانی می‌کند. یک الگوی شبه‌تصادفی در بافر داده دستگاه نوشته شده و سپس بازخوانی می‌شود. در صورت یکسان بودن الگو، عبارت «Success» گزارش می‌شود. اگر مطابقت نداشته باشند (برابر نبودن مجموع مقابله‌ای یا چکسام)، این مورد گزارش شده و حداکثر ۲۴ بایت از اولین نقطه عدم تطابق گزارش می‌گردد؛ خط اول داده نوشته‌شده و خط دوم داده دریافت‌شده را نشان می‌دهد. برای مقاصد آزمایشی، می‌توان از آن خواست که \fIAW\fR بایت اضافی بنویسد یا \fIAR\fR بایت اضافی بخواند.
.SH "گزینه‌ها (OPTIONS)"
آرگومان‌های گزینه‌های طولانی برای گزینه‌های کوتاه نیز الزامی هستند.
.TP
\fB\-r\fR, \fB\-\-addrd\fR=\fIAR\fR
خواندن \fIAR\fR بایت اضافی (بیش از مقدار مشخص‌شده با \fISZ\fR) از بافر داده. مجموع مقابله‌ای روی نخستین \fISZ\fR بایت انجام می‌شود.
.TP
\fB\-w\fR, \fB\-\-addwr\fR=\fIAW\fR
نوشتن \fIAW\fR بایت صفر اضافی (بیش از مقدار مشخص‌شده با \fISZ\fR) در بافر داده. مجموع مقابله‌ای روی نخستین \fISZ\fR بایت تولید می‌شود.
.TP
\fB\-h\fR, \fB\-\-help\fR
چاپ پیام راهنمای نحوه استفاده و سپس خروج.
.TP
\fB\-q\fR, \fB\-\-quick\fR
اجرای دستور توصیف‌گر READ BUFFER برای یافتن طول و آفست در دسترس بافر داده، چاپ آن‌ها و سپس خروج (بدون انجام آزمایش با توالی‌های نوشتن/خواندن).
.TP
\fB\-s\fR, \fB\-\-size\fR=\fISZ\fR
که در آن \fISZ\fR اندازه بافر به بایت جهت نوشتن، سپس خواندن و بررسی است. این عدد باید کوچک‌تر یا مساوی با اندازه بافر داده دستگاه باشد که با گزینه \fI\-\-quick\fR قابل مشاهده است. باید این گزینه یا گزینه \fI\-\-quick\fR مشخص شود.
.TP
\fB\-t\fR, \fB\-\-times\fR=\fINUM\fR
که در آن \fINUM\fR تعداد دفعات تکرار آزمایش نوشتن/خواندن روی بافر است. مقدار پیش‌فرض ۱ است.
.TP
\fB\-v\fR, \fB\-\-verbose\fR
افزایش سطح جزئیات خروجی.
.TP
\fB\-V\fR, \fB\-\-version\fR
چاپ شماره نسخه (و تاریخ آخرین تغییر) و سپس خروج.
.SH "نکات (NOTES)"
میکروکد در یک دستگاه SCSI با اجرای دستور WRITE BUFFER با حالت تنظیم‌شده روی «data» (0x2) که توسط این ابزار انجام می‌شود، تغییر \fBنمی‌کند\fR. بنابراین این ابزار از این جهت ایمن است. [مقادیر حالت 0x4، 0x5، 0x6 و 0x7 مقادیر خطرناک هستند :\-)]
.PP
\fBهشدار\fR: اگر هم‌زمان به دستگاه دسترسی داشته باشید (مثلاً به دلیل این‌که دیسک سختی با سیستم‌فایل مانت‌شده روی آن است)، ممکن است بافر دستگاه هم‌زمان توسط خود دستگاه برای داده‌های دیگر استفاده شود و بازنویسی آن ممکن است باعث خرابی داده‌ها شود یا نشود! \fBبا این حال\fR، پیش‌نویس استاندارد SPC\-3 در دستور WRITE BUFFER خود بیان می‌کند: «این دستور در صورت مشخص شدن حالت data ... نباید هیچ واسطی از واحد منطقی را تغییر دهد». این نشان می‌دهد که استفاده از این ابزار با دستگاه‌هایی که سیستم‌فایل مانت‌شده روی آن‌ها دارند ایمن \fBاست\fR.
با ادامه این موضوع، یک دیسک با سیستم‌فایل‌های فعال مانت‌شده ممکن است باعث شود داده‌های بازخوانی‌شده (به دلیل فعالیت حافظه پنهان یا کش) با آنچه نوشته شده بود متفاوت باشد و در نتیجه خطای مجموع مقابله‌ای رخ دهد.
.SH "وضعیت خروج (EXIT STATUS)"
وضعیت خروج sg_test_rwbuf در صورت موفقیت 0 است. در غیر این صورت به صفحه راهنمای sg3_utils(8) مراجعه کنید.
.SH "نویسندگان (AUTHORS)"
نوشته‌شده توسط D. Gilbert و K. Garloff
.SH "حق نشر (COPYRIGHT)"
حق نشر \(co 2000\-2018 Douglas Gilbert, Kurt Garloff
.br
این نرم‌افزار تحت مجوز GPL نسخه ۲ توزیع می‌شود. هیچ ضمانتی وجود ندارد؛ حتی برای قابلیت فروش یا تناسب با یک هدف خاص.