نام (NAME)

llvm-link - پیونددهنده بیت‌کد LLVM

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

llvm-link [options] filename ...

توضیحات (DESCRIPTION)

دستور llvm-link چندین فایل بیت‌کد LLVM را دریافت کرده و آن‌ها را در قالب یک فایل بیت‌کد واحد LLVM به یکدیگر پیوند می‌دهد. این دستور فایل خروجی را در خروجی استاندارد می‌نویسد، مگر اینکه با استفاده از گزینهٔ -o نام فایلی تعیین شده باشد.

گزینه‌ها (OPTIONS)

-f: فعال‌سازی خروجی باینری روی پایانه‌ها. در حالت عادی، اگر جریان خروجی یک پایانه باشد، llvm-link از نوشتن خروجی خام بیت‌کد خودداری می‌کند. با این گزینه، llvm-link صرف‌نظر از نوع دستگاه خروجی، بیت‌کد خام را می‌نویسد.

-o filename: تعیین نام فایل خروجی. اگر filename برابر با "-" باشد، llvm-link خروجی خود را در خروجی استاندارد خواهد نوشت.

-S: نوشتن خروجی در قالب زبان واسط LLVM (به‌جای بیت‌کد).

-d: در صورت تعیین، llvm-link نگارش قابل خواندن برای انسان از فایل بیت‌کد خروجی را در خطای استاندارد چاپ می‌کند.

--help: چاپ خلاصه‌ای از گزینه‌های خط فرمان.

-v: حالت پرگو (verbose). چاپ اطلاعات دربارهٔ کارهایی که llvm-link انجام می‌دهد. این اطلاعات معمولاً شامل پیامی به ازای هر فایل بیت‌کد پیوند داده‌شده و هر کتابخانهٔ پیداشده است.

--override <filename>: فایل ارائه‌شده را به فرآیند پیوند اضافه کرده و نمادهایی را که پیش‌تر اعلان شده‌اند با تعاریف موجود در فایل ارائه‌شده جایگزین (override) می‌کند. این پرچم را می‌توان چندین بار مشخص کرد تا چندین فایل نقش جایگزین داشته باشند. اگر یک نماد بیش از دو بار اعلان شده باشد، تعریف مربوط به فایلی که در آخر اعلان شده اولویت خواهد داشت.

--import <function:filename>: مشخص کردن تابعی که باید جهت پیوند با ThinLTO از فایل تعیین‌شده وارد (import) شود. این گزینه را می‌توان چندین بار برای وارد کردن چندین تابع مشخص کرد.

--summary-index <filename>: مشخص کردن مسیر فایلی شامل نمایهٔ خلاصهٔ ماژول (module summary index) همراه با نتایج پیوند قبلی ThinLTO. هنگام استفاده از --import، این گزینه الزامی است.

--internalize: درونی‌سازی نمادهای پیوند داده‌شده (internalize).

--disable-debug-info-type-map: استفاده از نگاشت نوع یکتاکننده (uniquing type map) را برای اطلاعات اشکال‌زدایی غیرفعال می‌کند.

--only-needed: پیوند دادن فقط نمادهای مورد نیاز.

--disable-lazy-loading: غیرفعال‌سازی بارگذاری تنبل ماژول (lazy module loading).

--suppress-warnings: فرونشاندن تمامی هشدارهای پیونددهنده.

--preserve-bc-uselistorder: حفظ ترتیب use-list هنگام نوشتن بیت‌کد LLVM.

--preserve-ll-uselistorder: حفظ ترتیب use-list هنگام نوشتن اسمبلی LLVM.

--ignore-non-bitcode: هنگام پردازش یک آرشیو، در صورت مواجهه با فایلی غیر از بیت‌کد خطایی صادر نشود.

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

اگر llvm-link موفقیت‌آمیز باشد، با مقدار 0 خارج می‌شود. در غیر این صورت، اگر خطایی رخ دهد، با مقداری غیر صفر خارج خواهد شد.

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

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

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

2003-2026, LLVM Project

2026-07-15