نام (NAME)

nvme-format - قالببندی فضای نام NVMe

خلاصه دستور (SYNOPSIS)

nvme format <device> [--namespace-id=<nsid> | -n <nsid>]
                        [--lbaf=<lbaf> | -l <lbaf>]
                        [--block-size=<block size | -b <block size>]
                        [--ses=<ses> | -s <ses>] [--pil=<pil> | -p <pil>]
                        [--pi=<pi> | -i <pi>] [--ms=<ms> | -m <ms>]
                        [--reset | -r] [--force]
                        [--timeout=<timeout> | -t <timeout>]
                        [--output-format=<fmt> | -o <fmt>] [--verbose | -v]

توضیحات (DESCRIPTION)

دستور مدیریتی Format Namespace را برای دستگاه NVMe مشخص‌شده ارسال کرده و نتایج را ارائه می‌دهد.

پارامتر <device> الزامی است و می‌تواند یک دستگاه کاراکتری NVMe (مانند /dev/nvme0) یا یک دستگاه بلوکی فضای نام (مانند /dev/nvme0n1) باشد. اگر دستگاه کاراکتری داده شود و کنترلر از قالب‌بندی فضاهای نام خاص پشتیبانی نکند (بیت ۰ از ID_CTRL.FNA فعال باشد)، آن‌گاه همهٔ فضاهای نام قالب‌بندی خواهند شد. اگر FNA غیرفعال باشد، شناسهٔ فضای نام باید با گزینهٔ namespace-id مشخص شود؛ برای ارسال فرمان قالب‌بندی به تمامی فضاهای نام، مقدار 0xffffffff را تعیین کنید. اگر دستگاه بلوکی داده شود، شناسهٔ فضای نام به‌طور پیش‌فرض همان شناسهٔ فضای نام دستگاه بلوکی ارائه‌شده خواهد بود، اما با همان گزینه می‌توان آن را بازنویسی کرد.

توجه داشته باشید که پسوند عددی روی دستگاه کاراکتری، برای مثال 0 در /dev/nvme0، نشان‌دهندهٔ این نیست که این شناسهٔ دستگاه، کنترلر والد هر فضای نامی با همان پسوند است. ممکن است عدد شناسهٔ فضای نام از شناسهٔ زیرسیستم باشد که مستقل از شناسهٔ کنترلر است. بر اساس نام دستگاه‌ها هیچ رابطهٔ خاصی میان آن‌ها فرض نکنید؛ در غیر این صورت ممکن است داده‌های روی یک دستگاه دیگر را به شکل غیرقابل‌بازگشتی پاک کنید.

در صورت موفقیت، برنامه به‌طور خودکار فراخوان ioctl با نام BLKRRPART را برای وادار کردن به پویش مجدد فضاهای نام صادر می‌کند. اگر درایور به اندازهٔ کافی جدید باشد، این کار به‌طور خودکار اندازهٔ فیزیکی بلوک را به‌روزرسانی می‌کند. در صورتی که درایور به اندازهٔ کافی جدید نباشد و اندازهٔ بلوک با این دستور تغییر کرده باشد، لازم است دستگاه خود را به روش دیگری حذف و دوباره پویش کنید تا اندازهٔ بلوک جدید قابل مشاهده باشد.

گزینه‌ها (OPTIONS)

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

-l <lbaf>, --lbaf=<lbaf>

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

-s <ses>, --ses=<ses>

-p <pil>, --pil=<pil>

-i <pi>, --pi=<pi>

-m <ms>, --ms=<ms>

-r, --reset

--force

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

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

-v, --verbose

مثال‌ها (EXAMPLES)

# nvme format /dev/nvme0n1

# nvme format /dev/nvme0 --namespace-id=1 --ses=1 --pi=1

NVME

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