نام (NAME)

guestfs-release-notes - یادداشت‌های انتشار libguestfs

یادداشت‌های انتشار برای LIBGUESTFS 1.8 (RELEASE NOTES FOR LIBGUESTFS 1.8)

این یادداشت‌های انتشار تنها تفاوت‌ها نسبت به انشعاب پایدار/توسعه پیشین (1.6.0) را پوشش می‌دهند. برای گزارش تفصیلی تغییرات، لطفاً مخزن git یا فایل ChangeLog توزیع‌شده در بسته فشرده (tarball) را ببینید.

- پشتیبانی و بسته‌ها برای Debian و Ubuntu.
- ساخت‌های روزانه از مخزن git روی Debian و Ubuntu برای کاهش خطر
  پس‌رفت‌ها (regressions).
- پورت به 'pacman' در ArchLinux (با تشکر از Thomas S Hatch).
- ابزارهای زیر به C بازنویسی شده‌اند (در اصل در Perl بودند):
    . virt-cat
    . virt-df
    . virt-inspector
    . virt-ls
    . virt-rescue
- برخی از ابزارهای C مهمان‌های رمزنگاری‌شده را به طور خودکار پشتیبانی می‌کنند. این
  قابلیت در این ابزارها پشتیبانی می‌شود: guestfish، guestmount، virt-cat، virt-inspector،
  virt-ls.
- ابزار جدید virt-filesystems (در C) که جایگزینی برای
  virt-list-filesystems و virt-list-partitions است، و مجموعه‌ی بزرگ‌تری
  از عملکردهای آن ابزارها را دارد.
- ابزارهای guestfish، guestmount و ابزارهای C از تجزیه‌ی یکپارچه‌ی گزینه‌های
  خط فرمان استفاده می‌کنند، بنابراین از بسیاری از گزینه‌های مشترک مانند '-a disk.img'،
  '-d libvirt-domain'، '-x'، '-v' پشتیبانی می‌کنند. تجزیه‌ی قدیمی
  گزینه‌های خط فرمان برای سازگاری در اسکریپت‌ها و غیره حفظ شده است.
- ابزار guestfish دیگر هیچ وابستگی به Perl ندارد.
- صفحات راهنمای جدید شامل مثال‌های برنامه‌نویسی: guestfs-examples(3) (C/C++)،
  guestfs-ocaml(3)، guestfs-python(3)، guestfs-ruby(3).
- حالت ردیابی (Trace mode) مقادیر بازگشتی از توابع API را چاپ می‌کند.
- ابزار virt-inspector می‌تواند برنامه‌های نصب‌شده در مهمان‌های Windows را
  همراه با اطلاعات بسیار زیادی درباره‌ی آن برنامه‌ها فهرست کند.
- افزودن پشتیبانی برای بازرسی: Linux Mint، Mandriva، FreeBSD.
- گزینه‌ی --rw در guestfish (در حال حاضر بدون تأثیر) برای صریح کردن
  دسترسی‌های نوشتن بالقوه خطرناک.
- گزینه‌های --listen --csh در guestfish برای سازگاری با csh و tcsh (با تشکر
  از Eric Blake).
- اولین نسخه‌ی بالادستی که هر تابع API را معرفی کرده است، اکنون در
  guestfs(3) مستند شده است.
- تابع guestfs_last_errno به شما اجازه می‌دهد تا errno را از
  دیمن بازیابی کنید که به درستی به سیستم‌عامل محلی ترجمه شده است.
- توابع اکنون می‌توانند پارامترهای اختیاری داشته باشند.
- نوارهای پیشرفت و اعلانات پیشرفت اکنون می‌توانند برای دستورهای
  بارگذاری (upload) رخ دهند.
- سازنده‌ی appliance دقت بیشتری به خرج می‌دهد تا فایل‌های موقت را در
  /tmp باقی نگذارد.
- دستورهای getfattr/setfattr به virt-rescue اضافه شدند.
- فایل ROADMAP شامل نقشه‌ی راه و اهداف برای انتشار‌های آینده است.

- بخش جدید SECURITY در مستندات API در guestfs(3).
- ابزار virt-inspector دیگر هیچ دستوری را در ماشین مهمان اجرا نمی‌کند.
- کد بازرسی در اجتناب از فایل‌های بسیار بزرگ از مهمان‌ها که قبلاً ممکن
  بود باعث بروز منع سرویس (denial of service) شوند، دقت بیشتری به خرج می‌دهد.
- فراخوانی‌های FUSE به درون guestmount اکنون هنگام استفاده از guestmount -x
  ردیابی می‌شوند.

