.\" -*- 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.6 1"
.TH libnbd-release-notes-1.6 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.6 \- یادداشت‌های انتشار برای libnbd نسخهٔ 1.6
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
این متن، یادداشت‌های انتشار برای نسخهٔ پایدار 1.6 از libnbd است.
این سند تغییرات عمده نسبت به نسخهٔ 1.4 را شرح می‌دهد.
.PP
نسخهٔ 1.6.0 از libnbd در تاریخ \fB۷ ژانویه ۲۰۲۱\fR منتشر شد.
.SS "امنیت (Security)"
.IX Subsection "Security"
هیچ مشکل امنیتی در این نسخه یافت نشد.
.PP
اگر با مشکل امنیتی مواجه شدید، لطفاً فایل \fISECURITY\fR را در کد منبع بخوانید
(به‌صورت برخط در اینجا:
https://gitlab.com/nbdkit/libnbd/blob/master/SECURITY). برای
آگاهی از مشکلات امنیتی پیشین در libnbd، به
\&\fBlibnbd\-security\fR\|(3) مراجعه کنید.
.SS "رابط‌های برنامه‌نویسی جدید (New APIs)"
.IX Subsection "New APIs"
.IP \fBnbd_set_strict_mode\fR\|(3) 4
.IX Item "nbd_set_strict_mode"
.PD 0
.IP \fBnbd_get_strict_mode\fR\|(3) 4
.IX Item "nbd_get_strict_mode"
.PD
این API به شما امکان می‌دهد نحوهٔ رسیدگی libnbd به درخواست‌هایی از
برنامه را کنترل کنید که گمان می‌رود رفتار تعریف‌نشده‌ای در سرور ایجاد کنند
(مانند ارسال دستورهای ناشناخته، درخواست‌های با اندازهٔ صفر یا خارج از
محدوده و غیره). به‌طور معمول libnbd بسیار سخت‌گیر است و از ارسال چنین
درخواست‌هایی جلوگیری می‌کند، اما می‌توانید با استفاده از این API این محدودیت‌ها
را کاهش داده و مدیریت یا رد آن‌ها را به سرور واگذار کنید. در صورت انجام
این کار، ممکن است برخی از سرورها دچار فروپاشی (crash) شوند.
.IP \fBnbd_get_nr_meta_contexts\fR\|(3) 4
.IX Item "nbd_get_nr_meta_contexts"
.PD 0
.IP \fBnbd_get_meta_context\fR\|(3) 4
.IX Item "nbd_get_meta_context"
.IP \fBnbd_clear_meta_contexts\fR\|(3) 4
.IX Item "nbd_clear_meta_contexts"
.PD
این APIها به شما اجازه می‌دهند زمینه‌های فرادادهٔ (metadata contexts)
درخواست‌شده را بررسی کرده یا آن‌ها را پاک‌سازی کنید.
.IP \fBnbd_opt_list_meta_context\fR\|(3) 4
.IX Item "nbd_opt_list_meta_context"
.PD 0
.IP \fBnbd_aio_opt_list_meta_context\fR\|(3) 4
.IX Item "nbd_aio_opt_list_meta_context"
.PD
درخواست از سرور برای فهرست کردن زمینه‌های فرادادهٔ موجود. شما تنها
می‌توانید در حالت opt از این امکان استفاده کنید.
.PP
با تشکر از: Eric Blake برای تمامی APIهای جدید.
.SS "بهبودهای رابط‌های برنامه‌نویسی موجود (Enhancements to existing APIs)"
.IX Subsection "Enhancements to existing APIs"
پرچم جدید \f(CW\*(C`LIBNBD_SHUTDOWN_ABANDON_PENDING\*(C'\fR در \&\fBnbd_shutdown\fR\|(3)،
تمامی دستورهای در حال پردازشی را که هنوز به سرور ارسال نشده‌اند رها می‌کند
(Eric Blake).
.PP
تمام APIهایی که دارای پارامترهای پرچم (ماسک بیتی) هستند، اکنون یک مقدار ثابت
\&\f(CW\*(C`LIBNBD_*_MASK\*(C'\fR تعریف می‌کنند که به شما امکان می‌دهد در زمان کامپایل
تشخیص دهید کدام بیت‌ها نشان‌دهندهٔ پرچم‌های معتبر هستند (Eric Blake).
.SS "ویژگی‌های جدید (New features)"
.IX Subsection "New features"
عملکرد ابزار \fBnbdcopy\fR\|(1) به میزان چشمگیری بهبود یافته است.
همچنین این ابزار از قابلیت‌های جدید متعددی پشتیبانی می‌کند.
.PP
گزینهٔ جدید \fI\-\-map\fR در \fBnbdinfo\fR\|(1) که محدوده‌های تخصیص‌یافته و تنک (sparse)
یک سرور NBD را نمایش می‌دهد. این گزینه همچنین می‌تواند اطلاعات دیگری نظیر
بیت‌مپ‌های کثیف (dirty bitmaps) را نشان دهد.
.SS "ابزارها (Tools)"
.IX Subsection "Tools"
ابزار \&\fBnbdfuse\fR\|(1) اکنون می‌تواند export مربوط به NBD را روی هر فایل معمولی سوار
(mount) کند؛ نیازی به سوار کردن روی یک دایرکتوری وجود ندارد.
.PP
ابزار \&\fBnbdsh\fR\|(1) اکنون در صورتی که URI در گزینهٔ \fI\-u\fR یا دستور در گزینهٔ
\fI\-c\fR نادرست باشد، پیام خطای مناسبی تولید می‌کند (Eric Blake).
.PP
گزینهٔ جدید \fI\-\-opt\-mode\fR در \fBnbdsh\fR\|(1) که پیش از اتصال، حالت opt را روی
هندل (handle) درخواست می‌کند.
.PP
گزینهٔ \fI\-\-list\fR در \&\fBnbdinfo\fR\|(1) اکنون زمینه‌های فرادادهٔ پشتیبانی‌شده
توسط سرور را نمایش می‌دهد (Eric Blake).
.PP
خروجی \fBnbdinfo\fR\|(1) اکنون معمولاً به‌صورت اتمیک چاپ می‌شود؛ به این معنی که یا خروجی
کامل و یا یک پیام خطا نمایش داده می‌شود، نه خروجی ناقص که به دنبال آن خطا بیاید.
.PP
ابزار \&\fBnbdinfo\fR\|(1) اکنون می‌تواند زمینهٔ فرادادهٔ \f(CW\*(C`qemu:allocation\-depth\*(C'\fR
را رمزگشایی کند (Eric Blake).
.SS "سایر بهبودها و رفع باگ‌ها (Other improvements and bug fixes)"
.IX Subsection "Other improvements and bug fixes"
بهبودهای چندگانه در مدیریت پروتکل NBD (توسط Eric Blake).
.PP
رفع مشکل مدیریت مقادیر بولی در بایندینگ‌های Python (توسط Eric Blake).
.PP
رفع مشکل مدیریت پارامترهای پرچم در بایندینگ‌های OCaml (توسط Eric Blake).
.PP
اصلاحات نگارشی و شیوه‌نامهٔ کد Python (توسط Eric Blake).
.PP
رفع چندین مورد نشت حافظه (توسط Eric Blake).
.PP
بایندینگ‌های OCaml اکنون در صورت نصب بودن ocamldoc در زمان ساخت، شامل
مستندات تولیدشده توسط ocamldoc می‌شوند.
.PP
کتابخانهٔ «vector» از nbdkit اکنون توسط libnbd استفاده می‌شود و بخش‌هایی را
که قبلاً در آن‌ها از \fBrealloc\fR\|(3) استفاده می‌کردیم، ساده‌تر می‌کند.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
\&\fBlibnbd\fR\|(3).
.SH "نویسندگان (AUTHORS)"
.IX Header "AUTHORS"
Eric Blake
.PP
Richard W.M. Jones
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
.IX Header "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