NVME-READ(1) NVMe Manual NVME-READ(1)

nvme-read - ارسال دستور خواندن NVMe و بازگرداندن نتایج

nvme-read <device> [--start-block=<slba> | -s <slba>]
                        [--block-count=<nlb> | -c <nlb>]
                        [--block-size=<size> | -b <size>]
                        [--data-size=<size> | -z <size>]
                        [--metadata-size=<size> | -y <size>]
                        [--ref-tag=<reftag> | -r <reftag>]
                        [--data=<data-file> | -d <data-file>]
                        [--metadata=<metadata-file> | -M <metadata-file>]
                        [--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>]

دستور Read بلوک‌های منطقی مشخص‌شده توسط دستور را از رسانه ذخیره‌سازی خوانده و در بافر داده ارائه‌شده کپی می‌کند. در صورت عدم ارائه فایل، به طور پیش‌فرض از stdout استفاده خواهد شد.

-s <slba>, --start-block=<slba>

بلوک آغازین.

-c, --block-count

تعداد بلوک‌ها برای انتقال. این یک مقدار مبتنی بر صفر است تا با نحوه استفاده هسته (kernel) از این فیلد هماهنگ باشد (یعنی 0 به معنی انتقال ۱ بلوک است).

-b <size>, --block-size=<size>

در صورت تعیین، اندازه بلوک منطقی بر حسب بایت، که در آن metasize نیز اندازه فراداده (متادیتا) را برای یک بلوک مجزا شرح می‌دهد. در غیر این صورت از طریق identify namespace شناسایی می‌شود.

-z <size>, --data-size=<size>

اندازه داده‌ها، بر حسب بایت.

-y <size>, --metadata-size=<size>

اندازه متادیتا (فراداده) بر حسب بایت.

-d <data-file>, --data=<data-file>

فایل داده. اگر فایلی ارائه نشود، محتویات به STDOUT فرستاده می‌شود.

-M <metadata-file>, --metadata=<metadata-file>

فایل متادیتا، در صورت لزوم.

-p <prinfo>, --prinfo=<prinfo>

تعریف فیلد اطلاعات حفاظت (Protection Information).
بیت توضیحات
3 عملیات اطلاعات حفاظت (PRACT): هنگامی که روی ۱ تنظیم شود، چنانچه اندازه متادیتای قالب بلوک برابر با ۸ باشد، PI هنگام خواندن/نوشتن حذف یا درج می‌شود. هنگامی که روی ۰ تنظیم شود، متادیتا عبور داده می‌شود.
2:0 بررسی اطلاعات حفاظت (PRCHK):
2 تنظیم روی ۱، بررسی تگ محافظ (guard tag) را فعال می‌کند
1 تنظیم روی ۱، بررسی تگ برنامه (application tag) را فعال می‌کند
0 تنظیم روی ۱، بررسی تگ مرجع (reference tag) را فعال می‌کند

-r <reftag>, --ref-tag=<reftag>

تگ مرجع (reftag) اختیاری هنگام استفاده به همراه اطلاعات حفاظت.

-m <appmask>, --app-tag-mask=<appmask>

ماسک اختیاری تگ برنامه هنگام استفاده به همراه اطلاعات حفاظت.

-f, --force-unit-access

تنظیم فلگ دستیابی اجباری به واحد (force-unit access).

-T <type>, --dir-type=<type>

نوع دایرکتیو (directive type) اختیاری. ابزار nvme-cli تنها بررسی می‌کند که مقدار در محدوده تعریف‌شده برای نوع دایرکتیو باشد، هرچند مشخصات NVMe (نسخه 1.3a) تنها یک دایرکتیو (01h) را برای شناسه‌های جریان نوشتن (write stream identifiers) تعریف کرده است.

-S <spec>, --dir-spec=<spec>

فیلد اختیاری برای مشخصات دایرکتیو. هنگام استفاده با جریان‌های نوشتن، این مقدار به عنوان شناسه جریان نوشتن تعریف می‌شود. ابزار nvme-cli بررسی نمی‌کند که آیا جریان درخواستی در محدوده توانمندی‌های کنترلر هست یا خیر.

-D <dsm>, --dsm=<dsm>

ویژگی‌های اختیاری مدیریت مجموعه‌داده (data set management) برای این دستور. آرگومان مربوط به این گزینه، ۸ بیت کم‌ارزش‌تر فیلد DSM در دستور نوشتن است؛ ۱۶ بیت باارزش‌تر این فیلد، در صورت استفاده، از فیلد directive specific به دست می‌آید. از این گزینه می‌توان برای تنظیم ویژگی‌های LBAهای در حال نوشتن مانند بسامد دسترسی، نوع، تأخیر و موارد دیگر، و همچنین انواع تعریف‌نشده استفاده کرد. لطفاً برای جزئیات کامل نحوه استفاده از این فیلد به مشخصات NVMe مراجعه کنید.

-V, --show-cmd

دستوری که قرار است ارسال شود را چاپ می‌کند.

-w, --dry-run

دستور را در عمل ارسال نمی‌کند. در صورت تمایل به استفاده از گزینه --dry-run، گزینه --show-cmd باید تنظیم شده باشد. در غیر این صورت گزینه --dry-run نادیده گرفته خواهد شد.

-t, --latency

میزان تأخیری که IOCTL طول کشید (بر حسب میکروثانیه) را چاپ می‌کند.

-g <storage-tag>, --storage-tag=<storage-tag>

تگ ذخیره‌سازی بلوک منطقی مورد انتظار با اندازه متغیر (ELBST).

-C, --storage-tag-check

این فلگ بررسی فیلد تگ ذخیره‌سازی (Storage Tag) را به عنوان بخشی از پردازش حفاظت داده سرتاسری (end-to-end) فعال می‌کند.

--force

مشغول بودن فضای نام (namespace) را نادیده گرفته و عملیات را در هر حالتی انجام می‌دهد.

-o <fmt>, --output-format=<fmt>

تنظیم قالب گزارش‌دهی روی normal، json یا binary. تنها می‌توان از یک قالب خروجی در یک زمان استفاده کرد.

-v, --verbose

افزایش جزئیات اطلاعات در خروجی.

--timeout=<timeout>

بازنویسی مقدار مهلت زمانی (timeout) پیش‌فرض. بر حسب میلی‌ثانیه.

هنوز مثالی ثبت نشده است.

بخشی از مجموعه nvme-user

02/16/2026 NVMe