NVME-ZNS-ZONE-APP(1) راهنمای NVMe NVME-ZNS-ZONE-APP(1)

nvme-zns-zone-append - ارسال دستور پیوست به ناحیه در NVMe و ارائه نتایج

nvme-zns-zone-append <device> [--namespace-id=<NUM> | -n <NUM>]
                                [--zslba=<IONUM> | -s <IONUM>]
                                [--data-size=<IONUM> | -z <IONUM>]
                                [--metadata-size=<IONUM> | -y <IONUM>]
                                [--data=<FILE> | -d <FILE>]
                                [--metadata=<FILE> | -M <FILE>]
                                [--limited-retry | -l]
                                [--force-unit-access | -f]
                                [--ref-tag=<NUM> | -r <NUM>]
                                [--app-tag-mask=<NUM> | -m <NUM>]
                                [--app-tag=<NUM> | -a <NUM>]
                                [--prinfo=<NUM> | -p <NUM>]

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

در صورت موفقیت، برنامه آدرس LBA اختصاص‌یافته به داده‌ها را برای عملیات پیوست (append) گزارش می‌دهد.

-n <NUM>, --namespace-id=<NUM>

استفاده از شناسهٔ فضای نام (namespace id) ارائه‌شده برای دستور. در صورت عدم ارائه، از شناسهٔ فضای نام دستگاه بلوکی استفاده خواهد شد. اگر دستور برای یک دستگاه غیربلوکی صادر شود، این پارامتر الزامی است.

-s <IONUM>, --zslba=<IONUM>, -z <IONUM>, --data-size=<IONUM>

اندازهٔ داده به بایت (و آدرس LBA شروع ناحیه - ZSLBA).

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

اندازهٔ متاداده به بایت.

-d <FILE>, --data=<FILE>

فایل داده حاوی اطلاعاتی که باید نوشته شوند. در صورت عدم ارائه، محتوا از STDIN ارسال می‌شود.

-M <FILE>, --metadata=<FILE>

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

-l, --limited-retry

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

-f, --force-unit-access

پرچم دسترسی مستقیم به واحد (force-unit access) را تنظیم می‌کند.

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

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

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

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

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

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

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

تعریف فیلد اطلاعات حفاظت (Protection Information).

•پیوست کردن دادهٔ "hello world" در قالب بلوک‌هایی به اندازهٔ 4k به ناحیه‌ای که از بلوک ۰ آغاز می‌شود در فضای نام ۱:
# echo "hello world" | nvme zns zone-append /dev/nvme0 -n 1 -s 0 -z 4k

nvme(1)

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

02/16/2026 NVMe