.\" -*- 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 "libnbd-release-notes-1.8 1"
.TH libnbd-release-notes-1.8 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)"
libnbd\-release\-notes\-1.8 \- یادداشت‌های انتشار libnbd نسخهٔ 1.8
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
این یادداشت‌های انتشار برای نسخهٔ پایدار libnbd 1.8 است.
این سند تغییرات عمده را از نسخهٔ 1.6 توصیف می‌کند.
.PP
بستهٔ libnbd 1.8.0 در \fB۷ ژوئن ۲۰۲۱\fR منتشر شد.
.PP
اکنون libnbd در gitlab میزبانی می‌شود:
https://listman.redhat.com/archives/libguestfs/2021\-February/msg00021.html
.SS "امنیت"
.IX Subsection "Security"
اگر نقصی امنیتی پیدا کردید، لطفاً فایل \fISECURITY\fR را در سورس‌کد بخوانید
(به‌صورت برخط در اینجا:
https://gitlab.com/nbdkit/libnbd/blob/master/SECURITY). برای
آگاهی از مسائل امنیتی پیشین در libnbd، به
\&\fBlibnbd\-security\fR\|(3) مراجعه کنید.
.PP
در طول چرخهٔ این نسخه یک باگ امنیتی در libnbd پیدا شد.
.PP
\fICVE\-2021\-20286 انکار سرویس هنگام استفاده از \fR\f(BInbd_set_opt_mode\fR\fI\|(3)\fR
.IX Subsection "CVE-2021-20286 denial of service when using nbd_set_opt_mode"
.PP
اعلان کامل را در اینجا ببینید:
https://listman.redhat.com/archives/libguestfs/2021\-March/msg00092.html
(کشف و رفع توسط Eric Blake).
.SS "APIهای جدید"
.IX Subsection "New APIs"
.IP \fBnbd_get_private_data\fR\|(3) 4
.IX Item "nbd_get_private_data"
.PD 0
.IP \fBnbd_set_private_data\fR\|(3) 4
.IX Item "nbd_set_private_data"
.PD
این فراخوانی‌ها به شما امکان می‌دهند یک عدد صحیح بدون علامت یا یک اشاره‌گر را
در هندل ذخیره کنید تا برنامه بتواند برای اهداف خود از آن استفاده کند.
.IP \fBnbd_get_uri\fR\|(3) 4
.IX Item "nbd_get_uri"
این فراخوانی یک URI مربوط به NBD ایجاد می‌کند که می‌تواند برای اتصال مجدد به
همان سرور استفاده شود (با استفاده از \fBnbd_connect_uri\fR\|(3) یا سایر ابزارهایی که
از استاندارد NBD URI پشتیبانی می‌کنند).
.SS "بهبودهای APIهای موجود"
.IX Subsection "Enhancements to existing APIs"
شناسه‌های عددی IPv6 URI (مانند \f(CW\*(C`nbd://[::1]/\*(C'\fR) اکنون پشتیبانی می‌شوند.
.PP
اگر backlog سرور سرریز کند، libnbd پیام خطای بهتری ارائه می‌دهد
(با تشکر از Xin Long،‏ Lukas Doktor،‏ Eric Blake،‏ Martin Kletzander).
.SS "ویژگی‌های جدید"
.IX Subsection "New features"
آزمون‌های یکپارچه‌سازی مداوم (CI) اکنون روی هر کامیت و درخواست ادغام (merge request)
در مخزن بالادست اجرا می‌شوند (Martin Kletzander).
.SS "ابزارها"
.IX Subsection "Tools"
کارهای زیادی برای بهبود کارایی
\&\fBnbdcopy\fR\|(1) انجام شده است (Nir Soffer،‏ Eric Blake).
.PP
در لینوکس، nbdcopy اکنون هنگام خواندن از فایل‌ها از readahead استفاده می‌کند و
اقداماتی را برای حفظ page cache میزبان انجام می‌دهد.
.PP
گزینهٔ جدید \fI\-\-request\-size\fR در nbdcopy برای امکان کنترل اندازهٔ
درخواست‌های ارسال‌شده به سرورهای NBD اضافه شده است. تنظیم این مورد می‌تواند بر کارایی اثر بگذارد
(Nir Soffer).
.PP
ابزار nbdcopy اکنون از شبه‌مقصد \f(CW\*(C`null:\*(C'\fR پشتیبانی می‌کند که در آن خروجی را
دور می‌ریزد. این قابلیت برای بنچمارک‌گیری مفید است.
.PP
پرچم جدید \fI\-v\fR در nbdcopy برای فعال‌سازی اشکال‌زدایی libnbd و سایر موارد.
.PP
دستور \&\fBnbdinfo\fR\|(1) \fI\-\-list\fR (که تمام exportهای یک سرور را فهرست می‌کند) دیگر
در صورتی که یکی از exportها غیرقابل‌دسترس باشد یا خطایی قابل‌بازیابی رخ دهد،
زودتر از موعد خارج نمی‌شود (Eric Blake).
.PP
ابزار nbdinfo اکنون URI هر export را در خروجی چاپ می‌کند که باعث می‌شود
اتصال مجدد به هر export آسان‌تر شود.
.PP
ابزار \&\fBnbdfuse\fR\|(1) اکنون چندنخی (multithreaded) است و از صدور دستورات موازی NBD
روی یک اتصال واحد و همچنین multi\-conn پشتیبانی می‌کند، و بهبودهای دیگری نیز انجام شده است.
این امر منجر به بهبود حدود ۵۰ درصدی کارایی در آزمایش با fio شد.
.PP
ابزار nbdfuse اکنون از سبک nbdcopy به‌صورت \f(CW\*(C`[ CMD ]\*(C'\fR پشتیبانی می‌کند، مانند:
 nbdfuse dir/ramdisk [ nbdkit memory 1G ]
.PP
ابزار nbdfuse اکنون از آزادسازی فضا (trimming) پشتیبانی می‌کند. همچنین از صفر کردن سریع (fast zeroing)
پشتیبانی می‌کند، اما کارکرد آن مستلزم یک وصلهٔ آیندهٔ کرنل است.
.PP
ابزار nbdfuse اگر export مربوط به NBD فقط‌خواندنی باشد، مجوزهای فایل مجازی را به درستی تنظیم می‌کند.
.PP
پرچم جدید \fI\-v\fR در nbdfuse برای فعال‌سازی اشکال‌زدایی libnbd و موارد دیگر.
.SS "آزمون‌ها"
.IX Subsection "Tests"
آزمونی برای سازگاری متقابل با \fBqemu\-storage\-daemon\fR\|(1) اضافه شد. توجه داشته باشید
که qemu\-storage\-daemon در qemu 6.0.0 مشکل داشت، بنابراین این آزمون ممکن است ناموفق باشد
مگر اینکه به یک نسخهٔ اصلاح‌شده ارتقا دهید (با تشکر از Stefan Hajnoczi،‏
Daniel Berrangé).
.PP
آزمونی برای nbdcopy به همراه TLS اضافه شد که پیش‌تر آزمایش نشده بود.
.PP
آزمون‌های سبک کد پایتون اکنون با استفاده از گزینهٔ زیر اختیاری (opt\-in) هستند:
 ./configure \-\-enable\-python\-code\-style
.PP
اکنون آزمون‌های بیشتری باید روی FreeBSD اجرا شوند و نادیده گرفته نشوند.
.PP
آزمون‌های nbdfuse اکنون تضمین می‌کنند که خطاهای ناشی از NBD از طریق
FUSE به کلاینت محلی برگردانده می‌شوند.
.PP
متغیرهای \&\f(CW\*(C`MALLOC_CHECK_\*(C'\fR و \f(CW\*(C`MALLOC_PERTURB_\*(C'\fR تنها هنگام اجرای
آزمون‌ها فعال می‌شوند، نه هنگام اجرای برنامه‌های libnbd از دایرکتوری ساخت.
این امر انجام بنچمارک‌ها را آسان‌تر می‌کند.
.SS "سایر بهبودها و رفع باگ‌ها"
.IX Subsection "Other improvements and bug fixes"
حداقل نسخهٔ کامپایلر C اکنون ISO C99 است (پیش‌تر ANSI C90 بود).
.PP
اکنون برای ساخت nbdfuse به FUSE 3 (به جای FUSE 2) نیاز است.
.PP
کتابخانه تلاش بیشتری می‌کند تا حافظهٔ thread\-local storage را هنگام
dlclose یا خروج (exit) نشت ندهد. (به دلیل معماری لینوکس، همیشه اجتناب
از این امر ممکن نیست، به‌ویژه در برنامه‌های چندنخی).
.PP
رفع مشکل نوار پیشرفت در \fBnbdcopy\fR\|(1).
.PP
نام‌های export به صورت UTF\-8 اکنون به درستی توسط
\&\fBnbdinfo\fR\|(1) پردازش و نمایش داده می‌شوند.
.PP
خروجی \fI\-\-help\fR در nbdcopy،‏ nbdfuse و nbdinfo اکنون خلاصه‌ای کوتاه
از تمام گزینه‌ها را نشان می‌دهد و شامل چند مثال است.
.PP
تولیدکننده اکنون تنها به ocamlc نیاز دارد، نه ocamlfind
(از Abhay Raj Singh).
.PP
اتصال‌های Golang اکنون از ماژول‌های golang استفاده کرده و به آن‌ها نیاز دارند.
.SS "مستندات"
.IX Subsection "Documentation"
مستندسازی استفاده از libnbd با سیستم ساخت Meson.
.PP
اضافه شدن مثال‌های Python.
.PP
اضافه شدن مثالی از چگونگی ادغام libnbd با libev (از Nir Soffer).
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
\&\fBlibnbd\fR\|(3).
.SH "نویسندگان (AUTHORS)"
.IX Header "AUTHORS"
Eric Blake
.PP
Richard W.M. Jones
.PP
Martin Kletzander
.PP
Nir Soffer
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
.IX Header "COPYRIGHT"
Copyright Red Hat
.SH "مجوز (LICENSE)"
.IX Header "LICENSE"
این کتابخانه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط
«مجوز عمومی جامع‌تر گنو» (GNU Lesser General Public License) همان‌طور
که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است، چه نسخهٔ ۲ مجوز و چه
(به انتخاب خودتان) هر نسخهٔ بالاتر دیگری، بازتوزیع کرده یا تغییر دهید.
.PP
این کتابخانه با این امید توزیع شده است که مفید واقع شود،
اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابل فروش بودن یا
مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر به GNU Lesser General Public License
مراجعه کنید.
.PP
شما باید به همراه این کتابخانه نسخه‌ای از GNU Lesser General Public License
را دریافت کرده باشید؛ در غیر این صورت به این نشانی بنویسید:
Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110\-1301 USA