.\" -*- 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.4 1"
.TH libnbd-release-notes-1.4 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.4 \- یادداشت‌های انتشار libnbd نسخه 1.4
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
این سند یادداشت‌های انتشار نسخهٔ پایدار 1.4 از libnbd است.
در اینجا تغییرات عمده نسبت به نسخهٔ 1.2 شرح داده شده است.
.PP
نسخهٔ 1.4.0 از libnbd در تاریخ ۲۵ اوت ۲۰۲۰ منتشر شد.
.SS "امنیت (Security)"
.IX Subsection "Security"
هیچ مشکل امنیتی در این نسخه یافت نشد. اگر مشکلی امنیتی پیدا کردید، لطفاً پروندهٔ
\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_opt_mode\fR\|(3) 4
.IX Item "nbd_set_opt_mode"
.PD 0
.IP \fBnbd_get_opt_mode\fR\|(3) 4
.IX Item "nbd_get_opt_mode"
.IP \fBnbd_aio_is_negotiating\fR\|(3) 4
.IX Item "nbd_aio_is_negotiating"
.PD
کتابخانهٔ libnbd 1.4 یک وضعیت جدید «مذاکره» (negotiating) را در حین دست‌تکانی NBD اضافه می‌کند. برای حفظ سازگاری با نسخه‌های پیشین، برنامه‌ها باید پیش از آغاز اتصال با فراخوانی
\fBnbd_set_opt_mode\fR\|(3)
این حالت را درخواست کنند. می‌توانید با فراخوانی
\fBnbd_aio_is_negotiating\fR\|(3)
بررسی کنید که آیا اتصال در این وضعیت قرار دارد یا خیر.
.Sp
برای توضیحات دقیق‌تر دربارهٔ نحوهٔ استفاده از این وضعیت اضافی جهت مذاکره دربارهٔ گزینه‌های سرور، بخش «CONTROLLING NEGOTIATION» را در
\fBlibnbd\fR\|(3)
ببینید.
.IP \fBnbd_aio_opt_abort\fR\|(3) 4
.IX Item "nbd_aio_opt_abort"
.PD 0
.IP \fBnbd_opt_abort\fR\|(3) 4
.IX Item "nbd_opt_abort"
.PD
در طول وضعیت مذاکره، اتصال را متوقف (abort) می‌کند.
.IP \fBnbd_aio_opt_go\fR\|(3) 4
.IX Item "nbd_aio_opt_go"
.PD 0
.IP \fBnbd_opt_go\fR\|(3) 4
.IX Item "nbd_opt_go"
.PD
در طول وضعیت مذاکره، دست‌تکانی را تکمیل می‌کند.
.IP \fBnbd_aio_opt_info\fR\|(3) 4
.IX Item "nbd_aio_opt_info"
.PD 0
.IP \fBnbd_opt_info\fR\|(3) 4
.IX Item "nbd_opt_info"
.PD
در طول وضعیت مذاکره، اطلاعات کامل دربارهٔ اکسپورت سرور را درخواست می‌کند.
.IP \fBnbd_aio_opt_list\fR\|(3) 4
.IX Item "nbd_aio_opt_list"
.PD 0
.IP \fBnbd_opt_list\fR\|(3) 4
.IX Item "nbd_opt_list"
.PD
در طول وضعیت مذاکره، فهرست اکسپورت‌هایی را که سرور ارائه می‌دهد درخواست می‌کند.
.IP \fBnbd_get_block_size\fR\|(3) 4
.IX Item "nbd_get_block_size"
محدودیت‌های حداقل، ترجیحی یا حداکثر اندازهٔ بلوک را برای درخواست‌های ارسال‌شده به سرور بازمی‌گرداند.
.IP \fBnbd_get_canonical_export_name\fR\|(3) 4
.IX Item "nbd_get_canonical_export_name"
نام رسمی و متعارف اکسپورت را که پیش‌فرض سرور است بازمی‌گرداند. این اطلاعات ممکن است تنها در صورتی در دسترس باشد که پیش از اتصال،
\fBnbd_set_full_info\fR\|(3)
را فراخوانی کرده باشید.
.IP \fBnbd_get_export_description\fR\|(3) 4
.IX Item "nbd_get_export_description"
توضیحات متنی اختیاری اکسپورت فعلی را بازمی‌گرداند. این اطلاعات ممکن است تنها در صورتی در دسترس باشد که پیش از اتصال،
\fBnbd_set_full_info\fR\|(3)
را فراخوانی کرده باشید.
.IP \fBnbd_set_full_info\fR\|(3) 4
.IX Item "nbd_set_full_info"
.PD 0
.IP \fBnbd_get_full_info\fR\|(3) 4
.IX Item "nbd_get_full_info"
.PD
اطلاعات گسترش‌یافته دربارهٔ اکسپورت‌های سرور را فعال می‌کند.
.PP
با تشکر از: Eric Blake برای تمامی رابط‌های برنامه‌نویسی جدید.
.SS "ویژگی‌های جدید (New features)"
.IX Subsection "New features"
هم‌اکنون اتصالات (Bindings) در زبان برنامه‌نویسی Go در دسترس است.
.PP
پلتفرم‌های FreeBSD و OpenBSD اکنون به طور کامل پشتیبانی می‌شوند.
.PP
قابلیت تکمیل خودکار با کلید تب در بش (Bash tab completion) برای تمامی ابزارهای خط فرمان در دسترس است.
.SS "مستندات (Documentation)"
.IX Subsection "Documentation"
متون عین‌اللفظی (Verbatim) در صفحات راهنما که در چندین خط شکسته می‌شدند اکنون به درستی حروف‌چینی می‌شوند.
.PP
پیوندها در داخل مستندات بهبود یافته‌اند و اکنون از نظر صحت بررسی می‌شوند.
.SS "ابزارها (Tools)"
.IX Subsection "Tools"
ابزار جدید
\fBnbdcopy\fR\|(1)
به شما امکان می‌دهد میان یک سرور NBD و یک پروندهٔ محلی کپی کنید، یا داده‌ها را به/از یک سرور NBD جریان‌دهی (stream) کنید.
.PP
ابزار جدید
\fBnbdinfo\fR\|(1)
به شما اجازه می‌دهد اطلاعات گسترش‌یافته دربارهٔ اکسپورت‌های یک سرور NBD را چاپ کنید (Eric Blake).
.SS "آزمون‌ها (Tests)"
.IX Subsection "Tests"
سوکت‌های آزمون در
\fI/tmp\fR
ایجاد می‌شوند (به جای پوشهٔ محلی). این امر مانع از شکست مجموعه آزمون‌ها در حالتی می‌شود که مسیر پوشهٔ محلی طولانی‌تر از حداکثر طول مجاز مسیر برای سوکت‌های دامنه یونیکس (Unix domain socket) باشد.
.SS "سایر بهبودها و رفع اشکالات (Other improvements and bug fixes)"
.IX Subsection "Other improvements and bug fixes"
پیام‌های ردگیری (Trace) بهبود یافته‌اند: رشته‌های طولانی کوتاه می‌شوند، کاراکترهای غیرقابل‌چاپ در رشته‌ها اسکیپ می‌شوند، و فهرستی از رشته‌ها چاپ می‌گردد.
.PP
بخش تولیدکننده (generator) از یک اسکریپت واحد بزرگ به چند پروندهٔ کوچک تقسیم شد. برای ساخت از گیت، اکنون کامپایلر بایت‌کد OCaml
(\fBocamlc\fR\|(1))
به جای مفسر
(\fBocaml\fR\|(1))
مورد نیاز است.
.PP
نام‌های کاربری طولانی برای ورود به سیستم در
\fBnbd_get_tls_username\fR\|(3)
پشتیبانی می‌شوند.
.PP
نام دسته (handle) در
\fBnbdsh\fR\|(1)
اکنون روی
\f(CW\*(C`nbdsh\*(C'\fR
تنظیم شده است (به جای یک نام تصادفی تولیدشده).
.PP
سازگاری با OCaml 4.10.0 و 4.11.0.
.PP
بافر پایتون AIO یک متد جدید
\f(CW\*(C`is_zero\*(C'\fR
اضافه می‌کند که به کلاینت‌های پایتون امکان می‌دهد هنگام کپی کردن، تُنک‌سازی (sparsification) انجام دهند.
.PP
سازگاری با پایتون 3.9.
.PP
برنامه‌های خارجی C اکنون می‌توانند با استفاده از
\f(CW\*(C`../libnbd/run ./configure\*(C'\fR
در برابر پوشهٔ ساخت libnbd کامپایل شوند.
.PP
ابزار Honggfuzz می‌تواند به عنوان یک گزینهٔ دیگر برای فازینگ خارجی استفاده شود.
.PP
رفع مشکل کامپایل با glibc 2.32 که
\f(CW\*(C`sys_errlist\*(C'\fR
را منسوخ کرده است.
.PP
مثال‌های متعددی برای نمایش کاربردهای رابط‌های برنامه‌نویسی جدید اضافه یا گسترش داده شدند (Eric Blake).
.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"
Copyright Red Hat
.SH "مجوز (LICENSE)"
.IX Header "LICENSE"
این کتابخانه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط «مجوز عمومی جامع‌تر گنو» (GNU Lesser General Public License) منتشرشده توسط «بنیاد نرم‌افزارهای آزاد»؛ نسخهٔ 2 مجوز یا (به انتخاب خودتان) هر نسخهٔ بالاتری بازتوزیع کرده یا تغییر دهید.
.PP
این کتابخانه با این امید توزیع شده است که مفید واقع شود، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابل‌فروش بودن یا مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر به «مجوز عمومی جامع‌تر گنو» مراجعه کنید.
.PP
شما باید همراه با این کتابخانه نسخه‌ای از «مجوز عمومی جامع‌تر گنو» را دریافت کرده باشید؛ در غیر این صورت، به بنیاد نرم‌افزارهای آزاد به آدرس زیر بنویسید:
.PP
.nf
Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110\-1301 USA
.fi