NVME-DIR-SEND(1) راهنمای NVMe NVME-DIR-SEND(1)

nvme-dir-send - ارسال یک دستور directive send و بازگرداندن نتایج مربوطه

nvme dir-send <device> [--namespace-id=<nsid> | -n <nsid>]
                        [--data-len=<data-len> | -l <data-len>]
                        [--dir-type=<dtype> | -D <dtype>]
                        [--dir-spec=<dspec> | -S <dspec>]
                        [--dir-oper=<doper> | -O <doper>]
                        [--endir=<endir> | -e <endir>]
                        [--target-dir=<tdir> | -T <tdir>]
                        [--human-readable | -H] [--raw-binary | -b]
                        [--output-format=<fmt> | -o <fmt>] [--verbose | -v]
                        [--timeout=<timeout> | -t <timeout>]

یک دستور مدیریتی Directive Send در NVMe را ارسال کرده و نتایج مربوطه را بازمی‌گرداند. این نتایج ممکن است ترکیبی از نوع رهنمود (directive type) و عملیات (operation)، و همچنین رهنمود هدف (target directive) و وضعیت فعال/غیرفعال بودن عملیات در صورت نیاز عملیات خاص باشد.

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

در صورت موفقیت، ساختار پارامترهای رهنمود بازگردانده‌شده (در صورت وجود) بسته به فلگ‌های گزینه‌ها به یکی از چند روش بازگردانده می‌شود؛ این ساختار ممکن است توسط برنامه تجزیه شده و به صورت هگزادسیمال نمایش داده شود، یا اینکه بافر خام ممکن است در stdout چاپ شود تا برنامه دیگری آن را تجزیه کند.

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

دریافت ویژگی برای nsid داده‌شده. این گزینه اختیاری است و بیشتر ویژگی‌ها از این مقدار استفاده نمی‌کنند.

-D <dtype>, --dir-type=<dtype>

نوع رهنمود (Directive type).

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

مشخصه ویژه رهنمود (Directive specific).

-O <doper>, --dir-oper=<doper>

عملیات رهنمود (Directive operation).

-T <tdir>, --target-dir=<nsr>

رهنمود هدف عملیات (Target directive).

-e <endir>, --endir=<endir>

عملیات فعال‌سازی (1) یا غیرفعال‌سازی (0) رهنمود هدف.
انتخاب (Select) توضیحات (Description)
0 کنونی (Current)
1 پیش‌فرض (Default)
2 ذخیره‌شده (Saved)
3 قابلیت‌های پشتیبانی‌شده (Supported capabilities)
4–7 رزرو شده (Reserved)

-l <data-len>, --data-len=<data-len>

طول داده برای بافر بازگردانده‌شده برای این ویژگی. بیشتر ویژگی‌های شناخته‌شده از این مقدار استفاده نمی‌کنند؛ استثنای آن LBA Range Type است.

-b, --raw-binary

در صورتی که دستور یک ساختار را بازگرداند، بافر خام دریافتی را در stdout چاپ می‌کند.

-H, --human-readable

منسوخ شده است؛ هیچ کاری انجام نمی‌دهد، بنابراین به جای آن از فلگ --verbose استفاده کنید.

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

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

-v, --verbose

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

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

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

•فعال‌سازی رهنمود جریان‌ها (streams directive) : 
# nvme dir-send /dev/nvme0n1 --dir-type 0 --dir-oper 1 --target-dir 1 --endir 1
•غیرفعال‌سازی رهنمود جریان‌ها (streams directive) : 
# nvme dir-send /dev/nvme0n1 --dir-type 0 --dir-oper 1 --target-dir 1 --endir 0
•آزادسازی تمام منابع تخصیص‌یافته جریان‌ها (streams resource) : 
# nvme dir-send /dev/nvme0n1 --dir-type 1 --dir-oper 2
•آزادسازی شناسه جریان ۳ (stream ID 3) : 
# nvme dir-send /dev/nvme0 --dir-type 1 --dir-oper 1 --dir-spec 3

احتمالاً ایدهٔ بدی است که هنگام استفاده از این حالت، stdout را تغییر مسیر (redirect) ندهید.

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

nvme(1), nvme-dir-receive(1)

02/16/2026 NVMe