.TH SCSI_CH_SWP "8" "May 2013" "sdparm\-1.08" SDPARM
.SH "نام (NAME)"
scsi_ch_swp \- تغییر وضعیت محافظت از نوشتن نرم‌افزاری SCSI و تنظیمات دستگاه بلوکی
.SH "خلاصه دستور (SYNOPSIS)"
.B scsi_ch_swp
[\fI\-\-help\fR] [\fI\-\-set 0|1\fR] [\fI\-\-verbose\fR] [\fI\-\-wr\fR]
\fIBLK_DEVICE\fR
.SH "توضیحات (DESCRIPTION)"
.PP
این اسکریپت شل bash تلاش می‌کند بیت محافظت از نوشتن نرم‌افزاری (SWP یا Software Write Protect) را در صفحه حالت Control مربوط به SCSI با استفاده از ابزار sdparm بخواند یا تغییر دهد. اگر این تغییر موفقیت‌آمیز باشد، از ابزار blockdev برای هماهنگ‌سازی و تغییر وضعیت خواندن\-نوشتن (read\-write) یا فقط‌خواندنی (read\-only) برای \fIBLK_DEVICE\fR استفاده می‌کند. این اسکریپت فقط در لینوکس در دسترس است، زیرا ابزار blockdev مختص لینوکس است.
.PP
اگر تغییر بیت SWP پشتیبانی شود، فعال کردن بیت SWP باعث می‌شود \fIBLK_DEVICE\fR در خود دستگاه (دیسک) به حالت فقط‌خواندنی درآید. پاک کردن بیت SWP باعث می‌شود \fIBLK_DEVICE\fR در حالت خواندن\-نوشتن قرار گیرد، که معمولاً تنظیم پیش‌فرض هنگام روشن شدن دستگاه (دیسک) است.
.PP
اگر هیچ گزینه‌ای مشخص نشود، وضعیت کنونی بیت SWP (با استفاده از sdparm) به همراه بیت RO از blockdev نمایش داده می‌شود. اگر هر دو 1 باشند، \fIBLK_DEVICE\fR در حالت فقط‌خواندنی است؛ و اگر هر دو 0 باشند، \fIBLK_DEVICE\fR در حالت خواندن\-نوشتن است.
.SH "گزینه‌ها (OPTIONS)"
آرگومان‌های گزینه‌های طولانی برای گزینه‌های کوتاه نیز اجباری هستند.
.TP
\fB\-h\fR, \fB\-\-help\fR
چاپ پیام راهنمای استفاده و خروج.
.TP
\fB\-s\fR, \fB\-\-set\fR \fI0|1\fR
هنگامی که 0 داده شود، بیت SWP در صفحه حالت Control با استفاده از sdparm پاک می‌شود (یعنی مقدار آن 0 می‌شود)؛ و از blockdev برای تنظیم \fIBLK_DEVICE\fR در حالت خواندن\-نوشتن استفاده می‌شود. هنگامی که 1 داده شود، بیت SWP در صفحه حالت Control با استفاده از sdparm تنظیم می‌شود؛ و از blockdev برای تنظیم \fIBLK_DEVICE\fR در حالت فقط‌خواندنی استفاده می‌شود. رفتار پیش‌فرض (یعنی هنگامی که این گزینه داده نشود) خواندن وضعیت بیت SWP و حالت فقط‌خواندنی \fIBLK_DEVICE\fR و چاپ این مقادیر است.
.TP
\fB\-v\fR, \fB\-\-verbose\fR
افزایش سطح جزئیات خروجی.
.TP
\fB\-w\fR, \fB\-\-wr\fR
هنگامی که \fIBLK_DEVICE\fR در حالت فقط‌خواندنی است، لینوکس معمولاً اجازه باز کردن \fIBLK_DEVICE\fR به صورت خواندن\-نوشتن توسط sdparm را نمی‌دهد، بنابراین اقدام پیش‌فرض این اسکریپت استفاده از گزینه \fI\-\-readonly\fR در sdparm هنگام فراخوانی \fI\-\-set 0\fR است. این امکان وجود دارد که \fIBLK_DEVICE\fR یک دستگاه عمومی (مانند /dev/sg3) باشد که تفسیر متفاوتی از پرچم باز کردن به صورت فقط‌خواندنی دارد و ممکن است با شکست مواجه شود. برای چنین موارد نادری، گزینه \fI\-\-wr\fR باعث می‌شود sdparm هنگام فراخوانی \fI\-\-set 0\fR، \fIBLK_DEVICE\fR را به صورت خواندن\-نوشتن باز کند.
.SH "وضعیت خروج (EXIT STATUS)"
وضعیت خروج این اسکریپت در صورت موفقیت 0 است. در غیر این صورت، وضعیت خروج برابر با مقدار بازگشتی ابزار sdparm یا blockdev (هرکدام که در آخر فراخوانی شده باشد) خواهد بود. صفحه راهنمای sdparm(8) را ببینید.
.SH "نویسندگان (AUTHORS)"
نوشته‌شده توسط D. Gilbert
.SH "حق نشر (COPYRIGHT)"
کپی‌رایت \(co 2013 Douglas Gilbert
.br
این نرم‌افزار تحت مجوز FreeBSD توزیع می‌شود. هیچ ضمانتی وجود ندارد؛ حتی برای قابلیت تجاری یا تناسب با یک هدف خاص.
.SH "همچنین ببینید (SEE ALSO)"
.B sdparm(sdparm), blockdev(8)