.\" -*- 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.24 1"
.TH libnbd-release-notes-1.24 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.24 \- یادداشت‌های انتشار libnbd نسخه ۱.۲۴
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
این سند یادداشت‌های انتشار نسخه پایدار libnbd ۱.۲۴ است.
این یادداشت‌ها تغییرات عمده پس از نسخه ۱.۲۲ را تشریح می‌کنند.
.PP
نسخه libnbd 1.24.0 در تاریخ \fB16 December 2025\fR (۲۵ آذر ۱۴۰۴) منتشر شد.
.SS "امنیت (Security)"
.IX Subsection "Security"
در تابع \fBnbd_connect_uri\fR\|(3) و چندین ابزار libnbd (برای نمونه \&\fBnbdinfo\fR\|(1))، هنگام استفاده از URIهای nbd+ssh://، فیلد hostname به میزان کافی پاک‌سازی و اعتبارسنجی نمی‌شد. پیامد این امر آن بود که یک مهاجم با توانایی کنترل این فیلد در URI می‌توانست دستوراتی را از طریق libnbd اجرا کند. این آسیب‌پذیری بر نسخه‌های libnbd ≥ 1.22 تأثیر می‌گذاشت. برای اطلاعات بیشتر ببینید:
https://lists.libguestfs.org/archives/list/guestfs@lists.libguestfs.org/thread/YZMBF3SJRWTRVT5L3KWSNHITFTRMQNTT
.PP
اگر مشکلی امنیتی یافتید، لطفاً سند \fISECURITY\fR را در کد منبع مطالعه کنید (به صورت برخط در این نشانی:
https://gitlab.com/nbdkit/libnbd/blob/master/SECURITY). برای اطلاع از مسائل امنیتی پیشین در libnbd، به
\&\fBlibnbd\-security\fR\|(3)
مراجعه کنید.
.SS "رابط‌های برنامه‌نویسی جدید (New APIs)"
.IX Subsection "New APIs"
تابع جدید \fBnbd_get_version_extra\fR\|(3) رشته ارسال‌شده به \&\f(CW\*(C`./configure \-\-with\-extra="..."\*(C'\fR را برمی‌گرداند. این قابلیت برای استفاده بسته‌بندهای توزیع‌ها (downstream packagers) در نظر گرفته شده است.
.PP
تابع جدید \fBnbd_get_handle_size\fR\|(3) که تخمینی از اندازه دستگیره (handle) را به بایت برمی‌گرداند. این تابع برای استفاده زبان‌های دارای بازیافت حافظه (garbage collection) به عنوان راهنمایی جهت زمان آزادسازی دستگیره در نظر گرفته شده است.
.PP
توابع جدید \fBnbd_get_tls_priority\fR\|(3) و \fBnbd_set_tls_priority\fR\|(3) که به شما امکان می‌دهند رشته اولویت TLS سیستم را به طور موقت بازنویسی (override) کنید.
.PP
رابط جدید \fBnbd_set_uri_allow_tls_priority\fR\|(3) که امکان فعال‌سازی ویژگی جدید \f(CW\*(C`?tls\-priority=PRIORITY\*(C'\fR را در URIهای NBD فراهم می‌کند (این ویژگی به صورت پیش‌فرض غیرفعال است).
.SS "بهبود رابط‌های برنامه‌نویسی موجود (Enhancements to existing APIs)"
.IX Subsection "Enhancements to existing APIs"
در \fBnbd_connect_uri\fR\|(3) برای URIهای nbd+ssh://، پارامترهای پرس‌وجوی اضافی \f(CW\*(C`nbd\-port\*(C'\fR و \&\f(CW\*(C`tls\-username\*(C'\fR به شما اجازه می‌دهند به طور مجزا پورت و نام کاربری NBD TLS و SSH را کنترل کنید. پارامتر پرس‌وجوی جدید \f(CW\*(C`compress=true\*(C'\fR به شما امکان می‌دهد فشرده‌سازی SSH را فعال نمایید.
.PP
همچنین در nbd_connect_uri، پارامتر جدید \f(CW\*(C`tls\-priority=PRIORITY\*(C'\fR امکان بازنویسی رشته اولویت TLS را فراهم می‌آورد (اما این ویژگی به طور پیش‌فرض فعال نیست، بخش پیشین را ببینید).
.SS "پروتکل (Protocol)"
.IX Subsection "Protocol"
رمزها و گواهی‌های رمزنگاری پسا-کوانتومی (PQC) برای اتصالات TLS اکنون به طور کامل پشتیبانی می‌شوند. به عنوان بخشی از این تغییر، اکنون چندین گواهی کلاینت می‌تواند توسط کتابخانه بارگذاری شود. (با تشکر از Dan Berrange).
.SS "ابزارها (Tools)"
.IX Subsection "Tools"
ابزارهای جدید \fBnbddiscard\fR\|(1) و \fBnbdzero\fR\|(1) که می‌توان از آن‌ها برای آزادسازی (trim/discard) یا صفر کردن بخشی یا تمام یک دیسک NBD استفاده کرد (ویژگی‌های اضافی توسط Eric Blake).
.PP
ویژگی جدید \fI\-\-blkhash\fR در \fBnbdcopy\fR\|(1). این ویژگی می‌تواند blkhash (مشابه یک چک‌سام) تصویر دیسک را در حین کپی شدن محاسبه کند (Nir Soffer, Vera Wu).
.PP
ابزار nbdcopy اکنون هنگام اجرا در حالت همگام (synchronous)، از گزینه‌های \fI\-\-destination\-is\-zero\fR و \fI\-\-allocated\fR پیروی می‌کند (Nir Soffer).
.SS "اتصال‌های زبان‌های برنامه‌نویسی (Language bindings)"
.IX Subsection "Language bindings"
اتصال‌های OCaml اکنون \f(CW\*(C`NBD.Buffer.is_zero\*(C'\fR را پیاده‌سازی می‌کنند.
.PP
اتصال‌های OCaml اکنون تخمین بهتری از اندازه دستگیره libnbd را در اختیار بازیافت حافظه قرار می‌دهند که — دست‌کم در تئوری — به تصمیم‌گیری بهتر در زمان آزادسازی دستگیره کمک می‌کند (با تشکر از Kit\-ty\-kate).
.PP
اتصال‌های پایتون اندیس‌گذاری و برش (slicing) شیء \f(CW\*(C`nbd.Buffer\*(C'\fR را پیاده‌سازی کرده‌اند.
.PP
بهبود تبدیل خودکار مستندات POD به مستندات Rust. نشانه‌گذاری‌هایی که پیش از این به هم ریخته می‌شدند، اکنون به درستی تبدیل می‌شوند.
.SS "آزمون‌ها (Tests)"
.IX Subsection "Tests"
بهبود آزمون‌های گزینه‌های \fI\-\-allocated\fR و \&\fI\-\-destination\-is\-zero\fR در nbdcopy.
.PP
هنگام اجرای آزمون‌های libnbd روی سامانه پرونده ZFS، چندین آزمون مردود می‌شدند. اکنون از این آزمون‌ها صرف‌نظر می‌شود (با تشکر از Arsen Arsenović, Eric Blake).
.SS "سایر بهبودها و رفع باگ‌ها (Other improvements and bug fixes)"
.IX Subsection "Other improvements and bug fixes"
ابزار nbdcopy اکنون در صورت شکست فراخوان سیستمی لینوکس \&\fBsync_file_range\fR\|(2) یک خطای قطعی صادر می‌کند. این اتفاق می‌تواند به دلیل خطاهای خاص ورودی/خروجی دستگاه رخ دهد (با تشکر از Eric Sandeen, Dave Chinner).
.PP
در macOS و Linux، اندازه بافر سوکت دامین یونیکس برای بهبود کارایی تنظیم شد (Nir Soffer).
.PP
رفع چندین اشتباه تایپی و املایی در مستندات (Eric Blake).
.SS "مستندات (Documentation)"
.IX Subsection "Documentation"
صفحه راهنمای جدید \fBlibnbd\-python\fR\|(3) که مقدمه‌ای بر رابط برنامه‌نویسی پایتون ارائه می‌دهد. این اطلاعات پیش از این در چند جای مختلف پراکنده بود.
.SS "ساخت (Build)"
.IX Subsection "Build"
گزینه \&\f(CW\*(C`./configure \-\-with\-extra="..."\*(C'\fR می‌تواند توسط بسته‌بندهای توزیع‌ها برای افزودن اطلاعات اضافی به خروجی \fI\-\-version\fR ابزارها (مانند نسخه بسته توزیع) استفاده شود.
.PP
رنگی‌سازی و بهبود خروجی \f(CW\*(C`./configure\*(C'\fR در صورت استفاده در ترمینال.
.SS "بخش‌های داخلی (Internals)"
.IX Subsection "Internals"
کپی توابع جدید بردار (vector) و رشته از nbdkit، شامل
\&\f(CW\*(C`vector_uniq\*(C'\fR, \f(CW\*(C`vector_append_array\*(C'\fR, \f(CW\*(C`vector_insert_array\*(C'\fR,
\&\f(CW\*(C`vector_remove_range\*(C'\fR, \f(CW\*(C`string_append_format\*(C'\fR.
.PP
اصلاح رفتار تخصیص حافظه در کتابخانه بردار داخلی، که باید در برخی شرایط مصرف حافظه را کاهش دهد (Eric Blake).
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
\&\fBlibnbd\fR\|(3).
.SH "نویسندگان (AUTHORS)"
.IX Header "AUTHORS"
.IP "Christopher Byrne" 4
.IX Item "Christopher Byrne"
.PD 0
.IP "Eric Blake" 4
.IX Item "Eric Blake"
.IP "Nir Soffer" 4
.IX Item "Nir Soffer"
.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"
این کتابخانه نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط مجوز عمومی همگانی کمتر گنو (LGPL) منتشرشده توسط بنیاد نرم‌افزارهای آزاد بازتوزیع کرده یا تغییر دهید؛ چه نسخه ۲ مجوز، و یا (به انتخاب خودتان) هر نسخه بعدی.
.PP
این کتابخانه با این امید توزیع شده است که سودمند باشد، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی تجاری بودن یا تناسب برای هدفی معین. برای جزئیات بیشتر به مجوز عمومی همگانی کمتر گنو مراجعه کنید.
.PP
شما باید همراه با این کتابخانه یک نسخه از مجوز عمومی همگانی کمتر گنو را دریافت کرده باشید؛ در غیر این صورت، به آدرس زیر در بنیاد نرم‌افزارهای آزاد مکاتبه کنید:
Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110\-1301 USA