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

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

خلاصه دستور (SYNOPSIS)
       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>]

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

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

گزینه‌ها (OPTIONS)
       -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).

مثال‌ها (EXAMPLES)
       •   پیوست کردن دادهٔ "hello world" در قالب بلوک‌هایی به اندازهٔ 4k به
           ناحیه‌ای که از بلوک ۰ آغاز می‌شود در فضای نام ۱:

               # echo "hello world" | nvme zns zone-append /dev/nvme0 -n 1 -s 0 -z 4k

همچنین ببینید (SEE ALSO)
       nvme(1)

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

NVMe                              02/16/2026              NVME-ZNS-ZONE-APP(1)