.\" Man page generated from reStructuredText .\" by the Docutils 0.23 manpage writer. . . .nr rst2man-indent-level 0 . .de1 rstReportMargin \\$1 \\n[an-margin] level \\n[rst2man-indent-level] level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] - \\n[rst2man-indent0] \\n[rst2man-indent1] \\n[rst2man-indent2] .. .de1 INDENT .\" .rstReportMargin pre: . RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .\" .rstReportMargin post: .. .de UNINDENT . RE .\" indent \\n[an-margin] .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] .nr rst2man-indent-level -1 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. .TH "QEMU-NBD" "8" "Aug 28, 2026" "11.1.1" "QEMU" .SH "نام (NAME)" qemu-nbd \- سرور دیسک با پروتکل Network Block Device در QEMU .SH "خلاصه دستور (SYNOPSIS)" .sp \fBqemu\-nbd\fP [\fIOPTION\fP]... \fIfilename\fP .sp \fBqemu\-nbd\fP \-L [\fIOPTION\fP]... .sp \fBqemu\-nbd\fP \-d \fIdev\fP .SH "توضیحات (DESCRIPTION)" .sp اکسپورت و اشتراک‌گذاری یک ایمیج دیسک QEMU با استفاده از پروتکل NBD. .sp سایر کاربردها: .INDENT 0.0 .IP \(bu 2 اتصال یک دستگاه بلوکی /dev/nbdX به یک سرور QEMU (در لینوکس). .IP \(bu 2 به عنوان کلاینت برای پرس‌وجوی اکسپورت‌های یک سرور NBD راه دور. .UNINDENT .SH "گزینه‌ها (OPTIONS)" .sp \fIfilename\fP نام فایل ایمیج دیسک است، یا در صورت مشخص شدن \fB\-\-image\-opts\fP مجموعه‌ای از گزینه‌های درایور بلوکی است. .sp \fIdev\fP یک دستگاه NBD است. .INDENT 0.0 .TP .B \-\-object type,id=ID,... تعریف یک نمونه جدید از کلاس شیء \fItype\fP که با \fIID\fP مشخص می‌شود. برای جزئیات کامل خصوصیات پشتیبانی‌شده، صفحه راهنمای \fBqemu(1)\fP را ببینید. انواع متداول شیء که تعریف آن‌ها منطقی است عبارتند از شیء \fBsecret\fP، که برای تامین گذرواژه‌ها و/یا کلیدهای رمزنگاری استفاده می‌شود، و شیء \fBtls\-creds\fP، که برای ارائه گواهی‌های TLS به سرور یا کلاینت \fBqemu\-nbd\fP به کار می‌رود. .UNINDENT .INDENT 0.0 .TP .B \-p, \-\-port=PORT درگاه TCP برای گوش دادن به عنوان سرور، یا اتصال به عنوان کلاینت (پیش‌فرض \fB10809\fP). .UNINDENT .INDENT 0.0 .TP .B \-o, \-\-offset=OFFSET آفست (موقعیت جابه‌جایی) در ایمیج. .UNINDENT .INDENT 0.0 .TP .B \-b, \-\-bind=IFACE رابط شبکه برای مقید شدن به عنوان سرور، یا اتصال به عنوان کلاینت (پیش‌فرض \fB0.0.0.0\fP). .UNINDENT .INDENT 0.0 .TP .B \-k, \-\-socket=PATH استفاده از یک سوکت یونیکس با مسیر \fIPATH\fP. .UNINDENT .INDENT 0.0 .TP .B \-\-image\-opts در نظر گرفتن \fIfilename\fP به عنوان مجموعه‌ای از گزینه‌های ایمیج به جای یک نام فایل ساده. اگر این فلگ مشخص شود، نباید از فلگ \fB\-f\fP استفاده شود و در عوض باید گزینه \fBformat=\fP تنظیم گردد. .UNINDENT .INDENT 0.0 .TP .B \-f, \-\-format=FMT اجبار به استفاده از درایور بلوکی برای فرمت \fIFMT\fP به جای تشخیص خودکار. .UNINDENT .INDENT 0.0 .TP .B \-r, \-\-read\-only اکسپورت دیسک به صورت فقط‌خواندنی. .UNINDENT .INDENT 0.0 .TP .B \-A, \-\-allocation\-depth نمایش اطلاعات عمق تخصیص از طریق زمینه متادیتای \fBqemu:allocation\-depth\fP قابل دسترس از طریق NBD_OPT_SET_META_CONTEXT. .UNINDENT .INDENT 0.0 .TP .B \-B, \-\-bitmap=NAME اگر \fIfilename\fP دارای یک بیت‌مپ ماندگار qcow2 با نام \fINAME\fP باشد، آن بیت‌مپ را از طریق زمینه متادیتای \fBqemu:dirty\-bitmap:NAME\fP قابل دسترس از طریق NBD_OPT_SET_META_CONTEXT نمایش می‌دهد. .UNINDENT .INDENT 0.0 .TP .B \-s, \-\-snapshot استفاده از \fIfilename\fP به عنوان یک اسنپ‌شات خارجی، ایجاد یک فایل موقت با \fBbacking_file=\fP\fIfilename\fP و هدایت عملیات نوشتن به فایل موقت. .UNINDENT .INDENT 0.0 .TP .B \-l, \-\-load\-snapshot=SNAPSHOT_PARAM بارگذاری یک اسنپ‌شات داخلی درون \fIfilename\fP و اکسپورت آن به عنوان یک دستگاه فقط‌خواندنی؛ فرمت SNAPSHOT_PARAM عبارت است از \fBsnapshot.id=[ID],snapshot.name=[NAME]\fP یا \fB[ID_OR_NAME]\fP. .UNINDENT .INDENT 0.0 .TP .B \-\-cache=CACHE حالت کَش مورد استفاده با فایل. مقادیر معتبر عبارتند از: \fBnone\fP، \fBwriteback\fP (پیش‌فرض)، \fBwritethrough\fP، \fBdirectsync\fP و \fBunsafe\fP. برای اطلاعات بیشتر مستندات گزینه \fB\-drive cache=...\fP شبیه‌ساز را ببینید. .UNINDENT .INDENT 0.0 .TP .B \-n, \-\-nocache معادل با \fB\-\-cache=none\fP. .UNINDENT .INDENT 0.0 .TP .B \-\-aio=AIO تنظیم حالت ورودی/خروجی ناهمگام بین \fBthreads\fP (پیش‌فرض)، \fBnative\fP (فقط لینوکس)، و \fBio_uring\fP (لینوکس +5.1). .UNINDENT .INDENT 0.0 .TP .B \-\-discard=DISCARD کنترل اینکه آیا درخواست‌های \fBdiscard\fP (همچنین شناخته‌شده به عنوان \fBtrim\fP یا \fBunmap\fP) نادیده گرفته شوند یا به سیستم‌فایل منتقل شوند. \fIDISCARD\fP یکی از مقادیر \fBignore\fP (یا \fBoff\fP) یا \fBunmap\fP (یا \fBon\fP) است. مقدار پیش‌فرض \fBignore\fP است. .UNINDENT .INDENT 0.0 .TP .B \-\-detect\-zeroes=DETECT_ZEROES کنترل تبدیل خودکار عملیات نوشتن صفر ساده توسط سیستم‌عامل به دستورات بهینه‌شده نوشتن صفر مخصوص درایور. \fIDETECT_ZEROES\fP یکی از مقادیر \fBoff\fP، \fBon\fP، یا \fBunmap\fP است. مقدار \fBunmap\fP عملیات نوشتن صفر را به عملیات unmap تبدیل می‌کند و فقط زمانی قابل استفاده است که \fIDISCARD\fP روی \fBunmap\fP تنظیم شده باشد. مقدار پیش‌فرض \fBoff\fP است. .UNINDENT .INDENT 0.0 .TP .B \-c, \-\-connect=DEV اتصال \fIfilename\fP به دستگاه NBD به نام \fIDEV\fP (فقط لینوکس). .UNINDENT .INDENT 0.0 .TP .B \-d, \-\-disconnect قطع اتصال دستگاه \fIDEV\fP (فقط لینوکس). .UNINDENT .INDENT 0.0 .TP .B \-e, \-\-shared=NUM اجازه دادن به حداکثر \fINUM\fP کلاینت برای اشتراک‌گذاری دستگاه (پیش‌فرض \fB1\fP)، مقدار 0 برای نامحدود. .UNINDENT .INDENT 0.0 .TP .B \-t, \-\-persistent عدم خروج پس از قطع آخرین اتصال. .UNINDENT .INDENT 0.0 .TP .B \-x, \-\-export\-name=NAME تنظیم نام اکسپورت حجم NBD (پیش‌فرض یک رشته با طول صفر است). .UNINDENT .INDENT 0.0 .TP .B \-D, \-\-description=DESCRIPTION تنظیم توضیحات اکسپورت حجم NBD به صورت یک رشته خوانا برای انسان. .UNINDENT .INDENT 0.0 .TP .B \-\-handshake\-limit=N تنظیم مهلت زمانی برای تکمیل موفقیت‌آمیز دست‌تکانی کلاینت به N ثانیه (پیش‌فرض 10)، یا 0 برای بدون محدودیت. .UNINDENT .INDENT 0.0 .TP .B \-L, \-\-list اتصال به عنوان کلاینت و فهرست کردن تمام جزئیات مربوط به اکسپورت‌های ارائه‌شده توسط یک سرور NBD راه دور. این گزینه حالت فهرست‌گیری را فعال می‌کند و با گزینه‌هایی که رفتار مربوط به یک اکسپورت خاص را تغییر می‌دهند (مانند \fB\-\-export\-name\fP، \fB\-\-offset\fP، ...) ناسازگار است. .UNINDENT .INDENT 0.0 .TP .B \-\-tls\-creds=ID فعال‌سازی رمزنگاری اجباری TLS برای سرور از طریق تنظیم شناسه شیء اعتبارنامه‌های TLS که قبلاً با گزینه \fB\-\-object\fP ایجاد شده است؛ یا ارائه اعتبارنامه‌های لازم برای اتصال به عنوان کلاینت در حالت فهرست‌گیری. .UNINDENT .INDENT 0.0 .TP .B \-\-tls\-hostname=hostname هنگام اعتبارسنجی گواهی x509 دریافت شده از طریق اتصال TLS، نام میزبان که کلاینت NBD برای اتصال استفاده کرده است با اطلاعات موجود در گواهی ارائه‌شده توسط سرور مطابقت داده می‌شود. گاهی اوقات ممکن است بازنویسی نام میزبان استفاده‌شده برای انجام این بررسی لازم باشد. برای مثال، اگر کلاینت NBD از یک تونل از localhost برای اتصال به سرور راه دور استفاده می‌کند، باید از گزینه \fB\-\-tls\-hostname\fP برای تنظیم نام میزبان رسمی و مورد انتظار سرور NBD راه دور استفاده شود. همچنین در صورت دسترسی به NBD از طریق یک سوکت UNIX که نام میزبان ذاتی در دسترس نیست، می‌توان از این گزینه استفاده کرد. این کار فقط هنگام عمل به عنوان کلاینت NBD با گزینه \fB\-\-list\fP مجاز است. .UNINDENT .INDENT 0.0 .TP .B \-\-fork انشعاب فرآیند سرور و خروج والد پس از شروع به کار سرور. .UNINDENT .INDENT 0.0 .TP .B \-\-pid\-file=PATH ذخیره شناسه فرآیند سرور در فایل مشخص‌شده. .UNINDENT .INDENT 0.0 .TP .B \-\-tls\-authz=ID مشخص کردن شناسه یک شیء qauthz که قبلاً با گزینه \fB\-\-object\fP ایجاد شده است. این گزینه برای اعتبارسنجی کاربران متصل‌شونده بر اساس نام مشخص‌شده x509 آن‌ها استفاده خواهد شد. .UNINDENT .INDENT 0.0 .TP .B \-v, \-\-verbose نمایش اطلاعات اشکال‌زدایی بیشتر. این گزینه همچنین در صورتی که فرآیند \fBqemu\-nbd\fP به دلیل گزینه‌های دیگری مانند \fB\-\-fork\fP یا \fB\-c\fP دیمن شده باشد، جریان اصلی \fISTDERR\fP را باز نگه می‌دارد. .UNINDENT .INDENT 0.0 .TP .B \-h, \-\-help نمایش این راهنما و خروج. .UNINDENT .INDENT 0.0 .TP .B \-V, \-\-version نمایش اطلاعات نسخه و خروج. .UNINDENT .INDENT 0.0 .TP .B \-T, \-\-trace [[enable=]PATTERN][,events=FILE][,file=FILE] مشخص کردن گزینه‌های ردیابی. .sp \fB[enable=]PATTERN\fP .INDENT 7.0 .INDENT 3.5 فعال‌سازی فوری رویدادهای منطبق با \fIPATTERN\fP (خواه نام رویداد باشد یا یک الگوی globbing). این گزینه تنها در صورتی در دسترس است که QEMU با یکی از بک‌اندهای ردیابی \fBsimple\fP، \fBlog\fP یا \fBftrace\fP کامپایل شده باشد. برای تعیین چندین رویداد یا الگو، گزینه \fB\-trace\fP را چندین بار مشخص کنید. .sp از \fB\-trace help\fP برای چاپ فهرستی از نام‌های نقاط ردیابی استفاده کنید. .UNINDENT .UNINDENT .sp \fBevents=FILE\fP .INDENT 7.0 .INDENT 3.5 فعال‌سازی فوری رویدادهای فهرست‌شده در \fIFILE\fP. این فایل باید در هر سطر شامل نام یک رویداد باشد (همان‌طور که در فایل \fBtrace\-events\-all\fP فهرست شده است)؛ الگوهای globbing نیز پذیرفته می‌شوند. این گزینه تنها در صورتی در دسترس است که QEMU با یکی از بک‌اندهای ردیابی \fBsimple\fP، \fBlog\fP یا \fBftrace\fP کامپایل شده باشد. .UNINDENT .UNINDENT .sp \fBfile=FILE\fP .INDENT 7.0 .INDENT 3.5 ثبت خروجی ردیابی‌ها در \fIFILE\fP. این گزینه تنها در صورتی در دسترس است که QEMU با بک‌اند ردیابی \fBsimple\fP کامپایل شده باشد. .UNINDENT .UNINDENT .UNINDENT .SH "مثال‌ها (EXAMPLES)" .sp راه‌اندازی سروری که روی پورت 10809 گوش می‌دهد و فقط محتویات قابل مشاهده برای سیستم مهمان یک فایل qcow2 را بدون رمزنگاری TLS و با نام پیش‌فرض اکسپورت (یک رشته خالی) ارائه می‌دهد. این دستور یک‌بار‌مصرف است و تا زمانی که اولین کلاینت موفق قطع اتصال نکند، مسدود خواهد ماند: .INDENT 0.0 .INDENT 3.5 .sp .EX qemu\-nbd \-f qcow2 file.qcow2 .EE .UNINDENT .UNINDENT .sp راه‌اندازی سرور ماندگار با رمزنگاری روی پورت 10810 و اجازه دادن به کلاینت‌هایی با یک گواهی X.509 مشخص برای اتصال به یک زیرمجموعه ۱ مگابایتی از یک فایل raw، با استفاده از نام اکسپورت \(aqsubset\(aq: .INDENT 0.0 .INDENT 3.5 .sp .EX qemu\-nbd \e \-\-object tls\-creds\-x509,id=tls0,endpoint=server,dir=/path/to/qemutls \e \-\-object \(aqauthz\-simple,id=auth0,identity=CN=laptop.example.com,,\e O=Example Org,,L=London,,ST=London,,C=GB\(aq \e \-\-tls\-creds tls0 \-\-tls\-authz auth0 \e \-t \-x subset \-p 10810 \e \-\-image\-opts driver=raw,offset=1M,size=1M,file.driver=file,file.filename=file.raw .EE .UNINDENT .UNINDENT .sp سرویس‌دهی یک نسخه فقط‌خواندنی از یک ایمیج مهمان روی سوکت یونیکس با حداکثر ۵ خواننده هم‌زمان، با یک فرآیند ماندگار که به صورت دیمن فورک شده است: .INDENT 0.0 .INDENT 3.5 .sp .EX qemu\-nbd \-\-fork \-\-persistent \-\-shared=5 \-\-socket=/path/to/sock \e \-\-read\-only \-\-format=qcow2 file.qcow2 .EE .UNINDENT .UNINDENT .sp ارائه محتویات قابل مشاهده برای مهمان از یک فایل qcow2 از طریق یک دستگاه بلوکی /dev/nbd0 (و احتمالاً ایجاد /dev/nbd0p1 و موارد مشابه برای پارتیشن‌های یافت‌شده در آن)، سپس قطع اتصال دستگاه پس از اتمام کار. دسترسی برای متصل کردن \fBqemu\-nbd\fP به یک دستگاه /dev/nbd عموماً نیازمند مجوزهای دسترسی ریشه است، و همچنین ممکن است برای فعال‌سازی ماژول کلاینت NBD هسته نیاز به اجرای \fBmodprobe nbd\fP باشد. \fIهشدار\fP: از این روش برای سوار کردن (mount) سیستم‌فایل‌ها از یک ایمیج مهمان غیرقابل اعتماد استفاده نکنید \- یک مهمان مخرب ممکن است ایمیج را به گونه‌ای آماده کرده باشد که اشکالات هسته را در پویش پارتیشن یا مانت کردن سیستم‌فایل تحریک کند. .INDENT 0.0 .INDENT 3.5 .sp .EX qemu\-nbd \-c /dev/nbd0 \-f qcow2 file.qcow2 qemu\-nbd \-d /dev/nbd0 .EE .UNINDENT .UNINDENT .sp پرس‌وجو از یک سرور راه دور برای مشاهده جزئیات مربوط به اکسپورت(هایی) که روی پورت 10809 ارائه می‌دهد و احراز هویت از طریق PSK: .INDENT 0.0 .INDENT 3.5 .sp .EX qemu\-nbd \e \-\-object tls\-creds\-psk,id=tls0,dir=/tmp/keys,username=eblake,endpoint=client \e \-\-tls\-creds tls0 \-L \-b remote.example.com .EE .UNINDENT .UNINDENT .SH "همچنین ببینید (SEE ALSO)" .sp \fBqemu(1)\fP, \fBqemu\-img(1)\fP .SH "نویسندگان (AUTHORS)" Anthony Liguori .SH "حق نشر (COPYRIGHT)" 2026, The QEMU Project Developers .\" End of generated man page.