نام (NAME)

sg_sync - ارسال دستور SCSI SYNCHRONIZE CACHE

خلاصه دستور (SYNOPSIS)

sg_sync [--16] [--count=COUNT] [--group=GN] [--help] [--immed] [--lba=LBA] [--sync-nv] [--timeout=SECS] [--verbose] [--version] DEVICE

توضیحات (DESCRIPTION)

ارسال دستور SYNCHRONIZE CACHE(10) یا SYNCHRONIZE CACHE(16) به DEVICE. این دستورها برای دستگاه‌های بلوکی SCSI تعریف شده‌اند (رجوع کنید به SBC-3). در صورت موفقیت، این دستورها اطمینان حاصل می‌کنند که هر بلوکی که آخرین نسخه آن در حافظه موقت (کَش) نگهداری می‌شود روی رسانه ذخیره‌سازی نوشته شود (که تحت عنوان «همگام‌سازی با» رسانه نیز نامیده می‌شود).

اگر آرگومان‌های LBA و COUNT هر دو صفر باشند (مقدار پیش‌فرض آن‌ها)، تمام بلوک‌های موجود در حافظه موقت همگام‌سازی می‌شوند. اگر LBA بزرگ‌تر از صفر باشد در حالی که COUNT صفر است، بلوک‌های موجود در حافظه موقت که نشانی آن‌ها از LBA (شامل آن) تا بالاترین LBA روی دستگاه است همگام‌سازی می‌شوند. اگر هر دو LBA و COUNT غیر صفر باشند، بلوک‌های موجود در حافظه موقت که نشانی آن‌ها در محدوده LBA تا LBA+COUNT-1 (شامل هر دو) قرار دارد با رسانه ذخیره‌سازی همگام‌سازی می‌شوند.

گزینه‌ها (OPTIONS)

آرگومان‌های گزینه‌های طولانی برای گزینه‌های کوتاه نیز الزامی هستند.

-S, --16

اجرای دستور SYNCHRONIZE CACHE(16). حالت پیش‌فرض اجرای دستور SYNCHRONIZE CACHE(10) است.

-c, --count=COUNT

که در آن COUNT تعداد بلوک‌ها برای همگام‌سازی از و شامل LBA است. مقدار پیش‌فرض 0 است. هنگامی که 0 باشد، تمام بلوک‌های موجود در حافظه موقت از آرگومان LBA (شامل آن) تا بالاترین نشانی بلوک همگام‌سازی می‌شوند.

-g, --group=GN

که در آن GN شماره گروه است که می‌تواند عددی بین 0 تا 63 (شامل هر دو) باشد. مقدار پیش‌فرض 0 است. شماره‌های گروه برای تفکیک داده‌های جمع‌آوری‌شده درون دستگاه استفاده می‌شوند. این یک ویژگی جدید در SBC-2 است و احتمالاً در حال حاضر می‌توان از آن صرف‌نظر کرد.

-h, --help

نمایش پیام راهنمای نحوه استفاده و سپس خروج.

-i, --immed

بیت IMMED را در دستور SYNCHRONIZE CACHE تنظیم می‌کند. این به دستگاه دستور می‌دهد که در صورت قابل قبول بودن قالب دستور، وضعیت GOOD را بلافاصله بازگرداند، به جای اینکه منتظر بماند تا بلوک‌های موجود در حافظه موقت با رسانه همگام‌سازی (یعنی بر روی آن نوشته) شوند.

-l, --lba=LBA

که در آن LBA پایین‌ترین نشانی بلوک منطقی در حافظه موقت برای همگام‌سازی با رسانه است. مقدار پیش‌فرض 0 است.

-s, --sync-nv

همگام‌سازی حافظه موقت (فرّار) با حافظه موقت پایدار (غیرفرّار). بدون این گزینه (یا در صورتی که حافظه موقت پایداری در دستگاه وجود نداشته باشد) همگام‌سازی با رسانه ذخیره‌سازی انجام می‌شود. بیت SYNC_NV در SBC-3 بازبینی 35d منسوخ شده است.

-t, --timeout=SECS

که در آن SECS تعداد ثانیه‌هایی است که سیستم‌عامل پیش از تلاش برای لغو دستور، به SYNCHRONIZE CACHE(16) اجازه تکمیل شدن می‌دهد. بهتر است از لغو دستورها (معمولاً با تابع مدیریت وظایف «abort task») اجتناب شود. توجه داشته باشید این گزینه فقط همراه با گزینه --16 فعال است. زمان مهلت پیش‌فرض برای هر دو دستور SYNCHRONIZE CACHE(10) و SYNCHRONIZE CACHE(16) برابر با 60 ثانیه است. توجه کنید که می‌توان با استفاده از گزینه --immed از مشکلات مربوط به اتمام زمان مهلت اجتناب کرد.

-v, --verbose

افزایش سطح جزئیات خروجی (یعنی خروجی اشکال‌زدایی).

-V, --version

چاپ اطلاعات نسخه و سپس خروج.

نکات (NOTES)

با دستور SYNCHRONIZE CACHE(16)، اندازه LBA می‌تواند تا 64 بیت و اندازه COUNT تا 32 بیت باشد. با دستور SYNCHRONIZE CACHE(10)، اندازه LBA می‌تواند تا 32 بیت و اندازه COUNT تا 16 بیت باشد.

آرگومان‌های عددی گوناگون (مانند LBA) ممکن است شامل پسوندهای ضریب‌دار باشند یا به صورت هگزادسیمال داده شوند. به بخش «NUMERIC ARGUMENTS» در صفحه راهنمای sg3_utils(8) مراجعه کنید.

وضعیت خروج (EXIT STATUS)

وضعیت خروج sg_sync در صورت موفقیت 0 است. در غیر این صورت به صفحه راهنمای sg3_utils(8) مراجعه کنید.

نویسندگان (AUTHORS)

نوشته‌شده توسط Douglas Gilbert.

گزارش باگ‌ها (REPORTING BUGS)

گزارش باگ‌ها به <dgilbert at interlog dot com>.

حق نشر (COPYRIGHT)

کپی‌رایت © 2004-2018 Douglas Gilbert
این نرم‌افزار تحت مجوز BSD-2-Clause توزیع می‌شود. هیچ ضمانتی وجود ندارد؛ حتی برای قابلیت تجاری یا تناسب با یک هدف خاص.

همچنین ببینید (SEE ALSO)

sg_start(sg3_utils)