ABILINT(1) Libabigail ABILINT(1)

abilint - اعتبارسنجی بازنمایی ABI در abigail

دستور abilint بازنمایی بومی XML یک ABI را همان‌گونه که توسط abidw <> صادر شده است، تجزیه می‌کند. پس از تجزیهٔ بازنمایی XML مربوط به ABI، abilint یک مدل درون‌حافظه‌ای از آن می‌سازد. سپس تلاش می‌کند آن را دوباره در قالب XML روی خروجی استاندارد ذخیره کند. اگر این عملیات خواندن-نوشتن موفقیت‌آمیز باشد، احتمال زیادی وجود دارد که بازنمایی XML ورودی ABI معنادار و معتبر باشد.

توجه داشته باشید که هدف اصلی این ابزار، کمک به اشکال‌زدایی مشکلات در کتابخانهٔ زیربنایی Libabigail است.

همچنین توجه داشته باشید که abilint می‌تواند یک فایل ورودی ELF http://en.wikipedia.org/wiki/Executable_and_Linkable_Format را بخواند، مدل درون‌حافظه‌ای ABI آن را بسازد، و آن مدل را دوباره به صورت XML در خروجی استاندارد سریال‌سازی کند. در این حالت، فایل ورودی ELF http://en.wikipedia.org/wiki/Executable_and_Linkable_Format باید همراه با اطلاعات دیباگ خود در قالب DWARF http://www.dwarfstd.org باشد.

abilint [options] [<abi-file1>]

  • --annotate

    خروجی ABIXML را با یادداشت‌هایی در بالای بیشتر عناصر حاشیه‌نویسی می‌کند. این یادداشت‌ها شامل نگارش خوانا و آراستهٔ (pretty-printed) نوع‌ها، اعلانات یا حتی نمادهای ELF هستند. هدف از این کار، خواناتر شدن خروجی ABIXML برای انسان به منظور اشکال‌زدایی یا مستندسازی است.

  • --ctf

    استخراج اطلاعات ABI از اطلاعات اشکال‌زدایی CTF، در صورتی که در شیءِ داده‌شده وجود داشته باشد.

  • --debug-info-dir <path>

    هنگام خواندن یک فایل ورودی ELF http://en.wikipedia.org/wiki/Executable_and_Linkable_Format که اطلاعات اشکال‌زدایی آن در یک فایل جداگانه تفکیک شده است، این گزینه به abilint می‌گوید که فایل اطلاعات اشکال‌زدایی جداگانه را در کجا پیدا کند.

    توجه داشته باشید که path باید به دایرکتوری ریشه‌ای اشاره کند که اطلاعات اشکال‌زدایی در آن به صورت درختی سازماندهی شده است. در سیستم‌های مبتنی بر Red Hat، این دایرکتوری معمولاً <root>/usr/lib/debug است.

    همچنین توجه داشته باشید که این گزینه برای اطلاعات اشکال‌زدایی تفکیک‌شده‌ای که توسط مدیر بستهٔ سیستم شما نصب شده است الزامی نیست، زیرا در آن صورت abidiff می‌داند آن را کجا پیدا کند.

  • --diff

    برای ورودی‌های XML، یک مقایسهٔ متنی (diff) میان ورودی و مدل حافظه‌ای ذخیره‌شده روی دیسک انجام می‌دهد. این کار می‌تواند به شناسایی مشکلات مربوط به مدیریت قالب XML توسط کتابخانهٔ زیربنایی Libabigail کمک کند.

  • --header-file | --hf <header-file-path>

    مشخص می‌کند که یکی از هدرهای عمومی فایل abi که ابزار باید در نظر بگیرد در کجا قرار دارد. بدین ترتیب، این ابزار نوع‌هایی را که در هدرهای عمومی تعریف نشده‌اند، فیلتر و حذف می‌کند.

  • --headers-dir | --hd <headers-directory-path-1>

    مشخص می‌کند که هدرهای عمومی نخستین کتابخانهٔ اشتراکی که ابزار باید در نظر بگیرد در کجا قرار دارند. بدین ترتیب، این ابزار نوع‌هایی را که در هدرهای عمومی تعریف نشده‌اند، فیلتر و حذف می‌کند.

  • --help

    نمایش یک پیام راهنمای کوتاه و خروج.

  • --noout

    هیچ‌چیزی در خروجی استاندارد نمایش داده نمی‌شود. کد بازگشتی دستور، تنها راه برای آگاهی از موفقیت‌آمیز بودن آن است.

  • --suppressions | suppr <path-to-suppression-specifications-file>

    استفاده از یک فایل مشخصات فرونشانی (suppression specification) <#suppr-spec-label> واقع در path-to-suppression-specifications-file. توجه داشته باشید که این گزینه می‌تواند چندین بار در خط فرمان تکرار شود. در چنین حالتی، تمام فایل‌های مشخصات فرونشانی ارائه‌شده مد نظر قرار می‌گیرند. مصنوعات ABI منطبق بر مشخصات فرونشانی، از خروجی این ابزار حذف (فرونشانده) می‌شوند.

  • --stdin | --

    خواندن محتوای ورودی از ورودی استاندارد.

  • --tu

    فرض می‌کند که XML ورودی نمایانگر یک واحد ترجمه (translation unit) منفرد است.

  • --verbose

    نمایش پیام‌های مفصل دربارهٔ امور داخلی. این گزینه برای اشکال‌زدایی ابزار و کتابخانهٔ زیربنایی آن به کار می‌رود.

  • --version | -v

    نمایش نسخهٔ برنامه و خروج.

Dodji Seketeli

2014-2025, Red Hat, Inc.

May 1, 2026