NVME-CREATE-NS(1) راهنمای NVMe NVME-CREATE-NS(1)

nvme-create-ns - ارسال دستور مدیریت فضای‌نام NVMe جهت ایجاد فضای‌نام و بازگرداندن نتایج

nvme create-ns <device> [--nsze=<nsze> | -s <nsze>]
                        [--ncap=<ncap> | -c <ncap>]
                        [--flbas=<flbas> | -f <flbas>]
                        [--dps=<dps> | -d <dps>]
                        [--nmic=<nmic> | -m <nmic>]
                        [--anagrp-id=<anagrpid> | -a <anagrpid>]
                        [--nvmset-id=<nvmsetid> | -i <nvmsetid>]
                        [--endg-id=<endgid> | -e <endgid>]
                        [--csi=<command_set_identifier> | -y <command_set_identifier>]
                        [--lbstm=<lbstm> | -l <lbstm>]
                        [--nphndls=<nphndls> | -n <nphndls>]
                        [--block-size=<block-size> | -b <block-size>]
                        [--timeout=<timeout> | -t <timeout>]
                        [--nsze-si=<nsze-si> | -S <nsze-si>]
                        [--ncap-si=<ncap-si> | -C <ncap-si>]
                        [--azr | -z]
                        [--rar=<rar> | -r <rar>]
                        [--ror=<ror> | -O <ror>]
                        [--rnumzrwa=<rnumzrwa> | -u <rnumzrwa>]
                        [--phndls=<placement-handle-list,> | -p <placement-handle-list,>]
                        [--output-format=<fmt> | -o <fmt>] [--verbose | -v]

برای دستگاه NVMe ارائه‌شده، یک دستور مدیریت فضای‌نام ارسال می‌کند تا فضای‌نام با تنظیمات درخواستی ایجاد شود. در صورت موفقیت، شناسه فضای‌نام اختصاص‌داده‌شده توسط کنترلر بازگردانده می‌شود.

پارامتر <device> اجباری است و می‌تواند یک دستگاه کاراکتری NVMe (مانند: /dev/nvme0) یا یک دستگاه بلوکی فضای‌نام (مانند: /dev/nvme0n1) باشد.

-s, --nsze

اندازه فضای‌نام.

-c, --ncap

ظرفیت فضای‌نام.

-f, --flbas

تنظیم اندازه بلوک منطقی قالب‌بندی‌شده فضای‌نام. با آرگومان --block-size تداخل دارد.

-d, --dps

تنظیمات حفاظت از داده‌ها.

-m, --nmic

قابلیت‌های چندمسیره و اشتراک‌گذاری فضای‌نام.

-a, --anagrp-id

شناسه گروه ANA. اگر این مقدار 0h باشد، مشخص می‌کند که کنترلر مقدار مورد استفاده را تعیین کند.

-i <nvmsetid>, --nvmset-id=<nvmsetid>

این فیلد شناسه NVM Set را مشخص می‌کند.

-e <endgid>, --endg-id=<endgid>

این فیلد شناسه گروه پایداری (Endurance Group) را مشخص می‌کند.

-y <command_set_identifier>, --csi=<command_set_identifier>

این فیلد شناسه مجموعه دستورات را مشخص می‌کند. در صورت عدم ارسال، مجموعه دستورات NVM انتخاب خواهد شد.

-l <lbstm>, --lbstm=<lbstm>

ماسک برچسب ذخیره‌سازی بلوک منطقی برای حفاظت سرتاسری (end-to-end).

-n <nphndls>, --nphndls=<nphndls>

تعداد دستگیره‌های جای‌گذاری موجود در فهرست دستگیره‌های جای‌گذاری (Placement Handle List). اگر قابلیت جای‌گذاری انعطاف‌پذیر داده‌ها (Flexible Data Placement) در گروه پایداری مشخص‌شده پشتیبانی نشود یا فعال نباشد، کنترلر این فیلد را نادیده خواهد گرفت.

-b, --block-size

اندازه بلوک هدف که فضای‌نام جدید باید بر اساس آن قالب‌بندی شود. مقادیر محتمل FLBAS بررسی شده و کمترین شماره برای عملیات create-ns انتخاب خواهد شد. با آرگومان --flbas تداخل دارد.

-S, --nsze-si

اندازه فضای‌نام (NSZE) در واحدهای استاندارد SI (هم‌تراز بر روی مرزهای 1Mib، مگر اینکه کنترلر مقدار دیگری را توصیه کند؛ دانه‌بندی فضای‌نام را ببینید). مقدار دارای پسوند SI بر اندازه LBA فضای‌نام تقسیم می‌شود تا به عنوان NSZE تنظیم گردد. اگر مقدار بدون پسوند باشد، همانند گزینه nsze تنظیم می‌شود.

-C, --ncap-si

ظرفیت فضای‌نام (NCAP) در واحدهای استاندارد SI (هم‌تراز بر روی مرزهای 1Mib، مگر اینکه کنترلر مقدار دیگری را توصیه کند؛ دانه‌بندی فضای‌نام را ببینید). مقدار دارای پسوند SI بر اندازه LBA فضای‌نام تقسیم می‌شود تا به عنوان NCAP تنظیم گردد. اگر مقدار بدون پسوند باشد، همانند گزینه ncap تنظیم می‌شود.

-z, --azr

تخصیص منابع ZRWA. اگر روی ۱ تنظیم شود، فضای‌نام با تعداد منبع ZRWA مشخص‌شده در فیلد RNUMZRWA این ساختار داده ایجاد خواهد شد. اگر روی ۰ پاک شود، هیچ منبع ZRWA به فضای‌نام در حال ایجاد تخصیص داده نمی‌شود.

-r <rar>, --rar=<rar>

منابع فعال درخواستی (Requested Active Resources). این فیلد تعداد منابع فعال را برای تخصیص به فضای‌نام ایجادشده مشخص می‌کند.

-O <ror>, --ror=<ror>

منابع باز درخواستی (Requested Open Resources). این فیلد تعداد منابع باز را برای تخصیص به فضای‌نام ایجادشده مشخص می‌کند.

-u <rnumzrwa>, --rnumzrwa=<rnumzrwa>

تعداد درخواستی منابع ZRWA. این فیلد تعداد منابع ZRWA را برای تخصیص به فضای‌نام ایجادشده مشخص می‌کند.

-p <placement-handle-list,>, --phndls=<placement-handle-list,>

فهرست جداشده با کاما از شناسه دستگیره واحد بازپس‌گیری (Reclaim Unit Handle Identifier) برای انتساب به هر دستگیره جای‌گذاری.

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

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

-v, --verbose

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

-t <timeout>, --timeout=<timeout>

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

•ایجاد یک فضای‌نام: 
# nvme create-ns /dev/nvme0 --nsze 11995709440 --ncap 1199570940 --flbas 0 --dps 0 --nmic 0
# nvme create-ns /dev/nvme0 --nsze-si 6.14T --ncap 1199570940 --flbas 0 --dps 0 --nmic 0

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

nvme(1)

02/16/2026 NVMe