.TH SG_COPY_RESULTS "8" "سپتامبر ۲۰۱۴" "sg3_utils\-1.40" SG3_UTILS
.SH "نام (NAME)"
sg_copy_results \- ارسال دستور SCSI RECEIVE COPY RESULTS (مرتبط با XCOPY)
.SH "خلاصه دستور (SYNOPSIS)"
.B sg_copy_results
[\fI\-\-failed\fR|\fI\-\-params\fR|\fI\-\-receive\fR|\fI\-\-status\fR]
[\fI\-\-help\fR] [\fI\-\-hex\fR] [\fI\-\-list_id=ID\fR] [\fI\-\-readonly\fR]
[\fI\-\-verbose\fR] [\fI\-\-version\fR] [\fI\-\-xfer_len=BTL\fR] \fIDEVICE\fR
.SH "توضیحات (DESCRIPTION)"
.\" Add any additional description here
این ابزار برای پرس‌وجوی وضعیت قابلیت رونوشت گسترش‌یافته اسکازی
(SCSI Extended Copy یا XCOPY)
طراحی شده است (بخش‌های ۶.۳ و ۶.۱۷ از ویرایش ۲۳ استاندارد SPC\-3 را ببینید)، که در برخی از آرایه‌های ذخیره‌سازی مدرن وجود دارد. این ابزار یک دستور SCSI RECEIVE COPY RESULTS را به
\fIDEVICE\fR
داده‌شده ارسال کرده و پاسخ را نمایش می‌دهد.
.PP
در مراحل پیش‌نویس SPC\-4، کمیته T10 دستور XCOPY را گسترش داد، به گونه‌ای که اکنون دو نوع دارد: "LID1" (برای طول List Identifier برابر با ۱ بایت) و "LID4" (برای طول List Identifier برابر با ۴ بایت). این ابزار از گونه قدیمی‌تر LID1 پشتیبانی می‌کند که در SPC\-3 و پیش از آن نیز یافت می‌شود. در حالی که گونه LID1 در SPC\-4 در سطح دستور (باینری) با XCOPY تعریف‌شده در SPC\-3 سازگار است، برخی از نام‌گذاری‌های دستورات تغییر یافته است. این ابزار از نام‌های قدیمی‌تر XCOPY در SPC\-3 استفاده می‌کند.
.PP
این دستور چهار حالت عملیاتی متمایز دارد که با فیلد service action مشخص می‌شوند:
.TP
\fBCOPY STATUS  [SPC\-4: RECEIVE COPY STATUS(LID1)]\fR
وضعیت فعلی دستور EXTENDED COPY که توسط فیلد list id مشخص شده را نمایش می‌دهد.
.TP
\fBRECEIVE DATA  [SPC\-4: RECEIVE COPY DATA(LID1)]\fR
داده‌های نگه‌داشته‌شده خوانده‌شده توسط دستور EXTENDED COPY که توسط فیلد list id مشخص شده را برمی‌گرداند. این گزینه تنها زمانی معنادار است که توصیف‌گر بخش (segment descriptor) مربوطه پشتیبانی شود.
.TP
\fBOPERATING PARAMETERS  [SPC\-4: RECEIVE COPY OPERATING PARAMETERS]\fR
پارامترهای عملیاتی copy manager را برمی‌گرداند. این گزینه همچنین برای تعیین اینکه آیا قابلیت SCSI Extended Copy پشتیبانی می‌شود یا خیر، مفید است.
.TP
\fBFAILED SEGMENT DETAILS  [SPC\-4: RECEIVE COPY FAILURE DETAILS(LID1)]\fR
داده‌های حسگر (sense data) دستگاه هدف رونوشت و سایر اطلاعات مربوط به بخش‌های ناموفق را برمی‌گرداند.

