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

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

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

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

       پارامتر <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).

       -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>
           بازنویسی مقدار مهلت زمانی پیش‌فرض. بر حسب میلی‌ثانیه.

مثال‌ها (EXAMPLES)
       •   فعال‌سازی رهنمود جریان‌ها (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
       بخشی از مجموعه nvme-user

همچنین ببینید (SEE ALSO)
       nvme(1), nvme-dir-receive(1)

NVMe                              02/16/2026                  NVME-DIR-SEND(1)