'\" t
.\"     Title: nvme-compare
.\"    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: Persian
.\"
.TH "NVME\-COMPARE" "1" "02/16/2026" "NVMe" "راهنمای NVMe"
.\" -----------------------------------------------------------------
.\" * 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-compare \- ارسال یک دستور مقایسه NVMe و ارائه نتایج
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fInvme\-compare\fR <device> [\-\-start\-block=<slba> | \-s <slba>]
                        [\-\-block\-count=<nlb> | \-c <nlb>]
                        [\-\-block\-size=<size> | \-b <size>]
                        [\-\-data\-size=<size> | \-z <size>]
                        [\-\-metadata\-size=<metasize> | \-y <metasize>]
                        [\-\-ref\-tag=<reftag> | \-r <reftag>]
                        [\-\-data=<data\-file> | \-d <data\-file>]
                        [\-\-metadata=<meta> | \-M <meta>]
                        [\-\-prinfo=<prinfo> | \-p <prinfo>]
                        [\-\-app\-tag\-mask=<appmask> | \-m <appmask>]
                        [\-\-app\-tag=<apptag> | \-a <apptag>]
                        [\-\-limited\-retry | \-l]
                        [\-\-force\-unit\-access | \-f]
                        [\-\-dir\-type=<type> | \-T <type>]
                        [\-\-dir\-spec=<spec> | \-S <spec>]
                        [\-\-dsm=<dsm> | \-D <dsm>]
                        [\-\-show\-command | \-V]
                        [\-\-dry\-run | \-w]
                        [\-\-latency | \-t]
                        [\-\-storage\-tag<storage\-tag> | \-g <storage\-tag>]
                        [\-\-storage\-tag\-check | \-C]
                        [\-\-force]
                        [\-\-output\-format=<fmt> | \-o <fmt>] [\-\-verbose | \-v]
                        [\-\-timeout=<timeout>]
