.TH SG_START "8" "April 2021" "sg3_utils\-1.47" SG3_UTILS
.SH "نام (NAME)"
sg_start \- ارسال دستور SCSI START STOP UNIT: راه‌اندازی، متوقف‌سازی، بارگذاری یا خروج رسانه
.SH "خلاصه دستور (SYNOPSIS)"
.B sg_start
[\fI0\fR] [\fI1\fR] [\fI\-\-eject\fR] [\fI\-\-help\fR] [\fI\-\-fl=FL\fR]
[\fI\-\-immed\fR] [\fI\-\-load\fR] [\fI\-\-loej\fR] [\fI\-\-mod=PC_MOD\fR]
[\fI\-\-noflush\fR] [\fI\-\-pc=PC\fR] [\fI\-\-readonly\fR] [\fI\-\-start\fR]
[\fI\-\-stop\fR] [\fI\-\-verbose\fR] [\fI\-\-version\fR] \fIDEVICE\fR
.PP
.B sg_start
[\fI\-\-eject\fR] [\fI\-\-fl=FL\fR] [\fI\-i\fR] [\fI\-\-imm=0|1\fR]
[\fI\-\-load\fR] [\fI\-\-loej\fR] [\fI\-\-mod=PC_MOD\fR] [\fI\-\-noflush\fR]
[\fI\-\-pc=PC\fR] [\fI\-r\fR] [\fI\-\-start\fR] [\fI\-\-stop\fR] [\fI\-v\fR]
[\fI\-V\fR] [\fI0|1\fR] \fIDEVICE\fR
.SH "توضیحات (DESCRIPTION)"
دستور
.B sg_start
دستور SCSI START STOP UNIT را به همراه گزینه‌های انتخاب‌شده به
.I DEVICE
ارسال می‌کند. پرکاربردترین گزینه‌ها عبارتند از
.I \-\-stop
برای متوقف کردن چرخش دیسک (spin down) و
.I \-\-start
برای چرخاندن و راه‌اندازی دیسک (spin up). استفاده از
.I \-\-start
روی دیسکی که در حال حاضر می‌چرخد بی‌ضرر است. همچنین کنترل دقیق‌تری با «وضعیت مصرف انرژی» (power condition) وجود دارد: فعال (active)، آماده‌به‌کار (idle) یا حالت انتظار (standby). این حالت با گزینه
.I \-\-pc=PC
تنظیم می‌شود. در برخی زمینه‌ها وضعیت «stop» را نیز می‌توان به عنوان یک وضعیت مصرف انرژی اضافی در نظر گرفت.
.PP
دستگاه‌هایی که شامل رسانه‌های جداشدنی مانند CD/DVD هستند می‌توانند از گزینه
.I \-\-loej
همراه با
.I \-\-start
برای بارگذاری رسانه استفاده کنند (یعنی بارگذاری رسانه و سپس شروع چرخش). همچنین می‌توان از
.I \-\-loej
همراه با
.I \-\-stop
برای بیرون دادن رسانه استفاده کرد (یعنی توقف چرخش و سپس خروج رسانه). به شکلی ساده‌تر، بارگذاری یا بیرون دادن رسانه جداشدنی را می‌توان با گزینه‌های
.I \-\-load
یا
.I \-\-eject
درخواست کرد.
.PP
اگر هیچ گزینه یا آرگومانی مشخص نشود، همان‌طور که از نام ابزار پیداست، فرض بر اعمال
.I \-\-start
خواهد بود.
.PP
این ابزار از دو نحو خط فرمان پشتیبانی می‌کند؛ نحو ترجیحی ابتدا در خلاصه دستور نشان داده شده و در این بخش توضیح داده می‌شود. در بخش بعدی درباره نحو قدیمی خط فرمان، گروه دوم گزینه‌ها شرح داده شده است.
.PP
نکته لینوکس: بهتر است برای گزینه
.I \-\-stop
از نام‌های استاندارد دستگاه بلوکی (مانند
.BR /dev/sdc )
استفاده نکنید. در عوض از یک گره دستگاه sg یا bsg استفاده نمایید (به
.BR lsscsi (8)
مراجعه کنید). لایه بلوکی گاهی متوجه متوقف شدن چرخش دیسک می‌شود و با تصور اینکه «این وضعیت درست نیست»، دوباره دیسک را به چرخش درمی‌آورد!
.SH "گزینه‌ها (OPTIONS)"
آرگومان‌های گزینه‌های طولانی برای گزینه‌های کوتاه نیز الزامی هستند.
.TP
\fB0\fR
همان عملکرد
.IR \-\-stop .
.TP
\fB1\fR
همان عملکرد
.IR \-\-start .
.TP
\fB\-e\fR, \fB\-\-eject\fR
متوقف کردن رسانه و بیرون دادن آن از درایو. تنها برای دستگاه‌های دارای رسانه جداشدنی مناسب است. ممکن است نادیده گرفته شود (جلوگیری شود)، به توضیحات زیر مراجعه کنید. توجه داشته باشید که این عملیات برای درایوهای نوار مغناطیسی (tape) یا پخش‌کننده‌های CD/DVD/BD قابل انجام است، نه برای دیسک‌های سخت یا SSD!
.TP
\fB\-h\fR, \fB\-\-help\fR
نمایش پیام راهنمای استفاده و خروج.
.TP
\fB\-f\fR, \fB\-\-fl\fR=\fIFL\fR
شماره لایه فرمت دیسک را برای «پرش» به آن تنظیم می‌کند (تعریف‌شده در MMC\-5). مقادیر
.I FL
می‌توانند بین 0 تا 3 باشند. هنگامی که این گزینه انتخاب می‌شود، بیت‌های FL ،LoEj و Start در cdb همان‌گونه که توسط MMC\-5 الزامی شده تنظیم می‌شوند؛ بنابراین نیازی نیست کاربر گزینه‌های
.I \-\-start
و/یا
.I \-\-load
را تنظیم کند.
.TP
\fB\-i\fR, \fB\-\-immed\fR
بیت IMM را در دستور START STOP UNIT فعال می‌کند تا این ابزار بی‌درنگ بازگردد و منتظر تکمیل عمل درخواستی توسط رسانه نماند. حالت پیش‌فرض این است که تا زمان اتمام عمل درخواستی توسط رسانه منتظر بماند و سپس بازگردد.
.TP
\fB\-l\fR, \fB\-\-load\fR
بارگذاری رسانه در درایو و شروع آن. تنها برای رسانه‌های جداشدنی مناسب است.
.TP
\fB\-L\fR, \fB\-\-loej\fR
بیت LOEJ را در دستور START STOP UNIT تنظیم می‌کند. این کار هنگام راه‌اندازی واحد باعث بارگذاری رسانه، یا هنگام توقف واحد باعث خروج رسانه می‌شود (یعنی هماهنگ با بیت START در cdb کار می‌کند). این گزینه در صورتی که «pc > 0» باشد نادیده گرفته می‌شود. حالت پیش‌فرض غیرفعال است (یعنی تلاشی برای بارگذاری یا خروج رسانه انجام نمی‌شود). اگر نشانه‌ای از شروع یا توقف داده نشده باشد (یعنی نه
.I \-\-start
و نه
.IR \-\-stop )
و این گزینه داده شود، عملیات بارگذاری و شروع فرض می‌شود.
.TP
\fB\-m\fR, \fB\-\-mod\fR=\fIPC_MOD\fR
که در آن
.I PC_MOD
مقدار «تعدیل‌کننده وضعیت مصرف انرژی» (power condition modifier) است. مقادیر معتبر بین 0 تا 15 (شامل خودشان) هستند و پیش‌فرض 0 است. این فیلد در cdb پس از sbc3r13 افزوده شد.
.TP
\fB\-n\fR, \fB\-\-noflush\fR
پیش از اجرای نگارشی از این ابزار که دسترسی به رسانه را محدود می‌کند، عمل تخلیه بافر به رسانه (مانند کاری که SYNCHRONIZE CACHE انجام می‌دهد) را انجام ندهد. استفاده از گزینه
.B \-\-stop
نمونه‌ای از اعمال محدودیت بر دسترسی به رسانه است. این فیلد 'noflush' در cdb پس از sbc3r13 اضافه شد.
.TP
\fB\-O\fR, \fB\-\-old\fR
جابه‌جایی به گزینه‌های به سبک قدیمی‌تر. لطفاً به عنوان اولین گزینه استفاده شود.
.TP
\fB\-p\fR, \fB\-\-pc\fR=\fIPC\fR
که در آن
.I PC
مقدار «وضعیت‌های مصرف انرژی» (power conditions) است. مقادیر 0 تا 15 (شامل خودشان) معتبر هستند. مقدار پیش‌فرض 0 است. هنگامی که «\-\-pc=0» باشد، گزینه‌های
.BR \-\-eject ،
.BR \-\-load ،
.BR \-\-loej ،
.B \-\-start
و
.B \-\-stop
فعال هستند. برخی مقادیر متداول عبارتند از: 1 برای وضعیت مصرف انرژی «active» در SBC؛ 2 برای وضعیت انرژی «idle»؛ 3 برای وضعیت انرژی «standby»؛ 5 برای وضعیت انرژی «sleep» در MMC؛ 7 برای LU_CONTROL در SBC؛ مقدار 0xa (عدد 10 ده‌دهی) برای FORCE_IDLE_0 در SBC؛ و 0xb (عدد 11 ده‌دهی) برای FORCE_STANDBY_0 در SBC. برای اطلاعات بیشتر به پیش‌نویس‌های اخیر SBC\-3 ،MMC\-5 و SAS در www.t10.org مراجعه کنید.
.TP
\fB\-r\fR, \fB\-\-readonly\fR
باز کردن
.I DEVICE
در حالت فقط‌خواندنی. ممکن است در لینوکس برای جلوگیری از چرخش ناخواسته مجدد در صورتی که
.I DEVICE
یک دیسک ATA باشد لازم باشد. این چرخش ناخواسته ممکن است در پایان این دستور رخ داده و اثر گزینه
.I \-\-stop
را خنثی کند.
.TP
\fB\-s\fR, \fB\-\-start\fR
راه‌اندازی و چرخاندن (spin\-up) دستگاه
.IR DEVICE .
این گزینه بیت START را در cdb تنظیم می‌کند. استفاده از این گزینه روی دستگاهی که از قبل شروع به کار کرده بی‌ضرر است. در غیاب سایر گزینه‌ها، این گزینه به صورت پیش‌فرض انتخاب می‌شود (یعنی تنظیم بیت START در cdb).
.TP
\fB\-S\fR, \fB\-\-stop\fR
متوقف کردن چرخش (spin\-down) دستگاه
.IR DEVICE .
این گزینه بیت START را در cdb پاک می‌کند. این عملیات معمولاً بر روی دیسک سخت یا SSD انجام می‌شود. در مورد SSD، آن را در حالت مصرف انرژی کم قرار می‌دهد و ممکن است بعداً پیش از امکان ازسرگیری مجدد ورودی/خروجی عادی، نیاز به یک عملیات شروع (start) باشد.
.TP
\fB\-v\fR, \fB\-\-verbose\fR
افزایش سطح جزئیات خروجی. می‌تواند چندین بار استفاده شود.
.TP
\fB\-V\fR, \fB\-\-version\fR
نمایش اطلاعات نسخه و خروج.
.SH "نکات (NOTES)"
برای جلوگیری از سردرگمی، تنها باید یکی از گزینه‌های
.IR 0 ،
.IR 1 ،
.IR \-\-eject ،
.IR \-\-load ،
.I \-\-start
یا
.I \-\-stop
مشخص شود.
.PP
یک صفحه حالت (mode page) مرتبط با «وضعیت مصرف انرژی» (0x1a) وجود دارد که در آن می‌توان مقادیر تایمر را برای انتقال به حالت آماده‌به‌کار (idle) یا انتظار (standby) پس از مدتی عدم فعالیت تنظیم کرد. از ابزار sdparm می‌توان برای مشاهده این صفحه حالت وضعیت انرژی و در صورت نیاز تغییر آن استفاده کرد. اگر یک
.I DEVICE
در وضعیت انرژی idle یا standby باشد، دستور REQUEST SENSE (ابزار sg_requests را ببینید) در دستگاه‌های SCSI جدید باید sense key با مقدار «no sense» و یک sense code اضافی با عنوان «Low power condition on» بازگرداند.
.PP
بیرون دادن رسانه جداشدنی (مانند 'sg_start \-\-eject /dev/hdd' که در آن
.I DEVICE
یک درایو ATAPI cd/dvd است) ممکن است توسط یک دستور قبلی SCSI PREVENT ALLOW MEDIUM REMOVAL مهار شده باشد (به sg_prevent مراجعه کنید). در این حالت، این ابزار با خطایی که توسط دستگاه تولید می‌شود شکست خواهد خورد:
illegal request / medium removal prevented.
این محدودیت را می‌توان با استفاده از sg_prevent یا مثلاً با دستور
.B 'sdparm \-\-command=unlock /dev/hdd'
لغو کرد.
.PP
دستور SCSI TEST UNIT READY می‌تواند برای آگاهی از اینکه آیا یک
.I DEVICE
برای انتقال داده آماده است یا خیر استفاده شود. اگر رسانه چرخشی متوقف شده باشد یا هنوز به سرعت نامی نرسیده باشد، دستور TEST UNIT READY کلید sense با مقدار «not ready» و یک کد sense اضافی با اطلاعات بیشتر بازخواهد گرداند. ابزار sg_turs را ببینید.
.PP
در سری ۲.۴ هسته لینوکس،
.I DEVICE
باید یک دستگاه عمومی اسکازی (sg) باشد. در سری ۲.۶ دستگاه‌های بلوکی (مانند دیسک‌های SCSI و درایوهای DVD) نیز می‌توانند مشخص شوند. برای نمونه "sg_start 0 /dev/sda" در هسته‌های سری ۲.۶ کار خواهد کرد.
.PP
در سری ۲.۶ لینوکس، به ویژه با دیسک‌های ATA، استفاده از این ابزار برای متوقف کردن (spin down) دیسک ممکن است کافی نباشد و سازوکارهای دیگر پس از مدتی دیسک را مجدداً راه‌اندازی کنند. کاربر می‌تواند علاوه بر این، دیسک را با دستور
.B 'echo offline > /sys/block/sda/device/state'
به عنوان "offline" نشانه‌گذاری کند که در آن sda نام بلوکی دیسک است. برای شروع مجدد دیسک، می‌توان "offline" را با "running" جایگزین کرد. توجه داشته باشید که با تنظیم 'state' به offline، هیچ دستور SCSI نمی‌تواند به دستگاه ارسال شود تا زمانی که مجدداً روی running تنظیم گردد. همچنین متوقف کردن دیسک از طریق یک رابط عبورمستقیم (pass\-through) (مانند
.B /dev/sg1
یا
.BR /dev/bsg/1:0:0:0 )
ممکن است اثرات جانبی ناخواسته (مانند راه‌اندازی مجدد آن پس از اتمام این ابزار) را کاهش دهد.
.SH "وضعیت خروج (EXIT STATUS)"
وضعیت خروج
.B sg_start
در صورت موفقیت 0 است. در غیر این صورت به صفحه راهنمای
.BR sg3_utils (8)
مراجعه کنید.
.SH "گزینه‌های قدیمی خط فرمان (OLDER COMMAND LINE OPTIONS)"
گزینه‌های این بخش تنها مواردی بودند که پیش از نسخه 1.23 بسته sg3_utils در دسترس بودند. از آن زمان این ابزار به صورت پیش‌فرض از گزینه‌های جدیدتر خط فرمان استفاده می‌کند که می‌توان با استفاده از
.I \-\-old
(یا
.IR \-O )
به عنوان اولین گزینه، این رفتار را تغییر داد. برای راهکار دیگر جهت اجبار به استفاده از این گزینه‌های قدیمی خط فرمان، به بخش «متغیرهای محیطی» مراجعه فرمایید.
.PP
توجه داشته باشید که عملکرد
.I \-\-loej
در رابط قدیمی‌تر اندکی متفاوت است: هنگامی که نه
.I \-\-start
و نه
.I \-\-stop
(و نه معادل‌های آن‌ها) داده نشده باشند،
.I \-\-loej
عملیات خروج رسانه (eject) را انجام می‌دهد. در موقعیت مشابه، رابط جدیدتر عملیات بارگذاری (load) را اجرا می‌کند.
.PP
نسخه‌های پیشین sg_start دارای گزینه '\-s' برای اجرای دستور SYNCHRONIZE CACHE پیش از صدور دستور START STOP UNIT بودند. بر اساس پیش‌نویس‌های اخیر SBC\-2، این کار در صورت نیاز به طور خودکار انجام می‌شود؛ از این رو گزینه '\-s' حذف شده است.
.PP
تمامی گزینه‌ها به جز '\-v' و '\-V' می‌توانند با یک علامت تک "-" وارد شوند. برای نمونه: "sg_start \-stop /dev/sda" و "sg_start \-\-stop /dev/sda" با یکدیگر معادل هستند. فرم تک "-" برای سازگاری رو به عقب در نظر گرفته شده است.
.TP
\fB0\fR
متوقف کردن چرخش (spin\-down) دستگاه
.IR DEVICE .
.TP
\fB1\fR
راه‌اندازی و چرخاندن (spin\-up) دستگاه
.IR DEVICE .
.TP
\fB\-\-eject\fR
متوقف کردن رسانه و بیرون دادن آن از درایو.
.TP
\fB\-\-fl\fR=\fIFL\fR
شماره لایه فرمت دیسک را برای «پرش» به آن تنظیم می‌کند (تعریف‌شده در MMC\-5).
.TP
\fB\-i\fR
بیت IMM را در دستور START STOP UNIT تنظیم می‌کند تا این ابزار بی‌درنگ بازگردد و منتظر توقف چرخش رسانه نماند. اثری مشابه با '\-\-imm=1' دارد. عمل پیش‌فرض (بدون این گزینه یا گزینه '\-\-imm=1') این است که پیش از بازگشت، منتظر بماند تا چرخش رسانه متوقف شود.
.TP
\fB\-\-imm\fR=\fI0|1\fR
هنگامی که بیت immediate برابر با 1 باشد، این ابزار بلافاصله پس از دریافت دستور توسط
.I DEVICE
بازمی‌گردد. هنگامی که این گزینه 0 باشد (پیش‌فرض)، ابزار پس از تکمیل عمل دستور بازمی‌گردد (یعنی منتظر می‌ماند تا دستگاه راه‌اندازی یا متوقف شود).
.TP
\fB\-\-load\fR
بارگذاری رسانه در درایو و راه‌اندازی آن.
.TP
\fB\-\-loej\fR
بیت LOEJ را در cdb دستور START STOP UNIT تنظیم می‌کند. هنگامی که عملیات "start" مشخص شده باشد، بارگذاری و شروع انجام می‌شود. هنگامی که عملیات "stop" مشخص شده باشد، توقف و خروج صورت می‌پذیرد. هنگامی که نه عملیات "start" و نه "stop" مشخص نشده باشد، توقف و خروج انجام می‌دهد. [توجه داشته باشید که این اقدام آخر با رابط جدید تفاوت دارد که در آن این گزینه به صورت پیش‌فرض بارگذاری و راه‌اندازی می‌کند.]
.TP
\fB\-N\fR, \fB\-\-new\fR
جابه‌جایی به گزینه‌ها به سبک جدیدتر.
.TP
\fB\-\-mod\fR=\fIPC_MOD\fR
که در آن
.I PC_MOD
مقدار «تعدیل‌کننده وضعیت مصرف انرژی» است. مقادیر 0 تا 15 (شامل خودشان) معتبر بوده و 0 مقدار پیش‌فرض است. این فیلد پس از sbc3r13 اضافه شد.
.TP
\fB\-\-noflush\fR
پیش از نگارشی از این ابزار که دسترسی به رسانه را محدود می‌کند، عمل تخلیه بافر به رسانه (مانند عملکرد SYNCHRONIZE CACHE) را انجام ندهد. استفاده از گزینه
.B \-\-stop
نمونه‌ای از اعمال محدودیت بر دسترسی به رسانه است. این فیلد پس از sbc3r13 اضافه شد.
.TP
\fB\-\-pc\fR=\fIPC\fR
که در آن
.I PC
مقدار «وضعیت مصرف انرژی» (در مبنای ۱۶ یا هگزادسیمال) است. مقادیر 0 تا f (شامل خودشان) معتبر هستند. مقدار پیش‌فرض 0 است.
.TP
\fB\-r\fR
گزینه
.I \-\-readonly
در بالا را ببینید. ممکن است برای دیسک‌های ATA مفید باشد.
.TP
\fB\-\-start\fR
راه‌اندازی و چرخاندن (spin\-up) دستگاه
.IR DEVICE .
.TP
\fB\-\-stop\fR
متوقف کردن چرخش (spin\-down) دستگاه
.IR DEVICE .
همانند آرگومان "0".
.TP
\fB\-v\fR
پرگویی: دستور SCSI را به صورت هگزادسیمال پیش از اجرای آن در کنسول خروجی می‌دهد. '\-vv' و '\-vvv' نیز پذیرفته می‌شوند که موجب نمایش جزئیات بیشتری می‌گردند.
.TP
\fB\-V\fR
نمایش اطلاعات نسخه و خروج.
.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
از نسخه 1.23 بسته sg3_utils متغیر محیطی SG3_UTILS_OLD_OPTS می‌تواند تعریف شود. در صورت وجود، این ابزار انتظار گزینه‌های قدیمی خط فرمان را خواهد داشت. بنابراین وجود این متغیر محیطی معادل استفاده از
.I \-\-old
(یا
.IR \-O )
به عنوان نخستین گزینه خط فرمان است.
.SH "نویسندگان (AUTHORS)"
نوشته شده توسط K. Garloff و D. Gilbert
.SH "گزارش اشکالات (REPORTING BUGS)"
گزارش اشکالات به <dgilbert at interlog dot com>.
.SH "حق نشر (COPYRIGHT)"
حق نشر \(co 2002\-2021 Kurt Garloff, Douglas Gilbert
.br
این نرم‌افزار تحت مجوز GPL نسخه ۲ توزیع شده است. هیچ‌گونه ضمانتی وجود ندارد؛ حتی برای قابلیت فروش یا تناسب با یک هدف خاص.
.SH "همچنین ببینید (SEE ALSO)"
.B sg_prevent(sg3_utils), sg_requests(sg3_utils), sg_turs(sg3_utils)
.B sdparm(sdparm), lsscsi(lsscsi)