.\" -*- 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.16 1"
.TH libnbd-release-notes-1.16 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.16 \- یادداشت‌های انتشار برای libnbd نسخه 1.16
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
این سند، یادداشت‌های انتشار نسخه پایدار 1.16 از libnbd است.
در اینجا تغییرات عمده نسبت به نسخه 1.14 شرح داده شده است.
.PP
نسخه 1.16.0 از libnbd در تاریخ \fB18 آوریل 2023\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"
رابط برنامه‌نویسی جدید \fBnbd_supports_vsock\fR\|(3) می‌تواند برای آزمایش اینکه آیا کلاینت از vsock پشتیبانی می‌کند یا خیر استفاده شود (Eric Blake).
.PP
رابط برنامه‌نویسی جدید \fBnbd_poll2\fR\|(3) که امکان ارسال یک توصیف‌گر فایل (file descriptor) اضافی را فراهم می‌کند (Ming Lei).
.PP
رابط‌های برنامه‌نویسی جدید \fBnbd_stats_bytes_sent\fR\|(3)، \fBnbd_stats_bytes_received\fR\|(3)،
\&\fBnbd_stats_chunks_sent\fR\|(3) و \fBnbd_stats_chunks_received\fR\|(3)
که تعداد بایت‌ها و پیام‌های ارسال‌شده و دریافت‌شده روی اتصال فعلی را نمایش می‌دهند (Eric Blake).
.PP
رابط‌های برنامه‌نویسی جدید \fBnbd_opt_list_meta_context_queries\fR\|(3) و
\&\fBnbd_aio_opt_list_meta_context_queries\fR\|(3) به شما امکان می‌دهند تا بافت‌های فراداده (meta contexts) موجود را در طول فاز مذاکره پروتکل به‌صورت تعاملی از سرور استعلام کنید (Eric Blake).
.PP
تابع جدید \fBnbd_set_request_meta_context\fR\|(3) به شما امکان می‌دهد کنترل کنید که آیا بافت فراداده در حین مذاکره تنظیم شود یا خیر. این امر می‌تواند برخی عملیات‌ها را سریع‌تر کند، به‌ویژه \f(CW\*(C`nbdinfo \-\-list\*(C'\fR (Eric Blake).
.PP
رابط‌های برنامه‌نویسی جدید \fBnbd_opt_set_meta_context\fR\|(3)،
\&\fBnbd_opt_set_meta_context_queries\fR\|(3)،
\&\fBnbd_aio_opt_set_meta_context\fR\|(3) و
\&\fBnbd_aio_opt_set_meta_context_queries\fR\|(3) هنگام استفاده از \fBnbd_set_opt_mode\fR\|(3) امکان درخواست بافت‌های فراداده را فراهم می‌کنند (Eric Blake).
.PP
رابط‌های برنامه‌نویسی جدید \fBnbd_opt_structured_reply\fR\|(3) و
\&\fBnbd_aio_opt_structured_reply\fR\|(3) به شما امکان می‌دهند زمان درخواست پاسخ‌های ساختاریافته (structured replies) را در طول فاز مذاکره به‌دقت تنظیم کنید (Eric Blake).
.PP
رابط‌های برنامه‌نویسی جدید \fBnbd_opt_starttls\fR\|(3) و \fBnbd_aio_opt_starttls\fR\|(3) به شما اجازه می‌دهند زمان مذاکره STARTTLS را به‌دقت تنظیم کنید (Eric Blake).
.PP
رابط‌های برنامه‌نویسی جدید \fBnbd_set_socket_activation_name\fR\|(3) و
\&\fBnbd_get_socket_activation_name\fR\|(3) که به شما امکان می‌دهند سوکت مورد استفاده برای راه‌اندازی سوکت (socket activation) را نام‌گذاری کنید. سرورهای خاصی مانند
qemu\-storage\-daemon از این نام در خط فرمان و در اسکریپت‌ها استفاده خواهند کرد (با تشکر از Laszlo Ersek).
.SS "بهبودهای رابط‌های برنامه‌نویسی موجود (Enhancements to existing APIs)"
.IX Subsection "Enhancements to existing APIs"
فراخوانی \&\fBnbd_connect_command\fR\|(3) با آرگومان NULL برای پارامتر argv پیش از این منجر به خرابی (crash) می‌شد، اما اکنون یک خطا برمی‌گرداند (Eric Blake).
.PP
اکنون می‌توان \&\fBnbd_opt_list_meta_context\fR\|(3) را بدون مذاکره از پیش در مورد پاسخ‌های ساختاریافته فراخوانی کرد (Eric Blake).
.PP
تابع \&\fBnbd_set_strict_mode\fR\|(3) دارای یک پرچم جدید \f(CW\*(C`LIBNBD_STRICT_PAYLOAD\*(C'\fR است
که می‌تواند برای کنترل ارسال پیام‌های بیش‌از‌حد بزرگ به‌منظور آزمایش سرورها استفاده شود (Eric Blake).
.PP
پارامترهای اشاره‌گر در رابط برنامه‌نویسی C که نمی‌توانند NULL باشند، اکنون با
\&\f(CW\*(C`attribute((nonnull))\*(C'\fR مشخص شده‌اند (در صورتی که کامپایلر از آن پشتیبانی کند) تا در صورت استفاده نادرست، در زمان کامپایل هشدار دریافت کنید (با تشکر از Eric Blake).
.PP
توابع C که تخصیص حافظه انجام می‌دهند اکنون با \f(CW\*(C`attribute((malloc))\*(C'\fR و
صفات مشابه نشانه‌گذاری شده‌اند تا تحلیل ایستای برنامه‌های استفاده‌کننده از
libnbd بهبود یابد (Eric Blake).
.PP
توابع C که مقادیر پرچم‌ها را بیان می‌کنند اکنون از انواع داده بدون علامت (unsigned) استفاده می‌کنند، که برخی از رفتارهای نامعین در محاسبات بیتی روی اعداد صحیح علامت‌دار را برطرف می‌کند. این تغییر از نظر API و ABI با نسخه‌های پیشین سازگار است (Eric Blake).
.SS "ابزارها (Tools)"
.IX Subsection "Tools"
برنامه جدید \fBnbdublk\fR\|(1) که برای ایجاد یک دستگاه بلوکی لینوکس
\&\fI/dev/ublkb<N>\fR از یک سرور NBD استفاده می‌شود (با تشکر از
Ming Lei).
.PP
دستور \&\fBnbdinfo\fR\|(1) اکنون دارای خروجی رنگی است (برای غیرفعال کردن از \fI\-\-no\-color\fR استفاده کنید).
.PP
دستور nbdinfo دارای گزینه‌های جدید \fI\-\-is tls\fR و \fI\-\-can structured\-reply\fR است تا به شما اجازه دهد وجود این قابلیت‌ها را در سرور بررسی کنید (Eric Blake).
.PP
دستور \&\fBnbdcopy\fR\|(1) اکنون پیام‌های پیشرفت را در stderr می‌نویسد (قبلاً در \fI/dev/tty\fR نوشته می‌شدند). این امر آن را با ابزارهای دیگر مانند dd هماهنگ می‌کند (Eric Blake).
.PP
گزینه‌های \fI\-c\fR و \fI\-u\fR در \&\fBnbdsh\fR\|(1) اکنون می‌توانند به‌صورت درهم‌آمیخته استفاده شوند، که تغییر وضعیت قابلیت‌های اختیاری URI را ساده‌تر می‌کند (Eric Blake).
.SS "اتصالات زبان‌ها (Language bindings)"
.IX Subsection "Language bindings"
مستندات بایندرهای OCaml اکنون شامل نام پارامترها است.
.PP
بایندرهای OCaml اکنون به جای کدهای خطای خام C errno، مقادیر خطای OCaml را در استثناها (exceptions) برمی‌گردانند.
.PP
بایندرهای OCaml اکنون از \fBnbd_aio_connect\fR\|(3) پشتیبانی می‌کنند که مستقیماً از نوع sockaddr استفاده می‌کند.
.PP
بایندرهای Python اکنون دارای یک متد صریح \f(CW\*(C`h.close()\*(C'\fR هستند. خارج شدن دستگیره (handle) از دامنه اعتبار (scope) همچنان برای بستن آن عمل می‌کند، اما اکنون این امکان را دارید که پیش از خروج از دامنه، دستگیره را به‌طور صریح ببندید. اگر پس از بستن تلاش کنید از آن استفاده کنید، استثنای جدید
\&\f(CW\*(C`nbd.ClosedHandle\*(C'\fR صادر خواهد شد.
.PP
بایندرهای Python اکنون تابعی با دکوراتور contextlib ارائه می‌دهند، بنابراین می‌توانید ساختار طبیعی‌تر \f(CW\*(C`with\ nbd.nbd()\ as\ h:\ ...\*(C'\fR را بنویسید.
.SS "آزمون‌ها (Tests)"
.IX Subsection "Tests"
پوشش گسترده‌تر در ادغام مداوم (CI) (توسط Eric Blake).
.SS "سایر بهبودها و رفع باگ‌ها (Other improvements and bug fixes)"
.IX Subsection "Other improvements and bug fixes"
ماشین وضعیت (state machine) اکنون می‌تواند با برخی پیام‌های پاسخ ساختاریافته معیوب و کوکی‌های ناشناخته ارسال‌شده از سوی سرور کنار بیاید و بازیابی شود (Eric Blake).
.PP
کتابخانه اکنون با \f(CW\*(C`\-z nodelete\*(C'\fR نشانه‌گذاری شده است، که از باربرداری «واقعی» آن در هنگام فراخوانی \fBdlclose\fR\|(3) جلوگیری می‌کند. این تنها راه برای جلوگیری از خرابی (crash) در کدهای چندنخی (multithreaded) است. برای جزئیات بیشتر به کامیت 368e3d0d5a887 مراجعه کنید.
.PP
بهبود قابلیت اشکال‌زدایی زمانی که دستگیره وارد وضعیت \f(CW%DEAD\fR می‌شود.
.PP
کتابخانه اکنون هنگام اجرای زیرفرمان‌ها بسیار بیشتر با POSIX سازگار و تاب‌آور است، و دیگر به رفتارهای خاص پیاده‌سازی glibc از execvp و سایر توابع ناامن در برابر سیگنال‌های ناهمگام (non\-async\-signal\-safe) وابسته نیست (Laszlo Ersek).
.PP
فایل‌های منبع برای رعایت حداکثر ۸۰ ستون مجدداً قالب‌بندی شدند (Laszlo Ersek).
.SS "ساخت (Build)"
.IX Subsection "Build"
رفع مشکل ساخت در Alpine Linux + musl که ثبات \f(CW\*(C`AF_VSOCK\*(C'\fR را اعلان می‌کند اما ساختارهای مرتبط با آن را تعریف نمی‌کند (Eric Blake).
.PP
ماژول distutils پایتون، که در نگارش‌های ۳.۱۰ به بعد پایتون منسوخ شده است، با sysconfig جایگزین شد (با تشکر از Miro Hrončok).
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
\&\fBlibnbd\fR\|(3).
.SH "نویسندگان (AUTHORS)"
.IX Header "AUTHORS"
.IP "Daniel P. Berrangé" 4
.IX Item "Daniel P. Berrangé"
.PD 0
.IP "Eric Blake" 4
.IX Item "Eric Blake"
.IP "Laszlo Ersek" 4
.IX Item "Laszlo Ersek"
.IP "Ming Lei" 4
.IX Item "Ming Lei"
.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