.SH "گزینه‌ها (OPTIONS)"
آرگومان‌های گزینه‌های طولانی برای گزینه‌های کوتاه نیز اجباری هستند.
.TP
\fB\-f\fR, \fB\-\-failed\fR
فیلد service action را روی FAILED SEGMENT DETAILS [4] تنظیم می‌کند.
.TP
\fB\-h\fR, \fB\-\-help\fR
پیام راهنمای نحوه استفاده را نمایش داده و خارج می‌شود.
.TP
\fB\-H\fR, \fB\-\-hex\fR
بافر پاسخ را به صورت هگزادسیمال چاپ می‌کند.
.TP
\fB\-l\fR, \fB\-\-list_id\fR=\fIID\fR
فیلد list identifier را روی \fIID\fR تنظیم می‌کند (پیش‌فرض: 0).
.TP
\fB\-p\fR, \fB\-\-params\fR
فیلد service action را روی OPERATING PARAMETERS [3] تنظیم می‌کند. این مقدار پیش‌فرض است.
.TP
\fB\-R\fR, \fB\-\-readonly\fR
دستگاه \fIDEVICE\fR را به صورت فقط‌خواندنی باز می‌کند (برای مثال در یونیکس با پرچم O_RDONLY). حالت پیش‌فرض باز کردن آن به صورت خواندن\-نوشتن است.
.TP
\fB\-r\fR, \fB\-\-receive\fR
فیلد service action را روی RECEIVE DATA [1] تنظیم می‌کند.
.TP
\fB\-s\fR, \fB\-\-status\fR
فیلد service action را روی COPY STATUS [0] تنظیم می‌کند.
.TP
\fB\-v\fR, \fB\-\-verbose\fR
میزان خروجی با جزئیات را افزایش می‌دهد (یعنی خروجی رفع اشکال).
.TP
\fB\-V\fR, \fB\-\-version\fR
رشته نسخه را چاپ کرده و خارج می‌شود.
.TP
\fB\-x\fR, \fB\-\-xfer_len\fR=\fIBTL\fR
فیلد allocation length را روی \fIBTL\fR تنظیم می‌کند. این طول انتقال بر حسب بایت (byte transfer length) و حداکثر اندازه (بایتی) پاسخ است. \fIBTL\fR باید کمتر از ۱۰۰۰۰ باشد و پیش‌فرض آن ۵۲۰ است.
.SH "نکات (NOTES)"
رمزگشایی عملیات سرویس \fIRECEIVE DATA\fR پیاده‌سازی نشده است.
.PP
به شیوه‌ای مشابه که قابلیت‌های sg_xcopy به ابزار عمومی‌تر ddpt (و بسته مربوط به آن) منتقل شده، قابلیت‌های این ابزار نیز به ابزار ddptctl منتقل شده است.
.SH "مثال‌ها (EXAMPLES)"
پرس‌وجوی پارامترهای عملیاتی برای یک دستگاه:
.PP
.nf
# sg_copy_results \-p /dev/sdo
.fi
.br
.nf
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
.fi

.SH "وضعیت خروج (EXIT STATUS)"
وضعیت خروج sg_copy_results در صورت موفقیت 0 است. در غیر این صورت به صفحه راهنمای sg3_utils(8) مراجعه کنید.
.SH "نویسندگان (AUTHORS)"
نوشته‌شده توسط Douglas Gilbert.
.SH "گزارش باگ‌ها (REPORTING BUGS)"
گزارش باگ‌ها را به <dgilbert at interlog dot com> بفرستید.
.SH "حق نشر (COPYRIGHT)"
حق نشر \(co 2012\-2014 متعلق به Hannes Reinecke و Douglas Gilbert است.
.br
این نرم‌افزار تحت مجوز BSD\-2\-Clause توزیع شده است. هیچ ضمانتی وجود ندارد؛ حتی برای قابلیت فروش یا تناسب برای یک هدف خاص.
.SH "همچنین ببینید (SEE ALSO)"
.B sg_xcopy(sg3_utils), ddpt,ddptctl(ddpt)