نام (NAME)

sg_copy_results - ارسال دستور SCSI RECEIVE COPY RESULTS (مرتبط با XCOPY)

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

sg_copy_results [--failed|--params|--receive|--status] [--help] [--hex] [--list_id=ID] [--readonly] [--verbose] [--version] [--xfer_len=BTL] DEVICE

توضیحات (DESCRIPTION)

این ابزار برای پرس‌وجوی وضعیت قابلیت رونوشت گسترش‌یافته اسکازی (SCSI Extended Copy یا XCOPY) طراحی شده است (بخش‌های ۶.۳ و ۶.۱۷ از ویرایش ۲۳ استاندارد SPC-3 را ببینید)، که در برخی از آرایه‌های ذخیره‌سازی مدرن وجود دارد. این ابزار یک دستور SCSI RECEIVE COPY RESULTS را به DEVICE داده‌شده ارسال کرده و پاسخ را نمایش می‌دهد.

در مراحل پیش‌نویس SPC-4، کمیته T10 دستور XCOPY را گسترش داد، به گونه‌ای که اکنون دو نوع دارد: "LID1" (برای طول List Identifier برابر با ۱ بایت) و "LID4" (برای طول List Identifier برابر با ۴ بایت). این ابزار از گونه قدیمی‌تر LID1 پشتیبانی می‌کند که در SPC-3 و پیش از آن نیز یافت می‌شود. در حالی که گونه LID1 در SPC-4 در سطح دستور (باینری) با XCOPY تعریف‌شده در SPC-3 سازگار است، برخی از نام‌گذاری‌های دستورات تغییر یافته است. این ابزار از نام‌های قدیمی‌تر XCOPY در SPC-3 استفاده می‌کند.

این دستور چهار حالت عملیاتی متمایز دارد که با فیلد service action مشخص می‌شوند:

COPY STATUS [SPC-4: RECEIVE COPY STATUS(LID1)]: وضعیت فعلی دستور EXTENDED COPY که توسط فیلد list id مشخص شده را نمایش می‌دهد.
RECEIVE DATA [SPC-4: RECEIVE COPY DATA(LID1)]: داده‌های نگه‌داشته‌شده خوانده‌شده توسط دستور EXTENDED COPY که توسط فیلد list id مشخص شده را برمی‌گرداند. این گزینه تنها زمانی معنادار است که توصیف‌گر بخش (segment descriptor) مربوطه پشتیبانی شود.
OPERATING PARAMETERS [SPC-4: RECEIVE COPY OPERATING PARAMETERS]: پارامترهای عملیاتی copy manager را برمی‌گرداند. این گزینه همچنین برای تعیین اینکه آیا قابلیت SCSI Extended Copy پشتیبانی می‌شود یا خیر، مفید است.
FAILED SEGMENT DETAILS [SPC-4: RECEIVE COPY FAILURE DETAILS(LID1)]: داده‌های حسگر (sense data) دستگاه هدف رونوشت و سایر اطلاعات مربوط به بخش‌های ناموفق را برمی‌گرداند.

گزینه‌ها (OPTIONS)

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

-f, --failed: فیلد service action را روی FAILED SEGMENT DETAILS [4] تنظیم می‌کند.
-h, --help: پیام راهنمای نحوه استفاده را نمایش داده و خارج می‌شود.
-H, --hex: بافر پاسخ را به صورت هگزادسیمال چاپ می‌کند.
-l, --list_id=ID: فیلد list identifier را روی ID تنظیم می‌کند (پیش‌فرض: 0).
-p, --params: فیلد service action را روی OPERATING PARAMETERS [3] تنظیم می‌کند. این مقدار پیش‌فرض است.
-R, --readonly: دستگاه DEVICE را به صورت فقط‌خواندنی باز می‌کند (برای مثال در یونیکس با پرچم O_RDONLY). حالت پیش‌فرض باز کردن آن به صورت خواندن-نوشتن است.
-r, --receive: فیلد service action را روی RECEIVE DATA [1] تنظیم می‌کند.
-s, --status: فیلد service action را روی COPY STATUS [0] تنظیم می‌کند.
-v, --verbose: میزان خروجی با جزئیات را افزایش می‌دهد (یعنی خروجی رفع اشکال).
-V, --version: رشته نسخه را چاپ کرده و خارج می‌شود.
-x, --xfer_len=BTL: فیلد allocation length را روی BTL تنظیم می‌کند. این طول انتقال بر حسب بایت (byte transfer length) و حداکثر اندازه (بایتی) پاسخ است. BTL باید کمتر از ۱۰۰۰۰ باشد و پیش‌فرض آن ۵۲۰ است.

نکات (NOTES)

رمزگشایی عملیات سرویس RECEIVE DATA پیاده‌سازی نشده است.

به شیوه‌ای مشابه که قابلیت‌های sg_xcopy به ابزار عمومی‌تر ddpt (و بسته مربوط به آن) منتقل شده، قابلیت‌های این ابزار نیز به ابزار ddptctl منتقل شده است.

مثال‌ها (EXAMPLES)

پرس‌وجوی پارامترهای عملیاتی برای یک دستگاه:

# sg_copy_results -p /dev/sdo

Receive copy results (report operating parameters):
    Supports no list identifier: no
    Maximum target descriptor count: 2
    Maximum segment descriptor count: 1
    Maximum descriptor list length: 92 bytes
    Maximum segment length: 33553920 bytes
    Inline data not supported
    Held data limit: 0 bytes
    Maximum stream device transfer size: 0 bytes
    Total concurrent copies: 0
    Maximum concurrent copies: 255
    Data segment granularity: 512 bytes
    Inline data granularity: 1 bytes
    Held data granularity: 1 bytes
    Implemented descriptor list:
        Segment descriptor 0x02: Copy from block device to block device
        Target descriptor 0xe4: Identification descriptor

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

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

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

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

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

گزارش باگ‌ها را به <dgilbert at interlog dot com> بفرستید.

حق نشر (COPYRIGHT)

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

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

sg_xcopy(sg3_utils), ddpt,ddptctl(ddpt)