.\" Man page generated from reStructuredText
.\" by the Docutils 0.22.4 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "ABILINT" "1" "May 01, 2026" "" "Libabigail"
.SH "نام (NAME)"
abilint \- اعتبارسنجی بازنمایی ABI در abigail
.sp
دستور abilint بازنمایی بومی XML یک ABI را همان‌گونه که توسط
abidw \%<>\& صادر شده است، تجزیه می‌کند. پس از تجزیهٔ بازنمایی XML مربوط به ABI،
\fBabilint\fP یک مدل درون‌حافظه‌ای از آن می‌سازد. سپس تلاش می‌کند
آن را دوباره در قالب XML روی خروجی استاندارد ذخیره کند. اگر این عملیات
خواندن\-نوشتن موفقیت‌آمیز باشد، احتمال زیادی وجود دارد که بازنمایی XML ورودی ABI
معنادار و معتبر باشد.
.sp
توجه داشته باشید که هدف اصلی این ابزار، کمک به اشکال‌زدایی مشکلات در
کتابخانهٔ زیربنایی Libabigail است.
.sp
همچنین توجه داشته باشید که \fBabilint\fP می‌تواند یک فایل ورودی 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> باشد.
.SH "فراخوانی (INVOCATION)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
abilint [options] [<abi\-file1>]
.EE
.UNINDENT
.UNINDENT
.SH "گزینه‌ها (OPTIONS)"
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
\fB\-\-annotate\fP
.sp
خروجی ABIXML را با یادداشت‌هایی در بالای بیشتر عناصر حاشیه‌نویسی می‌کند. این
یادداشت‌ها شامل نگارش خوانا و آراستهٔ (pretty\-printed) نوع‌ها، اعلانات
یا حتی نمادهای ELF هستند. هدف از این کار، خواناتر شدن خروجی ABIXML
برای انسان به منظور اشکال‌زدایی یا مستندسازی است.
.IP \(bu 2
\fB\-\-ctf\fP
.sp
استخراج اطلاعات ABI از اطلاعات اشکال‌زدایی CTF، در صورتی که در شیءِ داده‌شده
وجود داشته باشد.
.IP \(bu 2
\fB\-\-debug\-info\-dir\fP <\fIpath\fP>
.sp
هنگام خواندن یک فایل ورودی ELF \%<http://\:en\:.wikipedia\:.org/\:wiki/\:Executable_and_Linkable_Format> که اطلاعات اشکال‌زدایی آن
در یک فایل جداگانه تفکیک شده است، این گزینه به \fBabilint\fP می‌گوید
که فایل اطلاعات اشکال‌زدایی جداگانه را در کجا پیدا کند.
.sp
توجه داشته باشید که \fIpath\fP باید به دایرکتوری ریشه‌ای اشاره کند که اطلاعات
اشکال‌زدایی در آن به صورت درختی سازماندهی شده است. در سیستم‌های مبتنی بر
Red Hat، این دایرکتوری معمولاً
\fB<root>/usr/lib/debug\fP است\&.
.sp
همچنین توجه داشته باشید که این گزینه برای اطلاعات اشکال‌زدایی تفکیک‌شده‌ای که
توسط مدیر بستهٔ سیستم شما نصب شده است الزامی نیست، زیرا در آن صورت
\fBabidiff\fP می‌داند آن را کجا پیدا کند.
.IP \(bu 2
\fB\-\-diff\fP
.sp
برای ورودی‌های XML، یک مقایسهٔ متنی (diff) میان ورودی و مدل حافظه‌ای
ذخیره‌شده روی دیسک انجام می‌دهد. این کار می‌تواند به شناسایی مشکلات مربوط به
مدیریت قالب XML توسط کتابخانهٔ زیربنایی Libabigail کمک کند.
.IP \(bu 2
\fB\-\-header\-file | \-\-hf\fP <header\-file\-path>
.sp
مشخص می‌کند که یکی از هدرهای عمومی فایل abi که ابزار باید در نظر بگیرد
در کجا قرار دارد. بدین ترتیب، این ابزار نوع‌هایی را که در هدرهای عمومی
تعریف نشده‌اند، فیلتر و حذف می‌کند.
.IP \(bu 2
\fB\-\-headers\-dir | \-\-hd\fP <headers\-directory\-path\-1>
.sp
مشخص می‌کند که هدرهای عمومی نخستین کتابخانهٔ اشتراکی که ابزار باید در نظر بگیرد
در کجا قرار دارند. بدین ترتیب، این ابزار نوع‌هایی را که در هدرهای عمومی
تعریف نشده‌اند، فیلتر و حذف می‌کند.
.IP \(bu 2
\fB\-\-help\fP
.sp
نمایش یک پیام راهنمای کوتاه و خروج.
.IP \(bu 2
\fB\-\-noout\fP
.sp
هیچ‌چیزی در خروجی استاندارد نمایش داده نمی‌شود. کد بازگشتی
دستور، تنها راه برای آگاهی از موفقیت‌آمیز بودن آن است.
.IP \(bu 2
\fB\-\-suppressions | suppr\fP <\fIpath\-to\-suppression\-specifications\-file\fP>
.sp
استفاده از یک فایل مشخصات فرونشانی (suppression specification) \%<#\:suppr-spec-label>
واقع در \fIpath\-to\-suppression\-specifications\-file\fP\&. توجه داشته باشید که
این گزینه می‌تواند چندین بار در خط فرمان تکرار شود. در چنین حالتی،
تمام فایل‌های مشخصات فرونشانی ارائه‌شده مد نظر قرار می‌گیرند. مصنوعات ABI
منطبق بر مشخصات فرونشانی، از خروجی این ابزار حذف (فرونشانده) می‌شوند.
.IP \(bu 2
\fB\-\-stdin | \-\-\fP
.sp
خواندن محتوای ورودی از ورودی استاندارد.
.IP \(bu 2
\fB\-\-tu\fP
.sp
فرض می‌کند که XML ورودی نمایانگر یک واحد ترجمه (translation unit) منفرد است.
.IP \(bu 2
\fI\-\-verbose\fP
.sp
نمایش پیام‌های مفصل دربارهٔ امور داخلی. این گزینه برای اشکال‌زدایی
ابزار و کتابخانهٔ زیربنایی آن به کار می‌رود.
.IP \(bu 2
\fI\-\-version | \-v\fP
.sp
نمایش نسخهٔ برنامه و خروج.
.UNINDENT
.UNINDENT
.UNINDENT
.SH "نویسندگان (AUTHORS)"
Dodji Seketeli
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
2014-2025, Red Hat, Inc.
.\" End of generated man page.