.fi
.SH "توضیحات (DESCRIPTION)"
.sp
دستور Compare بلوک‌های منطقی مشخص‌شده توسط دستور را از رسانه می‌خواند و داده‌های خوانده‌شده را با بافر داده‌های مقایسه‌ای که به‌عنوان بخشی از دستور منتقل شده است، مقایسه می‌کند\&. اگر داده‌های خوانده‌شده از کنترلر و بافر داده‌های مقایسه‌ای یکسان بوده و هیچ عدم تطابقی وجود نداشته باشد، دستور با موفقیت به پایان می‌رسد\&. در صورت وجود هرگونه عدم تطابق، دستور با خطای Compare Failure به پایان می‌رسد\&. اگر متاداده ارائه شده باشد، مقایسه برای متاداده نیز انجام می‌شود\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\-s <slba>, \-\-start\-block=<slba>
.RS 4
آدرس ۶۴\-بیتی اولین بلوک جهت دسترسی\&.
.RE
.PP
\-c <nlb>, \-\-block\-count=<nlb>
.RS 4
تعداد بلوک‌های مورد دسترسی (مبتنی بر صفر)\&.
.RE
.PP
\-b <size>, \-\-block\-size=<size>
.RS 4
در صورت تعیین، اندازه بلوک منطقی به بایت، که در آن metasize نیز اندازه متاداده را برای یک بلوک منفرد مشخص می‌کند\&. در غیر این صورت توسط identify namespace شناسایی می‌شود\&.
.RE
.PP
\-z <size>, \-\-data\-size=<size>
.RS 4
اندازه داده‌های مورد مقایسه به بایت\&.
.RE
.PP
\-y <metasize>, \-\-metadata\-size=<metasize>
.RS 4
اندازه متاداده جهت انتقال به بایت\&.
.RE
.PP
\-r <reftag>, \-\-ref\-tag=<reftag>
.RS 4
برچسب مرجع (Reference Tag) برای اطلاعات حفاظت (Protection Information)\&.
.RE
.PP
\-d <data\-file>, \-\-data=<data\-file>
.RS 4
فایل داده\&.
.RE
.PP
\-M <meta>, \-\-metadata=<meta>
.RS 4
فایل متاداده\&.
.RE
.PP
\-p <prinfo>, \-\-prinfo=<prinfo>
.RS 4
اطلاعات حفاظت و فیلد بررسی\&.
.TS
allbox tab(:);
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt.
T{
بیت
T}:T{
توضیحات
T}
T{
3
T}:T{
PRACT: اقدام اطلاعات حفاظت (Protection Information Action)\&. هنگامی که روی ۱ تنظیم شود، اگر اندازه متاداده قالب بلوک برابر ۸ باشد، PI هنگام خواندن/نوشتن حذف/درج می‌شود\&. هنگامی که روی ۰ تنظیم شود، متاداده عبور داده می‌شود\&.
T}
T{
2:0
T}:T{
PRCHK: بررسی اطلاعات حفاظت (Protection Information Check):
T}
T{
2
T}:T{
تنظیم روی ۱ بررسی برچسب محافظ (guard tag) را فعال می‌کند
T}
T{
1
T}:T{
تنظیم روی ۱ بررسی برچسب برنامه (application tag) را فعال می‌کند
T}
T{
0
T}:T{
تنظیم روی ۱ بررسی برچسب مرجع (reference tag) را فعال می‌کند
T}
.TE
.sp 1
.RE
.PP
\-m <appmask>, \-\-app\-tag\-mask=<appmask>
.RS 4
ماسک برچسب برنامه (App Tag Mask) برای اطلاعات حفاظت\&.
.RE
.PP
\-a <apptag>, \-\-app\-tag=<apptag>
.RS 4
برچسب برنامه (App Tag) برای اطلاعات حفاظت\&.
.RE
.PP
\-l, \-\-limited\-retry
.RS 4
تعداد تلاش‌های محدود به رسانه\&.
.RE
.PP
\-f, \-\-force\-unit\-access
.RS 4
گزینه FUA جهت اطمینان از ذخیره قطعی داده‌ها در رسانه\&.
.RE
.PP
\-T <type>, \-\-dir\-type=<type>
.RS 4
نوع رهنمود (directive type) اختیاری\&. ابزار nvme\-cli فقط الزام می‌کند که مقدار در محدوده تعریف‌شده برای نوع directive باشد، هرچند مشخصات NVMe (نسخه 1\&.3a) تنها یک directive یعنی 01h را برای شناسه‌های جریان نوشتن تعریف می‌کند\&.
.RE
.PP
\-S <spec>, \-\-dir\-spec=<spec>
.RS 4
فیلد اختیاری برای مشخصات رهنمود (directive specifics)\&. در صورت استفاده با جریان‌های نوشتن، این مقدار به‌عنوان شناسه جریان نوشتن تعریف می‌شود\&. ابزار nvme\-cli بررسی نمی‌کند که آیا جریان درخواستی در محدوده قابلیت‌های کنترلر است یا خیر\&.
.RE
.PP
\-D <dsm>, \-\-dsm=<dsm>
.RS 4
ویژگی‌های اختیاری مدیریت مجموعه‌داده (data set management) برای این دستور\&. آرگومان ورودی، ۸ بیت کم‌ارزش‌تر فیلد DSM در دستور نوشتن است؛ ۱۶ بیت باارزش‌تر این فیلد (در صورت استفاده) از فیلد directive specific تأمین می‌شود\&. این گزینه می‌تواند برای تنظیم ویژگی‌های LBAهای در حال نوشتن مانند بسامد دسترسی، نوع، تأخیر و سایر موارد و همچنین انواع دیگری که در آینده تعریف می‌شوند استفاده شود\&. لطفاً برای مشاهده جزئیات نحوه استفاده از این فیلد به مشخصات NVMe مراجعه کنید\&.
.RE
.PP
\-V, \-\-show\-cmd
.RS 4
چاپ دستوری که قرار است ارسال شود\&.
.RE
.PP
\-w, \-\-dry\-run
.RS 4
دستور را در عمل ارسال نمی‌کند\&. در صورت تمایل به استفاده از گزینه \-\-dry\-run، گزینه \-\-show\-cmd
\fIباید\fR
تنظیم شده باشد\&. در غیر این صورت گزینه \-\-dry\-run
\fIنادیده گرفته خواهد شد\fR\&.
.RE
.PP
\-t, \-\-latency
.RS 4
چاپ میزان تأخیر اجرای فراخوانی IOCTL (بر حسب میکروثانیه)\&.
.RE
.PP
\-g <storage\-tag>, \-\-storage\-tag=<storage\-tag>
.RS 4
برچسب ذخیره‌سازی بلوک منطقی مورد انتظار با اندازه متغیر (ELBST)\&.
.RE
.PP
\-C, \-\-storage\-tag\-check
.RS 4
این فلگ بررسی فیلد برچسب ذخیره‌سازی را به‌عنوان بخشی از پردازش حفاظت سراسری داده‌ها فعال می‌کند\&.
.RE
.PP
\-\-force
.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
\-\-timeout=<timeout>
.RS 4
بازنویسی مقدار مهلت زمانی پیش‌فرض (بر حسب میلی‌ثانیه)\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
هنوز مثالی وجود ندارد\&.
.SH "NVME"
.sp
بخشی از مجموعه nvme\-user
.SH "همچنین ببینید (SEE ALSO)"
.BR nvme (1)