نام (NAME)

llvm-tli-checker - بررسی‌کننده تطابق TargetLibraryInfo با کتابخانه‌ها

خلاصه دستور (SYNOPSIS)

llvm-tli-checker [options] [library-file...]

توضیحات (DESCRIPTION)

دستور llvm-tli-checker دیدگاه TargetLibraryInfo را درباره در دسترس بودن توابع کتابخانه‌ای با مجموعه‌ای از توابع صادرشده (exported) توسط فایل‌های کتابخانه مشخص‌شده مقایسه کرده و هرگونه مغایرت میان دیدگاه TLI و حضور واقعی تابع را گزارش می‌کند. این ابزار در درجه اول برای سازندگان و توسعه‌دهندگان پلتفرم مفید است تا اطمینان حاصل کنند که TLI برای معماری هدف (target) آن‌ها صحیح است و کامپایلر یک توالی کد را به فراخوانی کتابخانه‌ای که در عمل در دسترس نیست "بهینه‌سازی" نمی‌کند.

مثال‌ها (EXAMPLES)

$ llvm-tli-checker --triple x86_64-scei-ps4 example.so
TLI knows 466 symbols, 235 available for 'x86_64-scei-ps4'
Looking for symbols in 'example.so'
Found 235 global function symbols in 'example.so'
Found a grand total of 235 library symbols
<< TLI yes SDK no:  '_ZdaPv' aka operator delete[](void*)
>> TLI no  SDK yes: '_ZdaPvj' aka operator delete[](void*, unsigned int)
<< Total TLI yes SDK no:  1
>> Total TLI no  SDK yes: 1
== Total TLI yes SDK yes: 234
FAIL: LLVM TLI doesn't match SDK libraries.

گزینه‌ها (OPTIONS)

--dump-tli: چاپ وضعیت "available"/"not available" برای هر تابع کتابخانه بر اساس اطلاعات TargetLibraryInfo برای triple مشخص‌شده، و سپس خروج. این گزینه هیچ فایل ورودی را نمی‌خواند.

--help, -h: نمایش خلاصه‌ای از گزینه‌های خط فرمان و خروج.

--libdir=<directory>: دایرکتوری پایه برای اضافه شدن به ابتدای مسیر هر فایل کتابخانه. این گزینه زمانی که چندین فایل کتابخانه همگی در یک دایرکتوری قرار دارند، یا فهرستی از نام‌های فایل‌های ورودی درون یک response file نگهداری می‌شوند، کاربردی است.

--report=<level>: میزان اطلاعاتی که باید گزارش شود. مقدار <level> می‌تواند summary، discrepancy، یا full باشد. گزارش summary فقط تعداد نمادهای منطبق و غیرمنطبق را ارائه می‌دهد؛ discrepancy نمادهای غیرمنطبق را فهرست می‌کند؛ و full تمام نمادهای شناخته‌شده برای TLI را، چه منطبق و چه غیرمنطبق، فهرست می‌کند. مقدار پیش‌فرض discrepancy است.

--separate: خواندن و گزارش یک خلاصه به تفکیک برای هر فایل کتابخانه. این گزینه می‌تواند برای شناسایی فایل‌های کتابخانه‌ای که هیچ نماد شناخته‌شده‌ای توسط TLI ارائه نمی‌دهند مفید باشد. این گزینه متضمن --report=summary است (می‌تواند بازنویسی شود).

--triple=<triple>: مقدار triple مورد استفاده برای مقداردهی اولیه TargetLibraryInfo.

@<FILE>: خواندن گزینه‌های خط فرمان و/یا نام‌های کتابخانه از فایل پاسخ <FILE>.

وضعیت خروج (EXIT STATUS)

دستور llvm-tli-checker حتی در صورت وجود عدم تطابق نیز مقدار 0 را برمی‌گرداند. در صورتی که یک گزینه ناشناخته مشخص شود یا هیچ فایل ورودی ارائه نشده باشد، یک کد خروج غیرصفر برمی‌گرداند.

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

توسط تیم LLVM نگهداری می‌شود (https://llvm.org).

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

2003-2026, LLVM Project