- add-domain
- add-drive-opts
- getxattr
- inspect-get-hostname
- inspect-get-package-format
- inspect-get-package-management
- inspect-get-roots
- inspect-list-applications
- lgetxattr
- mkfs-opts

- برنامه‌های C اکنون دقیقاً فقط با کتابخانه‌هایی که استفاده می‌کنند پیوند می‌خورند.
- کتابخانه‌های PCRE، libmagic، hivex و libvirt اکنون برای ساخت کاملاً
  اختیاری هستند.
- نشت‌های حافظه و نشت‌های توصیف‌گر فایل متعددی رفع شدند.
- افزودن یک لفاف POD برای یکپارچه‌سازی تولید صفحات راهنما و فایل‌های HTML
  در تمامی برنامه‌ها.
- سورس‌کد شامل ایمیج‌های ساختگی از مهمان‌های Fedora، Debian، Ubuntu و
  Windows است.
- اتصالات زبان Ruby دارای قاعده‌ی 'make install' هستند.
- فایل سرآیند <guestfs.h> اکنون یک فایل واحد است.
- فایل سرآیند <guestfs.h> نیازی به هدرهای XDR ندارد.
- کتابخانه‌ی ocaml xml-light دیگر برای ساخت مورد نیاز نیست (با تشکر
  از Maxim Koltsov).
- گزینه‌ی ./configure --disable-[...] برای اتصالات هر زبان (با تشکر
  از Maxim Koltsov).
- برنامه‌ی قدیمی ocaml-viewer حذف شد (به جای آن از guestfs-browser استفاده کنید).
- نوع جدید آزمون C API با نام 'InitScratchFS' باعث می‌شود آزمون‌ها کمی
  سریع‌تر اجرا شوند.
- بسته‌های مستثنی‌شده در appliance اکنون در یک فایل مجزا با نام
  appliance/excludelist.in فهرست شده‌اند و می‌توانند به ازای هر توزیع سفارشی‌سازی شوند.

- 663407 تابع readlink و readlinklist در برخی مسیرها /sysroot/ برمی‌گردانند
- 661280 ابزار virt-rescue: وحشت (panic) هنگام خاموش شدن: "/sbin/reboot: No such file or directory"
- 657499 نوع نادرست checksum باعث شکست umount می‌شود
- 655554 مسیرهای کل دیسک توسط virt-inspector استاندارد (canonical) نمی‌شوند
- 654638 بروزرسانی openssl به 1.0.0b؛ وابستگی libguestfs به نام‌های دقیق فایل
- 652796 اتصالات ruby توسط 'make install' نصب نمی‌شوند، از این رو از توزیع دودویی حذف شده‌اند

همچنین ببینید (SEE ALSO)

guestfs-examples(1), guestfs-faq(1), guestfs-performance(1), guestfs-recipes(1), guestfs-testing(1), guestfs(3), guestfish(1), http://libguestfs.org

نویسندگان (AUTHORS)

Richard W.M. Jones

کپی‌رایت و تکثیر (COPYRIGHT)

Copyright (C) 2009-2025 Red Hat Inc.

مجوز (LICENSE)

این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط «مجوز عمومی همگانی گنو» (GNU General Public License) همان‌طور که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است؛ چه نسخه‌ی 2 مجوز، یا (به اختیار خودتان) هر نسخه‌ی بالاتر دیگری، بازتوزیع کرده یا تغییر دهید.

این برنامه به این امید توزیع شده است که مفید واقع شود، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابل فروش بودن یا مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر «مجوز عمومی همگانی گنو» را ببینید.

شما باید یک نسخه از «مجوز عمومی همگانی گنو» را به همراه این برنامه دریافت کرده باشید؛ اگر این‌طور نیست، به شرکت بنیاد نرم‌افزارهای آزاد با نشانی زیر بنویسید: Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.

گزارش باگ‌ها (BUGS)

برای مشاهده‌ی فهرست باگ‌های مربوط به libguestfs از این پیوند استفاده کنید: https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools

برای گزارش یک باگ جدید علیه libguestfs از این پیوند استفاده کنید: https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools

هنگام گزارش یک باگ، لطفاً موارد زیر را ارائه دهید:

• نسخه‌ی libguestfs.
• محل دریافت libguestfs (مثلاً کدام توزیع لینوکس، کامپایل‌شده از سورس، غیره).
• باگ را به طور دقیق شرح داده و روشی برای بازتولید آن ارائه دهید.
• دستور libguestfs-test-tool(1) را اجرا کرده و خروجی کامل و ویرایش‌نشده را در گزارش باگ جای‌گذاری کنید.