NVME-WRITE(1) NVMe Manual NVME-WRITE(1)

nvme-write - ارسال مستقیم دستور نوشتن داده (Write) به دستگاه NVMe

nvme-write <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>]

دستور Write بلوک‌های منطقی مشخص‌شده توسط دستور را از بافر داده ارائه‌شده بر روی رسانه می‌نویسد. در صورتی که فایلی تعیین نشود، به‌طور پیش‌فرض از ورودی استاندارد (stdin) استفاده خواهد شد.

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

بلوک آغازین.

-c, --block-count

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

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

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

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

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

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

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

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

فایل داده. در صورت ارائه نشدن، محتوا از ورودی استاندارد (STDIN) ارسال می‌شود.

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

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

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

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

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

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

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

ماسک برچسب برنامه (application tag mask) اختیاری هنگام استفاده با اطلاعات محافظت.

-a <apptag>, --app-tag=<apptag>

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

-l, --limited-retry

فلگ تلاش مجدد محدود (limited retry) را تنظیم می‌کند.

-f, --force-unit-access

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

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

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

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

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

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

مشخصه‌های اختیاری مدیریت مجموعه داده (DSM) برای این دستور. آرگومان این گزینه، ۸ بیت کم‌ارزش‌تر فیلد DSM در یک دستور نوشتن است؛ ۱۶ بیت باارزش‌تر این فیلد (در صورت استفاده) از فیلد مشخصات دستورالعمل به دست می‌آید. این گزینه می‌تواند برای تنظیم ویژگی‌های 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

این فلگ بررسی فیلد برچسب ذخیره‌سازی را به عنوان بخشی از پردازش محافظت داده سرتاسری فعال می‌کند.

--force

مشغول بودن فضای نام در زمان جاری را نادیده می‌گیرد و با وجود آن عملیات را انجام می‌دهد.

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

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

-v, --verbose

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

--timeout=<timeout>

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

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

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

02/16/2026 NVMe