LLVM-CONFIG(1)                       LLVM                       LLVM-CONFIG(1)

نام (NAME)
       llvm-config - چاپ گزینه‌های کامپایل LLVM

خلاصه دستور (SYNOPSIS)
       llvm-config option [components...]

توضیحات (DESCRIPTION)
       ابزار llvm-config ساخت برنامه‌هایی که از LLVM استفاده می‌کنند را آسان‌تر
       می‌کند. این ابزار می‌تواند فلگ‌های کامپایلر، فلگ‌های پیونددهنده و
       کتابخانه‌های شیء مورد نیاز برای پیوند به LLVM را چاپ کند.

مثال‌ها (EXAMPLES)
       برای پیوند به JIT:

          g++ `llvm-config --cxxflags` -o HowToUseJIT.o -c HowToUseJIT.cpp
          g++ `llvm-config --ldflags` -o HowToUseJIT HowToUseJIT.o \
              `llvm-config --libs engine bcreader scalaropts`

گزینه‌ها (OPTIONS)
       --assertion-mode
          چاپ حالت assertion مورد استفاده هنگام ساخت LLVM (مقدار ON یا OFF).

       --bindir
          چاپ دایرکتوری محل نصب فایل‌های اجرایی باینری LLVM.

       --build-mode
          چاپ حالت ساختی که هنگام ساخت LLVM استفاده شده است (مانند Debug یا
          Release).

       --build-system
          چاپ سیستم ساخت مورد استفاده برای ساخت LLVM (مانند cmake یا gn).

       --cflags
          چاپ فلگ‌های کامپایلر C مورد نیاز برای استفاده از هدرهای LLVM.

       --cmakedir
          چاپ دایرکتوری محل نصب ماژول‌های CMake مربوط به LLVM.

       --components
          چاپ تمام نام‌های معتبر برای مولفه‌ها (components).

       --cppflags
          چاپ فلگ‌های پیش‌پردازندهٔ C مورد نیاز برای استفاده از هدرهای LLVM.

       --cxxflags
          چاپ فلگ‌های کامپایلر C++ مورد نیاز برای استفاده از هدرهای LLVM.

       --has-rtti
          چاپ این که آیا LLVM با rtti ساخته شده است یا خیر (مقدار YES یا NO).

       --help
          چاپ خلاصه‌ای از آرگومان‌های llvm-config.

       --host-target
          چاپ target triple مورد استفاده برای پیکربندی LLVM.

       --ignore-libllvm
          نادیده گرفتن libLLVM و پیوند دادن کتابخانه‌های مولفه‌ها به‌جای آن.

       --includedir
          چاپ دایرکتوری محل نصب فایل‌های هدر LLVM.

       --ldflags
          چاپ فلگ‌های مورد نیاز برای پیوند به کتابخانه‌های LLVM.

       --libdir
          چاپ دایرکتوری محل نصب کتابخانه‌های LLVM.

       --libfiles
          مشابه --libs، اما مسیر کامل هر فایل کتابخانه را چاپ می‌کند. این گزینه
          هنگام ایجاد وابستگی‌های makefile برای اطمینان از پیوند دوبارهٔ ابزار
          در صورت تغییر هر یک از کتابخانه‌های مورد استفاده‌اش کاربرد دارد.

       --libnames
          مشابه --libs، اما نام فایل‌های کتابخانه‌ها را بدون پیشوند -l یا نام
          مسیر چاپ می‌کند. برای پیوند به نسخه‌ای از LLVM که هنوز نصب نشده است
          کاربرد دارد.

       --libs
          چاپ تمام کتابخانه‌های مورد نیاز برای پیوند به components مشخص‌شدهٔ
          LLVM، شامل تمام وابستگی‌ها.

       --link-shared
          پیوند دادن مولفه‌ها به صورت کتابخانه‌های اشتراکی (shared libraries).

       --link-static
          پیوند دادن کتابخانه‌های مولفه‌ها به صورت ایستا (static).

       --obj-root
          چاپ ریشهٔ فایل‌های شیء (object root) مورد استفاده برای ساخت LLVM.

       --prefix
          چاپ پیشوند نصب (prefix) برای LLVM.

       --quote-paths
          قرار دادن مسیرها در علامت نقل‌قول و گریز دادن آن‌ها در صورت لزوم،
          به‌ویژه زمانی که نویسه‌های نقل‌قول، فاصله، بک‌اسلش یا علامت دلار در مسیر
          وجود داشته باشند.

       --shared-mode
          چاپ نحوهٔ پیوند جمعی مولفه‌های ارائه‌شده (shared یا static).

       --system-libs
          چاپ تمام کتابخانه‌های سیستمی مورد نیاز برای پیوند به components
          مشخص‌شدهٔ LLVM، شامل تمام وابستگی‌ها.

       --targets-built
          چاپ نام مولفه‌ها برای تمامی مقصدهای (targets) پشتیبانی‌شده توسط این
          نسخه از LLVM.

       --version
          چاپ شماره نسخهٔ LLVM.

مولفه‌ها (COMPONENTS)
       برای چاپ فهرستی از تمام مولفه‌های موجود، دستور llvm-config --components
       را اجرا کنید. در بیشتر موارد، مولفه‌ها مستقیماً با کتابخانه‌های LLVM
       مطابقت دارند. مولفه‌های «مجازی» مفید عبارتند از:

       all
          شامل تمام کتابخانه‌های LLVM است. در صورتی که هیچ مولفه‌ای مشخص نشده
          باشد، این مقدار پیش‌فرض است.

       backend
          شامل backend بومی یا C backend است.

       engine
          شامل JIT بومی یا مفسر bitcode است.

وضعیت خروج (EXIT STATUS)
       اگر llvm-config با موفقیت به پایان برسد، با مقدار 0 خارج می‌شود. در غیر
       این صورت، در صورت بروز خطا، با مقداری غیر صفر خارج خواهد شد.

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

کپی‌رایت و تکثیر (COPYRIGHT)
       2003-2026, LLVM Project

22                                2026-07-15                    LLVM-CONFIG(1)