.TH SG_SYNC "8" "May 2018" "sg3_utils\-1.43" SG3_UTILS
.SH "نام (NAME)"
sg_sync \- ارسال دستور SCSI SYNCHRONIZE CACHE
.SH "خلاصه دستور (SYNOPSIS)"
.B sg_sync
[\fI\-\-16\fR] [\fI\-\-count=COUNT\fR] [\fI\-\-group=GN\fR]
[\fI\-\-help\fR] [\fI\-\-immed\fR] [\fI\-\-lba=LBA\fR] [\fI\-\-sync\-nv\fR]
[\fI\-\-timeout=SECS\fR] [\fI\-\-verbose\fR] [\fI\-\-version\fR] \fIDEVICE\fR
.SH "توضیحات (DESCRIPTION)"
.\" Add any additional description here
ارسال دستور SYNCHRONIZE CACHE(10) یا SYNCHRONIZE CACHE(16) به
\fIDEVICE\fR.
این دستورها برای دستگاه‌های بلوکی SCSI تعریف شده‌اند (رجوع کنید به SBC\-3). در صورت موفقیت، این دستورها اطمینان حاصل می‌کنند که هر بلوکی که آخرین نسخه آن در حافظه موقت (کَش) نگهداری می‌شود روی رسانه ذخیره‌سازی نوشته شود (که تحت عنوان «همگام‌سازی با» رسانه نیز نامیده می‌شود).
.PP
اگر آرگومان‌های
\fILBA\fR
و
\fICOUNT\fR
هر دو صفر باشند (مقدار پیش‌فرض آن‌ها)، تمام بلوک‌های موجود در حافظه موقت همگام‌سازی می‌شوند. اگر
\fILBA\fR
بزرگ‌تر از صفر باشد در حالی که
\fICOUNT\fR
صفر است، بلوک‌های موجود در حافظه موقت که نشانی آن‌ها از
\fILBA\fR
(شامل آن) تا بالاترین LBA روی دستگاه است همگام‌سازی می‌شوند. اگر هر دو
\fILBA\fR
و
\fICOUNT\fR
غیر صفر باشند، بلوک‌های موجود در حافظه موقت که نشانی آن‌ها در محدوده
\fILBA\fR
تا
\fILBA\fR+\fICOUNT\fR\-1
(شامل هر دو) قرار دارد با رسانه ذخیره‌سازی همگام‌سازی می‌شوند.
.SH "گزینه‌ها (OPTIONS)"
آرگومان‌های گزینه‌های طولانی برای گزینه‌های کوتاه نیز الزامی هستند.
.TP
\fB\-S\fR, \fB\-\-16\fR
اجرای دستور SYNCHRONIZE CACHE(16). حالت پیش‌فرض اجرای دستور SYNCHRONIZE CACHE(10) است.
.TP
\fB\-c\fR, \fB\-\-count\fR=\fICOUNT\fR
که در آن
\fICOUNT\fR
تعداد بلوک‌ها برای همگام‌سازی از و شامل
\fILBA\fR
است. مقدار پیش‌فرض 0 است. هنگامی که 0 باشد، تمام بلوک‌های موجود در حافظه موقت از آرگومان
\fILBA\fR
(شامل آن) تا بالاترین نشانی بلوک همگام‌سازی می‌شوند.
.TP
\fB\-g\fR, \fB\-\-group\fR=\fIGN\fR
که در آن
\fIGN\fR
شماره گروه است که می‌تواند عددی بین 0 تا 63 (شامل هر دو) باشد. مقدار پیش‌فرض 0 است. شماره‌های گروه برای تفکیک داده‌های جمع‌آوری‌شده درون دستگاه استفاده می‌شوند. این یک ویژگی جدید در SBC\-2 است و احتمالاً در حال حاضر می‌توان از آن صرف‌نظر کرد.
.TP
\fB\-h\fR, \fB\-\-help\fR
نمایش پیام راهنمای نحوه استفاده و سپس خروج.
.TP
\fB\-i\fR, \fB\-\-immed\fR
بیت IMMED را در دستور SYNCHRONIZE CACHE تنظیم می‌کند. این به دستگاه دستور می‌دهد که در صورت قابل قبول بودن قالب دستور، وضعیت GOOD را بلافاصله بازگرداند، به جای اینکه منتظر بماند تا بلوک‌های موجود در حافظه موقت با رسانه همگام‌سازی (یعنی بر روی آن نوشته) شوند.
.TP
\fB\-l\fR, \fB\-\-lba\fR=\fILBA\fR
که در آن
\fILBA\fR
پایین‌ترین نشانی بلوک منطقی در حافظه موقت برای همگام‌سازی با رسانه است. مقدار پیش‌فرض 0 است.
.TP
\fB\-s\fR, \fB\-\-sync\-nv\fR
همگام‌سازی حافظه موقت (فرّار) با حافظه موقت پایدار (غیرفرّار). بدون این گزینه (یا در صورتی که حافظه موقت پایداری در دستگاه وجود نداشته باشد) همگام‌سازی با رسانه ذخیره‌سازی انجام می‌شود. بیت SYNC_NV در SBC\-3 بازبینی 35d منسوخ شده است.
.TP
\fB\-t\fR, \fB\-\-timeout\fR=\fISECS\fR
که در آن
\fISECS\fR
تعداد ثانیه‌هایی است که سیستم‌عامل پیش از تلاش برای لغو دستور، به SYNCHRONIZE CACHE(16) اجازه تکمیل شدن می‌دهد. بهتر است از لغو دستورها (معمولاً با تابع مدیریت وظایف «abort task») اجتناب شود. توجه داشته باشید این گزینه فقط همراه با گزینه
\fI\-\-16\fR
فعال است. زمان مهلت پیش‌فرض برای هر دو دستور SYNCHRONIZE CACHE(10) و SYNCHRONIZE CACHE(16) برابر با 60 ثانیه است. توجه کنید که می‌توان با استفاده از گزینه
\fI\-\-immed\fR
از مشکلات مربوط به اتمام زمان مهلت اجتناب کرد.
.TP
\fB\-v\fR, \fB\-\-verbose\fR
افزایش سطح جزئیات خروجی (یعنی خروجی اشکال‌زدایی).
.TP
\fB\-V\fR, \fB\-\-version\fR
چاپ اطلاعات نسخه و سپس خروج.
.SH "نکات (NOTES)"
با دستور SYNCHRONIZE CACHE(16)، اندازه
\fILBA\fR
می‌تواند تا 64 بیت و اندازه
\fICOUNT\fR
تا 32 بیت باشد. با دستور SYNCHRONIZE CACHE(10)، اندازه
\fILBA\fR
می‌تواند تا 32 بیت و اندازه
\fICOUNT\fR
تا 16 بیت باشد.
.PP
آرگومان‌های عددی گوناگون (مانند
\fILBA\fR)
ممکن است شامل پسوندهای ضریب‌دار باشند یا به صورت هگزادسیمال داده شوند. به بخش «NUMERIC ARGUMENTS» در صفحه راهنمای
.BR sg3_utils (8)
مراجعه کنید.
.SH "وضعیت خروج (EXIT STATUS)"
وضعیت خروج
.B sg_sync
در صورت موفقیت 0 است. در غیر این صورت به صفحه راهنمای
.BR sg3_utils (8)
مراجعه کنید.
.SH "نویسندگان (AUTHORS)"
نوشته‌شده توسط Douglas Gilbert.
.SH "گزارش باگ‌ها (REPORTING BUGS)"
گزارش باگ‌ها به <dgilbert at interlog dot com>.
.SH "حق نشر (COPYRIGHT)"
کپی‌رایت \(co 2004\-2018 Douglas Gilbert
.br
این نرم‌افزار تحت مجوز BSD\-2\-Clause توزیع می‌شود. هیچ ضمانتی وجود ندارد؛ حتی برای قابلیت تجاری یا تناسب با یک هدف خاص.
.SH "همچنین ببینید (SEE ALSO)"
.B sg_start(sg3_utils)