نام (NAME)

nvme-dir-receive - دریافت دایرکتوری NVMe

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

nvme dir-receive <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>]
                        [--req-resource=<nsr> | -r <nsr>]
                        [--human-readable | -H] [--raw-binary | -b]
                        [--output-format=<fmt> | -o <fmt>] [--verbose | -v]
                        [--timeout=<timeout> | -t <timeout>]

توضیحات (DESCRIPTION)

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

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

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

گزینه‌ها (OPTIONS)

-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).

-r <nsr>, --req-resource=<nsr>

تعداد منابع درخواستی رهنمود.

انتخاب (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

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

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

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

-v, --verbose

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

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

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

مثال‌ها (EXAMPLES)

•شناسایی نوع رهنمود پشتیبانی‌شده:

# nvme dir-receive /dev/nvme0 --dir-type 0 --dir-oper 1 --human-readable

•دریافت پارامترهای رهنمود جریان:

# nvme dir-receive /dev/nvme0 --dir-type 1 --dir-oper 1 --human-readable

•تخصیص ۳ جریان برای فضای‌نام ۱:

# nvme dir-receive /dev/nvme0n1 --dir-type 1 --dir-oper 3 --req-resource 3 --human-readable

•دریافت وضعیت رهنمود جریان‌ها:

# nvme dir-receive /dev/nvme0 --dir-type 1 --dir-oper 2 --human-readable

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

NVME

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

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

nvme(1), nvme-dir-send(1)