.\" -*- 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.10 1"
.TH libnbd-release-notes-1.10 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.10 \- یادداشت‌های انتشار برای libnbd نسخه 1.10
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
این سند، یادداشت‌های انتشار نسخه پایدار 1.10 از libnbd است
و تغییرات عمده اعمال‌شده از نسخه 1.8 را شرح می‌دهد.
.PP
نسخه 1.10.0 از libnbd در تاریخ \fB۲۳ سپتامبر ۲۰۲۱\fR منتشر شد.
.SS "امنیت (Security)"
.IX Subsection "Security"
در طول چرخه انتشار این نسخه، هیچ آسیب‌پذیری امنیتی در libnbd یافت نشد.
.PP
اگر با مشکلی امنیتی مواجه شدید، لطفاً فایل \fISECURITY\fR را در سورس‌کد پروژه بخوانید
(به‌صورت برخط در این نشانی:
https://gitlab.com/nbdkit/libnbd/blob/master/SECURITY). برای
آگاهی از مشکلات امنیتی پیشین در libnbd،
\&\fBlibnbd\-security\fR\|(3) را ببینید.
.SS "APIهای جدید"
.IX Subsection "New APIs"
هیچ API جدیدی در نسخه 1.10 افزوده نشده است.
.SS "بهبودهای APIهای موجود"
.IX Subsection "Enhancements to existing APIs"
تابع \&\fBnbd_get_uri\fR\|(3) دیگر نام‌های سرویس
(مانند \f(CW"nbd://localhost:nbd"\fR) را برنمی‌گرداند. در عوض، برای حفظ سازگاری و انتقال‌پذیری، همواره شماره پورت‌های خام را بازمی‌گرداند.
.PP
تابع \&\fBnbd_connect_uri\fR\|(3) اکنون از پارامتر پرس‌وجوی \f(CW\*(C`tls\-certificates=\fR\f(CIDIR\fR\f(CW\*(C'\fR پشتیبانی می‌کند که اتصال به سرورها با استفاده از TLS و گواهی‌های X.509 را بسیار آسان‌تر می‌سازد. همچنین پیام‌های خطای این API در هنگام بروز برخی خطاهای رایج کاربری در URI بهبود یافته است.
.PP
در پایتون، \f(CW\*(C`nbd.aio_connect\*(C'\fR پشتیبانی از سوکت‌های \f(CW\*(C`AF_UNIX\*(C'\fR را پیاده‌سازی کرده است.
.PP
استفاده نادرست از \f(CW\*(C`unsafe.Pointer\*(C'\fR در بایندینگ‌های Go رفع شد.
.SS "ابزارها (Tools)"
.IX Subsection "Tools"
ابزار \&\fBnbdcopy\fR\|(1) اکنون به‌صورت پیش‌فرض از اندازه درخواست 256K (به جای 32M) استفاده می‌کند.
این مقدار پیش‌فرض در بیشتر موارد عملکرد بهتری ارائه می‌دهد.
.PP
ابزار \&\fBnbdinfo\fR\|(1) دارای حالت جدید \fI\-\-map \-\-totals\fR است که خلاصه‌ای از نگاشت را نمایش می‌دهد. همچنین گزینه‌های جدید \fI\-\-can\fR و \fI\-\-is\fR به شما اجازه می‌دهند ویژگی‌های export را بیازمایید (مانند \fI\-\-is read\-only\fR).
.PP
گزینه \fI\-\-map\fR در \&\fBnbdinfo\fR\|(1) به دلیل ابهام در مفهوم دقیق کلمه "allocated"، از "data" به جای "allocated" استفاده می‌کند (Eric Blake, Nir Soffer).
.PP
ابزار \&\fBnbdinfo\fR\|(1) اندازه export را هم بر حسب بایت و هم با واحدهای خوانا برای انسان (مانند \f(CW"1K"\fR) نشان می‌دهد. ساختار خروجی JSON که برای پردازش ماشین در نظر گرفته شده تغییری نکرده است.
.PP
ابزار \&\fBnbdfuse\fR\|(1) اکنون از صفر کردن کارآمد (efficient zeroing) پشتیبانی می‌کند. توجه داشته باشید که این قابلیت نیازمند هسته لینوکس نسخه ۵.۱۴ یا بالاتر است.
.PP
ابزار \&\fBnbdsh\fR\|(1) دارای گزینه جدید \fI\-n\fR است که از ایجاد خودکار هندل ضمنی \f(CW\*(C`h\*(C'\fR جلوگیری می‌کند. همچنین گزینه جدید \fI\-v\fR که عیب‌یابی (دیباگ) را فعال می‌سازد. علاوه بر این، اعلان راهنمای ابتدایی اکنون به زمینه حساس بوده و بسته به نحوه اجرای nbdsh، اطلاعات مرتبط‌تری ارائه می‌دهد.
.SS "آزمون‌ها (Tests)"
.IX Subsection "Tests"
آزمون‌های یکپارچه‌سازی مداوم (CI) به طرز چشمگیری بهبود یافته و اصلاحات متعددی مخصوص پلتفرم‌های گوناگون انجام شد. برای مشاهده تازه‌ترین آزمون‌ها و نتایج CI به پیوند زیر مراجعه کنید:
https://gitlab.com/nbdkit/libnbd/\-/pipelines (Martin Kletzander).
.PP
آزمون‌ها اکنون از قابلیت جدید \f(CW\*(C`GLIBC_TUNABLES\*(C'\fR استفاده می‌کنند که در glibc نسخه ۲.۳۴ و بالاتر جایگزین
\&\f(CW\*(C`MALLOC_CHECK_\*(C'\fR شده است (با تشکر از Eric Blake و Siddhesh Poyarekar).
.SS "سایر بهبودها و رفع باگ‌ها"
.IX Subsection "Other improvements and bug fixes"
نوار پیشرفت در \&\fBnbdcopy\fR\|(1) اکنون در حالت چندنخی با دقت بیشتری نمایش داده می‌شود.
.SS "مستندات (Documentation)"
.IX Subsection "Documentation"
مستندات مربوط به \&\f(CW\*(C`nbd_connect*\*(C'\fR و \f(CW\*(C`nbd_aio_connect*\*(C'\fR بازنگری و بهبود یافت.
.PP
در سرتاسر مستندات، قالب‌بندی و شیوه‌نگاری سازگارتری برای گزینه‌ها استفاده شده است.
.PP
اسکریپت \&\fIpodwrapper.pl\fR (تقریباً به‌طور کامل) با نسخه موجود در nbdkit یکپارچه و یکسان شد.
.SS "ساخت (Build)"
.IX Subsection "Build"
فایل \&\fIconfigure.ac\fR اکنون به‌صورت یکدست از فاصله‌ها (spaces) استفاده می‌کند و برای پشتیبانی از آخرین نگارش‌های autotools مدرن‌سازی شده است (Eric Blake).
.PP
سیستم ساخت اکنون در صورت وجود فریم‌های پشته بزرگ (large stack frames) هشدار می‌دهد، و چند نقطه از برنامه که فریم‌های پشته بزرگ داشتند اصلاح شدند.
.PP
فازینگ پروژه با استفاده از AFL++ ادامه یافت و مستندات فازینگ به‌روزرسانی شد.
.PP
مشکل ساخت از طریق مخزن git با گزینه \fI\-\-disable\-ocaml\fR رفع گردید. تا زمانی که تنها
\&\f(CW\*(C`ocamlc\*(C'\fR نصب باشد، تولیدکننده باید کماکان ساخته شده و اجرا شود (Martin Kletzander).
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
\&\fBlibnbd\fR\|(3).
.SH "نویسندگان (AUTHORS)"
.IX Header "AUTHORS"
.IP "Anson Lo" 4
.IX Item "Anson Lo"
.PD 0
.IP "Eric Blake" 4
.IX Item "Eric Blake"
.IP "Martin Kletzander" 4
.IX Item "Martin Kletzander"
.IP "Richard W.M. Jones" 4
.IX Item "Richard W.M. Jones"
.PD
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
.IX Header "COPYRIGHT"
Copyright Red Hat
.SH "مجوز (LICENSE)"
.IX Header "LICENSE"
این کتابخانه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط مجوز عمومی جامع کمتر گنو (GNU Lesser General Public License) منتشر شده توسط بنیاد نرم‌افزارهای آزاد؛ چه نسخه ۲ مجوز یا (به انتخاب خودتان) هر نسخه پس از آن، تغییر داده یا مجدداً توزیع کنید.
.PP
این کتابخانه با این امید که مفید واقع شود توزیع شده است، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابلیت فروش یا مناسب بودن برای هدفی خاص. برای جزئیات بیشتر به متن «مجوز عمومی جامع کمتر گنو» مراجعه نمایید.
.PP
شما باید همراه با این کتابخانه نسخه‌ای از مجوز عمومی جامع کمتر گنو را دریافت کرده باشید؛ در غیر این صورت، به نشانی زیر مکاتبه کنید:
Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110\-1301 USA