.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Podwrapper::Man 1.24.3 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Required to disable full justification in groff 1.23.0.
.if n .ds AD l
.\" ========================================================================
.\"
.IX Title "nbdinfo 1"
.TH nbdinfo 1 2026-07-16 libnbd-1.24.3 LIBNBD
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "نام (NAME)"
nbdinfo \- نمایش اطلاعات و متاداده درباره کارسازها و اکسپورت‌های NBD
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
.Vb 1
\& nbdinfo [\-\-json] NBD
.Ve
.PP
\&\f(CW\*(C`NBD\*(C'\fR یک URI پروتکل NBD یا یک زیرپردازش (subprocess) است:
.PP
.Vb 2
\& NBD := nbd://... | nbd+unix:// (or other URI formats)
\&      | [ CMD ARGS ... ]
.Ve
.PP
.Vb 1
\& nbdinfo \-\-size [\-\-json] NBD
.Ve
.PP
.Vb 1
\& nbdinfo \-\-uri [\-\-json] NBD
.Ve
.PP
.Vb 2
\& nbdinfo \-\-is read\-only|rotational NBD
\& nbdinfo \-\-isnt read\-only|rotational NBD
.Ve
.PP
.Vb 2
\& nbdinfo \-\-can cache|connect|... NBD
\& nbdinfo \-\-cannot cache|connect|... NBD
.Ve
.PP
.Vb 1
\& nbdinfo \-\-map [\-\-totals] [\-\-json] NBD
.Ve
.PP
.Vb 1
\& nbdinfo \-L|\-\-list [\-\-json] NBD
.Ve
.PP
.Vb 1
\& nbdinfo \-\-help
.Ve
.PP
.Vb 1
\& nbdinfo \-\-version
.Ve
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
دستور nbdinfo اطلاعات و متاداده‌های مربوط به یک کارساز NBD را نمایش می‌دهد.
.PP
تنها پارامتر الزامی می‌تواند URI پروتکل NBD کارساز باشد (ببینید:
https://github.com/NetworkBlockDevice/nbd/blob/master/doc/uri.md):
.PP
.Vb 10
\& $ nbdinfo nbd://localhost
\& protocol: newstyle\-fixed without TLS, using structured packets
\& export="":
\&         export\-size: 1048576 (1M)
\&         content: data
\&         uri: nbd://localhost:10809/
\&         is_rotational: false
\&         is_read_only: false
\&         can_cache: true
\&         can_df: true
\&         can_fast_zero: true
\&         can_flush: true
\&         can_fua: true
\&         can_multi_conn: true
\&         can_trim: true
\&         can_zero: true
\&         block_size_minimum: 1
\&         block_size_preferred: 4096 (4K)
\&         block_size_maximum: 33554432 (32M)
.Ve
.PP
برای یک کارساز NBD بر روی یک سوکت محلی دامین یونیکس (Unix domain socket)، می‌توانید از دستوری مانند زیر استفاده کنید (با خروجی مشابه موارد بالا):
.PP
.Vb 1
\& $ nbdinfo "nbd+unix:///?socket=/tmp/unixsock"
.Ve
.PP
یا می‌توانید کارساز NBD را به صورت یک زیرپردازش اجرا کنید (بخش "زیرپردازش" در ادامه را ببینید):
.PP
.Vb 1
\& $ nbdinfo \-\- [ qemu\-nbd \-r \-f qcow2 file.qcow2 ]
.Ve
.SS "خروجی JSON (JSON output)"
.IX Subsection "JSON output"
برای نمایش خروجی در قالب JSON (مثلاً جهت اسکریپت‌نویسی با \fBjq\fR\|(1)) پارامتر \fI\-\-json\fR را اضافه کنید:
.PP
.Vb 10
\& $ nbdinfo \-\-json nbd://localhost | jq .
\& {
\&   "protocol": "newstyle\-fixed",
\&   "TLS": false,
\&   "structured": true,
\&   "extended": false,
\&   "exports": [
\&     {
\&       "export\-name": "",
\&       "content": "DOS/MBR boot sector; partition 1 : ID=0xc, start\-CHS (0x3ff,254,63), end\-CHS (0x3ff,254,63), startsector 2048, 4148704 sectors",
\&       "uri": "nbd://localhost:10809/",
\&       "is_rotational": false,
\&       "is_read_only": true,
\&       "can_cache": true,
\&       "can_df": true,
\&       "can_fast_zero": false,
\&       "can_flush": false,
\&       "can_fua": false,
\&       "can_multi_conn": true,
\&       "can_trim": false,
\&       "can_zero": false,
\&       "block_size_minimum": 1,
\&       "block_size_preferred": 4096,
\&       "block_size_maximum": 33554432,
\&       "export\-size": 2125119488,
\&       "export\-size\-str": "2075312K"
\&     }
\&   ]
\& }
.Ve
.SS "اندازه (Size)"
.IX Subsection "Size"
برای نمایش تنها اندازه اکسپورت NBD به بایت (مفید برای اسکریپت‌نویسی)، از پارامتر \fI\-\-size\fR استفاده کنید:
.PP
.Vb 2
\& $ nbdinfo \-\-size nbd://localhost
\& 1048576
.Ve
.PP
.Vb 2
\& $ nbdinfo \-\-size [ nbdkit null 1M ]
\& 1048576
.Ve
.SS "نشانی URI (URI)"
.IX Subsection "URI"
برای نمایش نشانی استاندارد (canonical URI):
.PP
.Vb 2
\& $ nbdinfo \-\-uri nbd://localhost
\& nbd://localhost:10809/
.Ve
.SS "آزمون فلگ‌ها (Test for flags)"
.IX Subsection "Test for flags"
از یکی از گزینه‌های \fI\-\-can\fR، \fI\-\-is\fR یا \fI\-\-has\fR در زیر برای بررسی فلگ‌های NBD استفاده کنید. این دستور چیزی چاپ نمی‌کند، بلکه در صورت درست بودن با موفقیت (کد\ خروج\ 0) و در صورت نادرست بودن با شکست (کد\ خروج\ 2) خارج می‌شود. (سایر کدهای خروج نشان‌دهنده بروز خطا در استعلام فلگ هستند).
.PP
گزینه‌های \&\fI\-\-cannot\fR، \fI\-\-isnt\fR و \fI\-\-hasnt\fR شرط آزمون را معکوس (نقیض) می‌کنند.
.PP
می‌توانید از آن در اسکریپت‌های شل به این صورت استفاده کنید:
.PP
.Vb 5
\& if nbdinfo \-\-is read\-only nbd://localhost ||
\&    nbdinfo \-\-cannot trim nbd://localhost
\& then
\&     error "the device must support writing and trimming"
\& fi
.Ve
.IP "nbdinfo \-\-is read\-only URI" 4
.IX Item "nbdinfo --is read-only URI"
بررسی اینکه آیا اکسپورت کارساز فقط‌خواندنی (read-only) است یا خیر.
.IP "nbdinfo \-\-can write URI" 4
.IX Item "nbdinfo --can write URI"
برای راحتی، این گزینه معکوس \fI\-\-is read\-only\fR است.
.IP "nbdinfo \-\-can read URI" 4
.IX Item "nbdinfo --can read URI"
تمامی کارسازهای NBD باید از خواندن پشتیبانی کنند، بنابراین این دستور همیشه با موفقیت خارج می‌شود (مگر اینکه در اتصال به URI خطایی رخ دهد).
.IP "nbdinfo \-\-can connect URI" 4
.IX Item "nbdinfo --can connect URI"
بررسی امکان برقراری اتصال به URI مربوط به NBD. این گزینه دست‌تکانی (handshake) پروتکل NBD را تا مرحله پردازش گزینه‌های NBD بررسی می‌کند، اما باز شدن حتمی اکسپورت را تضمین نمی‌نماید.
.IP "nbdinfo \-\-is tls URI" 4
.IX Item "nbdinfo --is tls URI"
بررسی اینکه آیا اتصال URI مربوط به NBD از TLS استفاده می‌کند یا خیر.
.IP "nbdinfo \-\-has structured\-reply URI" 4
.IX Item "nbdinfo --has structured-reply URI"
بررسی پشتیبانی کارساز از پاسخ‌های ساختاریافته (structured replies؛ که پیش‌نیاز پشتیبانی از دستورات وضعیت بلوک است).
.IP "nbdinfo \-\-has extended\-headers URI" 4
.IX Item "nbdinfo --has extended-headers URI"
بررسی پشتیبانی کارساز از هدرهای گسترش‌یافته (extended headers؛ که پیش‌نیاز پشتیبانی از دستورات ۶۴ بیتی است و شامل پاسخ‌های ساختاریافته نیز می‌شود).
.IP "nbdinfo \-\-is rotational URI" 4
.IX Item "nbdinfo --is rotational URI"
بررسی اینکه آیا اکسپورت کارساز توسط رسانه‌ای شبیه به دیسک چرخان (rotational) پشتیبانی می‌شود: دسترسی به بلوک‌های مجاور ممکن است سریع‌تر از دسترسی تصادفی باشد و برای بهبود کارایی باید درخواست‌ها مرتب شوند. بسیاری از کارسازها این مورد را به درستی گزارش نمی‌دهند یا قادر به گزارش آن نیستند.
.IP "nbdinfo \-\-can block\-status\-payload URI" 4
.IX Item "nbdinfo --can block-status-payload URI"
بررسی اینکه آیا اکسپورت کارساز از ارسال پی‌لود کلاینت برای محدود کردن پاسخ به دستور وضعیت بلوک پشتیبانی می‌کند یا خیر.
.IP "nbdinfo \-\-can cache URI" 4
.IX Item "nbdinfo --can cache URI"
.PD 0
.IP "nbdinfo \-\-can df URI" 4
.IX Item "nbdinfo --can df URI"
.IP "nbdinfo \-\-can fast\-zero URI" 4
.IX Item "nbdinfo --can fast-zero URI"
.IP "nbdinfo \-\-can flush URI" 4
.IX Item "nbdinfo --can flush URI"
.IP "nbdinfo \-\-can fua URI" 4
.IX Item "nbdinfo --can fua URI"
.IP "nbdinfo \-\-can multi\-conn URI" 4
.IX Item "nbdinfo --can multi-conn URI"
.IP "nbdinfo \-\-can trim URI" 4
.IX Item "nbdinfo --can trim URI"
.IP "nbdinfo \-\-can zero URI" 4
.IX Item "nbdinfo --can zero URI"
.PD
آزمون سایر مشخصات اکسپورت کارساز NBD.
.PP
در واقع گزینه‌های \fI\-\-can\fR، \fI\-\-is\fR و \fI\-\-has\fR، و همچنین \&\fI\-\-cannot\fR، \fI\-\-isnt\fR و \fI\-\-hasnt\fR مترادف یکدیگرند و می‌توانید آن‌ها را به جای هم به کار ببرید.
.SS "نقشه (Map)"
.IX Subsection "Map"
برای نمایش نقشه‌ای از بخش‌های تخصیص‌یافته (allocated) و تُنُک (sparse) دیسک، از گزینه \fI\-\-map\fR استفاده کنید:
.PP
.Vb 3
\& $ nbdinfo \-\-map nbd://localhost/
\&       0  1048576  0  data
\& 1048576  1048576  3  hole,zero
.Ve
.PP
فیلدها عبارتند از: نقطه آغاز (start)، اندازه (size)، نوع (type)، و توضیحات (description اختیاری).
.PP
فیلد نوع یک عدد صحیح است که مقدار خام پروتکل NBD را نشان می‌دهد. برای برخی نقشه‌ها، nbdinfo نحوه ترجمه نوع به یک توضیح قابل چاپ را می‌داند.
.PP
برای دریافت خروجی قابل تجزیه در قالب JSON، گزینه \fI\-\-json\fR را اضافه کنید:
.PP
.Vb 5
\& $ nbdinfo \-\-map \-\-json nbd://localhost/
\& [{ "offset": 0, "length": 1048576,
\&    "type": 0, "description": "data" },
\&  { "offset": 1048576, "length": 1048576,
\&    "type": 3, "description": "hole,zero" }]
.Ve
.PP
به طور پیش‌فرض این دستور نقشه \f(CW"base:allocation"\fR را نشان می‌دهد، اما می‌توانید نقشه‌های دیگر را نیز نمایش دهید:
.PP
.Vb 2
\& $ nbdinfo \-\-map=qemu:dirty\-bitmap:bitmap nbd://localhost/
\& 0  1048576  1  dirty
.Ve
.PP
برای اطلاعات بیشتر در مورد نقشه‌های NBD، به بخش \fIMetadata querying\fR در پروتکل NBD مراجعه کنید.
.SS "مجموع مقادیر نقشه (Map totals)"
.IX Subsection "Map totals"
استفاده از \fI\-\-map\ \-\-totals\fR همان عملیات \fI\-\-map\fR را انجام می‌دهد، اما خلاصه‌ای از اندازه کل هر نوع تخصیص را به بایت و به صورت درصد (از اندازه مجازی اکسپورت) نمایش می‌دهد. این امر برای تخمین میزان فضای واقعی استفاده‌شده در کارساز، یا فضای مورد نیاز هنگام کپی یک تصویر تُنُک با \fBnbdcopy\fR\|(1) مفید است.
.PP
در مثال زیر، نیمی (50.0%) از دیسک داده‌های تخصیص‌یافته و نیمی دیگر تخصیص‌نیافته است:
.PP
.Vb 3
\& $ nbdinfo \-\-map \-\-totals nbd://localhost/
\& 1048576  50.0%  0  data
\& 1048576  50.0%  3  hole,zero
.Ve
.PP
فیلدها عبارتند از: اندازه کل به بایت، درصد از اندازه مجازی، نوع، و توضیحات (اختیاری).
.PP
همچنین می‌توانید همین اطلاعات را به صورت ساختاریافته با استفاده از \fI\-\-json\fR دریافت کنید:
.PP
.Vb 5
\& $ nbdinfo \-\-map \-\-totals \-\-json nbd://localhost/
\& [{ "size": 1048576, "percent": 50,
\&    "type": 0, "description": "data" },
\&  { "size": 1048576, "percent": 50,
\&    "type": 3, "description": "hole,zero" }]
.Ve
.PP
همانند گزینه \fI\-\-map\fR، این گزینه نیز به طور پیش‌فرض نقشه \&\f(CW"base:allocation"\fR را نشان می‌دهد، اما می‌توانید خلاصه سایر نقشه‌ها را نیز مشاهده کنید.
.SS "فهرست کردن تمام اکسپورت‌ها (List all exports)"
.IX Subsection "List all exports"
برای فهرست کردن تمامی اکسپورت‌های موجود در یک کارساز NBD، از گزینه \fI\-\-list\fR (\fI\-L\fR) استفاده کنید. برای دریافت خروجی JSON قابل تجزیه، گزینه \fI\-\-json\fR را اضافه نمایید.
.PP
برای نمونه:
.PP
.Vb 10
\& $ nbdkit file dir=. \-\-run \*(Aqnbdinfo \-\-list "$uri"\*(Aq
\& protocol: newstyle\-fixed without TLS
\& export="Fedora\-Workstation\-Live\-x86_64\-29\-1.2.iso":
\&     export\-size: 1931476992 (1842M)
\&     uri: nbd://localhost:10809/Fedora\-Workstation\-Live\-x86_64\-29\-1.2.iso
\&     [...]
\& export="debian\-10.4.0\-amd64\-DVD\-1.iso":
\&     export\-size: 3955556352 (3862848K)
\&     uri: nbd://localhost:10809/debian\-10.4.0\-amd64\-DVD\-1.iso
\&     [...]
.Ve
.SS "زیرپردازش (Subprocess)"
.IX Subsection "Subprocess"
دستور nbdinfo همچنین می‌تواند یک کارساز NBD را به صورت یک زیرپردازش اجرا کند. این کار به یک کارساز NBD نیاز دارد که از فعال‌سازی سوکت systemd پشتیبانی کند، مانند \&\fBqemu\-nbd\fR\|(8) یا \fBnbdkit\fR\|(1). تمام حالت‌های معمول nbdinfo قابل استفاده هستند.
.PP
برای نمونه، جهت ارائه اطلاعات عمومی یا نمایش نقشه یک فایل qcow2:
.PP
.Vb 1
\& nbdinfo \-\- [ qemu\-nbd \-r \-f qcow2 file.qcow2 ]
.Ve
.PP
.Vb 1
\& nbdinfo \-\-map \-\- [ qemu\-nbd \-r \-f qcow2 file.qcow2 ]
.Ve
.PP
توجه داشته باشید که \f(CW\*(C`[\ ...\ ]\*(C'\fR پارامترهای مجزایی هستند و باید با فاصله احاطه شوند. \f(CW\*(C`\-\-\*(C'\fR پارامترهای nbdinfo را از پارامترهای زیرپردازش تفکیک می‌کند.
.SS "ابزارهای جایگزین (Alternative tools)"
.IX Subsection "Alternative tools"
می‌توانید از \f(CW\*(C`qemu\-img\ info\*(C'\fR (ببینید: \fBqemu\-img\fR\|(1)) برای پرس‌وجوی یک اکسپورت خاص از یک کارساز NBD استفاده کنید. دستور \f(CW\*(C`qemu\-nbd\ \-L\*(C'\fR (ببینید: \&\fBqemu\-nbd\fR\|(8)) می‌تواند اکسپورت‌های NBD را فهرست کند. ابزار \fBnbdsh\fR\|(1) یا رابط برنامه‌نویسی \&\fBlibnbd\fR\|(3) نیز می‌توانند برای پرس‌وجوهای پیچیده‌تر به کار روند.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
.IP \fB\-\-help\fR 4
.IX Item "--help"
نمایش راهنمای مختصر خط فرمان و خروج.
.IP "\fB\-\-can block\-status\-payload\fR" 4
.IX Item "--can block-status-payload"
.PD 0
.IP "\fB\-\-can cache\fR" 4
.IX Item "--can cache"
.IP "\fB\-\-can connect\fR" 4
.IX Item "--can connect"
.IP "\fB\-\-can df\fR" 4
.IX Item "--can df"
.IP "\fB\-\-can fast\-zero\fR" 4
.IX Item "--can fast-zero"
.IP "\fB\-\-can flush\fR" 4
.IX Item "--can flush"
.IP "\fB\-\-can fua\fR" 4
.IX Item "--can fua"
.IP "\fB\-\-can multi\-conn\fR" 4
.IX Item "--can multi-conn"
.IP "\fB\-\-can read\fR" 4
.IX Item "--can read"
.IP "\fB\-\-can trim\fR" 4
.IX Item "--can trim"
.IP "\fB\-\-can write\fR" 4
.IX Item "--can write"
.IP "\fB\-\-can zero\fR" 4
.IX Item "--can zero"
.PD
بررسی مشخصات اکسپورت کارساز NBD. این دستور چیزی چاپ نمی‌کند، بلکه در صورت درست بودن با موفقیت (کد\ خروج\ 0) و در صورت نادرست بودن با شکست (کد\ خروج\ 2) خارج می‌شود. (سایر کدهای خروج نشان‌دهنده بروز خطا در استعلام فلگ هستند).
.Sp
برای کسب اطلاعات بیشتر به پروتکل NBD و توابع libnbd زیر مراجعه کنید:
\&\fBnbd_can_block_status_payload\fR\|(3), \fBnbd_can_cache\fR\|(3),
\&\fBnbd_can_df\fR\|(3), \fBnbd_can_fast_zero\fR\|(3), \fBnbd_can_flush\fR\|(3),
\&\fBnbd_can_fua\fR\|(3), \fBnbd_can_multi_conn\fR\|(3), \fBnbd_can_trim\fR\|(3),
\&\fBnbd_can_zero\fR\|(3), \fBnbd_is_read_only\fR\|(3).
.IP "\fB\-\-cannot\fR flag" 4
.IX Item "--cannot flag"
بررسی نقیض فلگ مورد نظر.
.IP \fB\-\-color\fR 4
.IX Item "--color"
.PD 0
.IP \fB\-\-colour\fR 4
.IX Item "--colour"
.IP \fB\-\-no\-color\fR 4
.IX Item "--no-color"
.IP \fB\-\-no\-colour\fR 4
.IX Item "--no-colour"
.PD
فعال یا غیرفعال کردن رنگ‌های ANSI در خروجی. به طور پیش‌فرض اگر خروجی یک ترمینال باشد از رنگ‌ها استفاده می‌شود و در غیر این صورت غیرفعال می‌گردد.
.IP \fB\-\-content\fR 4
.IX Item "--content"
.PD 0
.IP \fB\-\-no\-content\fR 4
.IX Item "--no-content"
.PD
بیشتر اطلاعات نمایش‌داده‌شده از متاداده‌های ارسالی توسط کارساز NBD هنگام دست‌تکانی (handshake) به دست می‌آید. با این حال nbdinfo مقدار کمی داده از ابتدای اکسپورت را نیز دانلود می‌کند تا محتوا را با استفاده از \fBfile\fR\|(1) شناسایی کند.
.Sp
هنگامی که از \fI\-\-list\fR استفاده \fIنمی‌شود\fR، حالت پیش‌فرض \fI\-\-content\fR است، یعنی کاوش محتوا انجام می‌پذیرد. برای جلوگیری از کاوش محتوا، از \fI\-\-no\-content\fR استفاده کنید.
.Sp
هنگام استفاده از \fI\-\-list\fR، حالت پیش‌فرض \fI\-\-no\-content\fR است (زیرا دانلود از هر اکسپورت پرهزینه است). برای فعال کردن کاوش محتوا از \fI\-\-list \-\-content\fR استفاده کنید.
.IP "\fB\-\-has extended\-headers\fR" 4
.IX Item "--has extended-headers"
.PD 0
.IP "\fB\-\-has structured\-reply\fR" 4
.IX Item "--has structured-reply"
.PD
بررسی ویژگی‌های اتصال کارساز NBD. این دستور چیزی چاپ نمی‌کند، بلکه در صورت درست بودن با موفقیت (کد\ خروج\ 0) و در صورت نادرست بودن با شکست (کد\ خروج\ 2) خارج می‌شود. (سایر کدهای خروج نشان‌دهنده خطا در استعلام فلگ هستند).
.Sp
برای اطلاعات بیشتر به پروتکل NBD و توابع libnbd زیر مراجعه کنید:
\&\fBnbd_get_extended_headers_negotiated\fR\|(3),
\&\fBnbd_get_structured_replies_negotiated\fR\|(3).
.IP "\fB\-\-hasnt\fR flag" 4
.IX Item "--hasnt flag"
بررسی نقیض فلگ مورد نظر.
.IP "\fB\-\-is read\-only\fR" 4
.IX Item "--is read-only"
.PD 0
.IP "\fB\-\-is rotational\fR" 4
.IX Item "--is rotational"
.IP "\fB\-\-is tls\fR" 4
.IX Item "--is tls"
.PD
بررسی اینکه آیا اکسپورت کارساز NBD فقط‌خواندنی یا چرخان است، یا اینکه اتصال از TLS استفاده می‌کند یا خیر. این دستور چیزی چاپ نمی‌کند، بلکه در صورت درست بودن با موفقیت (کد\ خروج\ 0) و در صورت نادرست بودن با شکست (کد\ خروج\ 2) خارج می‌شود. (سایر کدهای خروج نشان‌دهنده خطا در استعلام فلگ هستند).
.Sp
برای کسب اطلاعات بیشتر به پروتکل NBD و توابع libnbd زیر مراجعه کنید:
\&\fBnbd_is_read_only\fR\|(3),
\&\fBnbd_is_rotational\fR\|(3), \fBnbd_get_tls_negotiated\fR\|(3).
.IP "\fB\-\-isnt\fR flag" 4
.IX Item "--isnt flag"
بررسی نقیض فلگ مورد نظر.
.IP \fB\-\-json\fR 4
.IX Item "--json"
خروجی در قالب JSON نمایش داده می‌شود.
.IP \fB\-L\fR 4
.IX Item "-L"
.PD 0
.IP \fB\-\-list\fR 4
.IX Item "--list"
.PD
فهرست کردن تمامی اکسپورت‌های موجود در یک کارساز NBD. نام اکسپورت در URI نادیده گرفته می‌شود.
.IP \fB\-\-map\fR 4
.IX Item "--map"
.PD 0
.IP \fB\-\-map=\fRMAP 4
.IX Item "--map=MAP"
.PD
نمایش نقشه (معمولاً اینکه چه بخش‌هایی از دیسک تخصیص‌یافته یا تُنُک هستند) برای اکسپورت داده‌شده. این گزینه به طور پیش‌فرض نقشه \f(CW"base:allocation"\fR را نشان می‌دهد، اما می‌توانید با پارامتر اختیاری نقشه دیگری را انتخاب کنید.
.Sp
بخش "نقشه" در بالا را ببینید.
.IP "\fB\-\-map\fR \fB\-\-totals\fR" 4
.IX Item "--map --totals"
.PD 0
.IP "\fB\-\-map=\fRMAP \fB\-\-totals\fR" 4
.IX Item "--map=MAP --totals"
.PD
مشابه \fI\-\-map\fR، اما خلاصه‌ای از اندازه کل هر نوع تخصیص را نمایش می‌دهد.
.Sp
بخش "مجموع مقادیر نقشه" در بالا را ببینید.
.IP \fB\-\-size\fR 4
.IX Item "--size"
فقط اندازه اکسپورت به بایت را نمایش می‌دهد.
.IP \fB\-\-uri\fR 4
.IX Item "--uri"
فقط URI استاندارد (canonical) را نمایش می‌دهد. در صورت ترکیب با \fI\-\-json\fR، خروجی به صورت یک رشته درون گیومه در قالب JSON خواهد بود.
.IP \fB\-V\fR 4
.IX Item "-V"
.PD 0
.IP \fB\-\-version\fR 4
.IX Item "--version"
.PD
نمایش نام بسته و نسخه و خروج.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
\&\fBlibnbd\fR\|(3),
\&\fBnbdcopy\fR\|(1),
\&\fBnbddiscard\fR\|(1),
\&\fBnbddump\fR\|(1),
\&\fBnbdfuse\fR\|(1),
\&\fBnbdsh\fR\|(1),
\&\fBnbdublk\fR\|(1),
\&\fBnbdzero\fR\|(1),
\&\fBfile\fR\|(1),
\&\fBjq\fR\|(1),
\&\fBqemu\-img\fR\|(1),
\&\fBqemu\-nbd\fR\|(8).
.SH "نویسندگان (AUTHORS)"
.IX Header "AUTHORS"
Richard W.M. Jones
.PP
Eric Blake
.SH "حق نشر (COPYRIGHT)"
.IX Header "COPYRIGHT"
Copyright Red Hat
.SH "مجوز (LICENSE)"
.IX Header "LICENSE"
این کتابخانه نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط مجوز عمومی همگانی کمتر گنو (LGPL) منتشرشده توسط بنیاد نرم‌افزارهای آزاد بازتوزیع کرده یا تغییر دهید؛ چه نسخه ۲ مجوز، و یا (به انتخاب خودتان) هر نسخه بعدی.
.PP
این کتابخانه با این امید توزیع شده است که سودمند باشد، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی تجاری بودن یا تناسب برای هدفی معین. برای جزئیات بیشتر به مجوز عمومی همگانی کمتر گنو مراجعه کنید.
.PP
شما باید همراه با این کتابخانه یک نسخه از مجوز عمومی همگانی کمتر گنو را دریافت کرده باشید؛ در غیر این صورت، به آدرس زیر در بنیاد نرم‌افزارهای آزاد مکاتبه کنید:
Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110\-1301 USA