'\" t
.\"     Title: nvme-copy
.\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 02/16/2026
.\"    Manual: NVMe Manual
.\"    Source: NVMe
.\"  Language: English
.\"
.TH "NVME\-COPY" "1" "02/16/2026" "NVMe" "NVMe Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
nvme-copy \- ارسال دستور رونوشت NVMe
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fInvme\-copy\fR <device> [\-\-sdlba=<sdlba> | \-d <sdlba>]
                        [\-\-blocks=<nlb\-list,> | \-b <nlb\-list,>]
                        [\-\-slbs=<slbas,> | \-s <slbas,>]
                        [\-\-snsids=<snsids,> | \-N <snsids,>]
                        [\-\-sopts=<sopts,> | \-O <sopts,>]
                        [\-\-limited\-retry | \-l]
                        [\-\-force\-unit\-access | \-f]
                        [\-\-prinfow=<prinfow> | \-p <prinfow>]
                        [\-\-prinfor=<prinfor> | \-P <prinfor>]
                        [\-\-ref\-tag=<reftag> | \-r <reftag>]
                        [\-\-expected\-ref\-tags=<reftag,> | \-R <reftag,>]
                        [\-\-app\-tag=<apptag> | \-a <apptag>]
                        [\-\-expected\-app\-tags=<apptag,> | \-A <apptag,>]
                        [\-\-app\-mask=<appmask> | \-m <appmask>]
                        [\-\-expected\-app\-masks=<appmask,> | \-M <appmask,>]
                        [\-\-dir\-type=<type> | \-T <type>]
                        [\-\-dir\-spec=<spec> | \-S <spec>]
                        [\-\-format=<entry\-format> | \-F <entry\-format>]
                        [\-\-output\-format=<fmt> | \-o <fmt>] [\-\-verbose | \-v]
                        [\-\-timeout=<timeout> | \-t <timeout>]
.fi
.SH "توضیحات (DESCRIPTION)"
.sp
دستور Copy توسط میزبان برای رونوشت داده‌ها از یک یا چند محدوده بلوک منطقی مبدأ به یک محدوده بلوک منطقی مقصد متوالی و یکتا استفاده می‌شود\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\-d <sdlba>, \-\-sdlba=<sdlba>
.RS 4
آدرس ۶۴ بیتی اولین بلوک منطقی مقصد\&.
.RE
.PP
\-b <nlb\-list,>, \-\-blocks=<nlb\-list,>
.RS 4
فهرست جداشده با کاما از تعداد بلوک‌ها در هر محدوده\&.
.RE
.PP
\-s <slbas,>, \-\-slbs=<slbas,>
.RS 4
فهرست جداشده با کاما از بلوک‌های آغازین در هر محدوده\&.
.RE
.PP
\-\-snsids=<snsids,>, \-N <snsids,>
.RS 4
فهرست جداشده با کاما از شناسه‌های فضای نام مبدأ در هر محدوده\&.
.RE
.PP
\-\-sopts=<sopts,>, \-O <sopts,>
.RS 4
فهرست جداشده با کاما از گزینه‌های مبدأ در هر محدوده\&.
.RE
.PP
\-l, \-\-limited\-retry
.RS 4
پرچم تلاش مجدد محدود (limited retry) را تنظیم می‌کند\&.
.RE
.PP
\-f, \-\-force\-unit\-access
.RS 4
پرچم دسترسی اجباری به واحد (force\-unit access) را تنظیم می‌کند\&.
.RE
.PP
\-p <prinfow>, \-\-prinfow=<prinfow>
.RS 4
تعریف نوشتن فیلد اطلاعات محافظت (Protection Information)\&.
.RE
.PP
\-P <prinfor>, \-\-prinfor=<prinfor>
.RS 4
تعریف خواندن فیلد اطلاعات محافظت (Protection Information)\&.
.RE
.PP
\-r <reftag>, \-\-ref\-tag=<reftag>
.RS 4
تگ مرجع اولیه lba\&.
.RE
.PP
\-R <reftag,>, \-\-expected\-ref\-tags=<reftag,>
.RS 4
تگ‌های مرجع مورد انتظار lba (فهرست جداشده با کاما)\&.
.RE
.PP
\-a <apptag>, \-\-app\-tag=<apptag>
.RS 4
تگ برنامه (app tag) برای lba\&.
.RE
.PP
\-A <apptag,>, \-\-expected\-app\-tags=<apptag,>
.RS 4
تگ‌های برنامه مورد انتظار lba (فهرست جداشده با کاما)\&.
.RE
.PP
\-m <appmask>, \-\-app\-mask=<appmask>
.RS 4
ماسک تگ lba\&.
.RE
.PP
\-M <appmask,>, \-\-expected\-app\-masks=<appmask,>
.RS 4
ماسک‌های تگ مورد انتظار lba (فهرست جداشده با کاما)\&.
.RE
.PP
\-T <type>, \-\-dir\-type=<type>
.RS 4
نوع دستورالعمل (directive) اختیاری\&. ابزار nvme\-cli تنها مقدار را در محدوده تعریف‌شده برای نوع دستورالعمل اعمال می‌کند، هرچند مشخصات NVMe (نسخه 1\&.3a) تنها یک نوع دستورالعمل، 01h، برای شناسه‌های جریان نوشتن (write stream) تعریف کرده است\&.
.RE
.PP
\-S <spec>, \-\-dir\-spec=<spec>
.RS 4
فیلد اختیاری برای مشخصات دستورالعمل (directive)\&. هنگامی که با جریان‌های نوشتن استفاده می‌شود، این مقدار به‌عنوان شناسه جریان نوشتن تعریف می‌شود\&. ابزار nvme\-cli معتبر بودن جریان درخواستی در محدوده قابلیت‌های کنترلر را بررسی نمی‌کند\&.
.RE
.PP
\-F <entry\-format>, \-\-format=<entry\-format>
.RS 4
قالب مدخل محدوده مبدأ\&.
.RE
.PP
\-o <fmt>, \-\-output\-format=<fmt>
.RS 4
تنظیم قالب گزارش‌دهی روی
\fInormal\fR،
\fIjson\fR
یا
\fIbinary\fR\&. در هر زمان تنها می‌توان از یک قالب خروجی استفاده کرد\&.
.RE
.PP
\-v, \-\-verbose
.RS 4
افزایش جزئیات اطلاعات در خروجی\&.
.RE
.PP
\-t <timeout>, \-\-timeout=<timeout>
.RS 4
بازنویسی مقدار مهلت زمانی پیش‌فرض\&. بر حسب میلی‌ثانیه\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
هنوز مثالی وجود ندارد\&.
.SH "NVME"
.sp
بخشی از مجموعه nvme\-user