.\" -*- 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.2 1"
.TH libnbd-release-notes-1.2 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.2 \- یادداشت‌های انتشار libnbd نسخه 1.2
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
این سند یادداشت‌های انتشار نسخه پایدار 1.2 از libnbd است.
این بخش تغییرات عمده نسبت به نسخه 1.0 را شرح می‌دهد.
.PP
نسخه libnbd 1.2.0 در تاریخ 14 نوامبر 2019 منتشر شد.
.SS "امنیت (Security)"
.IX Subsection "Security"
در جریان توسعه libnbd 1.2 دو مشکل امنیتی شناسایی شد.
هر دو به شاخه پایدار 1.0 پس‌انتقال (backport) شدند. ارتقا به نسخه‌های جدیدتر اکیداً
توصیه می‌شود.
.PP
\fIحمله تقلیل پروتکل CVE\-2019\-14842 هنگام استفاده از \fR\f(CI\*(C`LIBNBD_TLS_REQUIRE\*(C'\fR
.IX Subsection "CVE-2019-14842 protocol downgrade attack when using LIBNBD_TLS_REQUIRE"
.PP
بیانیه کامل و پیوندهای مربوط به کاهش اثرات، آزمون‌ها و اصلاحات را در اینجا
مشاهده کنید:
https://www.redhat.com/archives/libguestfs/2019\-September/msg00128.html
.PP
\fIآسیب‌پذیری اجرای کد از راه دور\fR
.IX Subsection "remote code execution vulnerability"
.PP
بیانیه کامل را در اینجا مشاهده کنید:
https://www.redhat.com/archives/libguestfs/2019\-October/msg00060.html
.SS "رابط‌های برنامه‌نویسی جدید (New APIs)"
.IX Subsection "New APIs"
.IP \fBnbd_can_fast_zero\fR\|(3) 4
.IX Item "nbd_can_fast_zero"
بررسی پشتیبانی سرور از صفر کردن سریع (fast zeroing) (توسط Eric Blake).
.IP \fBnbd_connect_socket\fR\|(3) 4
.IX Item "nbd_connect_socket"
.PD 0
.IP \fBnbd_aio_connect_socket\fR\|(3) 4
.IX Item "nbd_aio_connect_socket"
.PD
اتصال به یک سوکت محلی متصل‌شده که در برنامه اصلی با روش انتخابی خود ایجاد کرده‌اید.
.IP \fBnbd_connect_systemd_socket_activation\fR\|(3) 4
.IX Item "nbd_connect_systemd_socket_activation"
.PD 0
.IP \fBnbd_aio_connect_systemd_socket_activation\fR\|(3) 4
.IX Item "nbd_aio_connect_systemd_socket_activation"
.PD
اتصال به پردازش‌های محلی که از فعال‌سازی سوکت systemd پشتیبانی می‌کنند.
.IP \fBnbd_connect_vsock\fR\|(3) 4
.IX Item "nbd_connect_vsock"
.PD 0
.IP \fBnbd_aio_connect_vsock\fR\|(3) 4
.IX Item "nbd_aio_connect_vsock"
.PD
برای اتصال به سرورها از طریق \f(CW\*(C`AF_VSOCK\*(C'\fR استفاده می‌شود.
.IP \fBnbd_get_handshake_flags\fR\|(3) 4
.IX Item "nbd_get_handshake_flags"
.PD 0
.IP \fBnbd_set_handshake_flags\fR\|(3) 4
.IX Item "nbd_set_handshake_flags"
.IP \fBnbd_get_request_structured_replies\fR\|(3) 4
.IX Item "nbd_get_request_structured_replies"
.IP \fBnbd_set_request_structured_replies\fR\|(3) 4
.IX Item "nbd_set_request_structured_replies"
.IP \fBnbd_get_structured_replies_negotiated\fR\|(3) 4
.IX Item "nbd_get_structured_replies_negotiated"
.PD
می‌تواند هنگام تست سرورهای NBD برای جلوگیری از ویژگی‌های مختلف NBD استفاده شود
(توسط Eric Blake).
.IP \fBnbd_get_protocol\fR\|(3) 4
.IX Item "nbd_get_protocol"
دریافت گونه پروتکل NBD که سرور پشتیبانی می‌کند.
.IP \fBnbd_get_tls_negotiated\fR\|(3) 4
.IX Item "nbd_get_tls_negotiated"
آیا واقعاً بر سر یک اتصال TLS مذاکره انجام شده است؟
.IP \fBnbd_set_uri_allow_local_file\fR\|(3) 4
.IX Item "nbd_set_uri_allow_local_file"
.PD 0
.IP \fBnbd_set_uri_allow_tls\fR\|(3) 4
.IX Item "nbd_set_uri_allow_tls"
.IP \fBnbd_set_uri_allow_transports\fR\|(3) 4
.IX Item "nbd_set_uri_allow_transports"
.PD
این موارد می‌توانند برای فیلتر کردن URIهای NBD پیش از فراخوانی
\&\fBnbd_connect_uri\fR\|(3) استفاده شوند.
.SS "قابلیت‌های جدید (New features)"
.IX Subsection "New features"
ابزار جدید \fBnbdfuse\fR\|(1) امکان ایجاد یک فایل لوپ‌مونت‌شده با پشتوانه
یک سرور NBD را بدون نیاز به دسترسی کاربر ارشد (root) فراهم می‌کند.
.PP
پروتکل \&\f(CW\*(C`AF_VSOCK\*(C'\fR اکنون پشتیبانی می‌شود (با تشکر از Stefan Hajnoczi و
Stefano Garzarella).
.PP
پشتیبانی از فلگ \f(CW\*(C`FAST_ZERO\*(C'\fR (توسط Eric Blake).
.PP
امکان غیرفعال‌سازی برخی ویژگی‌های پروتکل، جهت سهولت در آزمایش
سرورها (توسط Eric Blake).
.PP
استفاده از آرایه‌های با طول متغیر تخصیص‌یافته روی استک (VLAs) در سراسر
کتابخانه ممنوع شد که به‌کارگیری کتابخانه در نخ‌ها و سایر موقعیت‌های دارای استک
کوچک را آسان‌تر می‌سازد.
.PP
ساخت‌های تکرارپذیر (توسط Chris Lamb).
.PP
پشتیبانی از پالایش ویژگی‌های بالقوه خطرناک یا نامطلوب در URIهای NBD.
.SS "مستندات (Documentation)"
.IX Subsection "Documentation"
بهبودهای فراوان در صفحات راهنمای تولیدشده، از جمله:
.IP \(bu 4
بخش‌های مجزای \f(CW\*(C`RETURN VALUE\*(C'\fR و \f(CW\*(C`ERRORS\*(C'\fR برای هر
تابع رابط برنامه‌نویسی.
.IP \(bu 4
کد نمونه.
.IP \(bu 4
امکان افزودن پیوندهای مرتبط به بخش \f(CW\*(C`SEE ALSO\*(C'\fR.
.IP \(bu 4
پیوند به مشخصات URIهای NBD در صورت لزوم، و بهبود
مستندات درباره URIهای پشتیبانی‌شده توسط libnbd.
.IP \(bu 4
مستندسازی ساختار شماره نسخه libnbd.
.IP \(bu 4
مستندسازی محدودیت‌ها در طول نام اکسپورت، انکودینگ و غیره.
.PP
صفحه راهنمای جدید \&\fBlibnbd\-security\fR\|(3) که فهرستی از مشکلات امنیتی پیشین و
راهکارهای رفع آن‌ها را ارائه می‌دهد (توسط Eric Blake).
.SS "ابزارها (Tools)"
.IX Subsection "Tools"
ابزار \&\fBnbdsh\fR\|(1) دارای گزینه جدید \fI\-\-base\-allocation\fR است که می‌تواند برای
درخواست بافت متادیتای \f(CW\*(C`base:allocation\*(C'\fR استفاده شود.
.PP
گزینه جدید \fI\-\-uri\fR (\fI\-u\fR) در \&\fBnbdsh\fR\|(1) برای اتصال به URIها.
.SS "آزمون‌ها (Tests)"
.IX Subsection "Tests"
اکنون می‌توانید با استفاده از American Fuzzy Lop یا libFuzzer در clang،
کتابخانه libnbd را تحت آزمون فازی (fuzz) قرار دهید.
.PP
افزودن تست‌های واحد برای \fBnbdsh\fR\|(1) (توسط Eric Blake).
.PP
بهبود تست سازگاری متقابل با سرورها و ویژگی‌های گوناگون NBD.
.SS "سایر بهبودها و رفع باگ‌ها (Other improvements and bug fixes)"
.IX Subsection "Other improvements and bug fixes"
تابع \&\fBnbd_connect_tcp\fR\|(3) اکنون تلاش می‌کند تا در هنگام شکست فراخوانی درونی
\fBconnect\fR\|(2)، مقدار صحیح \fBerrno\fR\|(3) را برگرداند.
.PP
فایل هدر \fInbd\-protocol.h\fR اکنون میان libnbd و nbdkit مشترک است.
.PP
ایمنی بهتر هنگام اجرای fork در توابع \f(CW\*(C`nbd_connect_*\*(C'\fR.
.PP
کد منبع توسط Coverity تحلیل شد و مشکلات مختلفی شناسایی
و رفع شدند.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
\&\fBlibnbd\fR\|(3).
.SH "نویسندگان (AUTHORS)"
.IX Header "AUTHORS"
.IP "Eric Blake" 4
.IX Item "Eric Blake"
.PD 0
.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) همان‌طور که توسط
بنیاد نرم‌افزارهای آزاد منتشر شده است، بازتوزیع کرده یا تغییر دهید؛ چه
نسخه 2 مجوز یا (به انتخاب خودتان) هر نسخه پس از آن.
.PP
این کتابخانه با این امید توزیع شده است که مفید واقع شود،
اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی
قابل فروش بودن یا مناسب بودن برای یک هدف خاص. برای
جزئیات بیشتر به مجوز عمومی همگانی کمتر گنو مراجعه کنید.
.PP
شما باید به همراه این کتابخانه نسخه‌ای از مجوز عمومی همگانی کمتر گنو را
دریافت کرده باشید؛ در غیر این صورت، به آدرس بنیاد نرم‌افزارهای آزاد بنویسید:
Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110\-1301 USA