نام (NAME)

rustc - کامپایلر زبان Rust

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

rustc [OPTIONS] INPUT

توضیحات (DESCRIPTION)

این برنامه کامپایلری برای زبان Rust است که در نشانی https://www.rust-lang.org در دسترس است.

گزینه‌ها (OPTIONS)

-h, --help: نمایش پیام راهنما.
--cfg SPEC: پیکربندی محیط کامپایل.
-L [KIND=]PATH: افزودن یک دایرکتوری به مسیر جستجوی کتابخانه‌ها. مقدار اختیاری KIND می‌تواند یکی از موارد زیر باشد:

dependency: تنها وابستگی‌های متعدی (transitive) در اینجا جستجو شوند
crate: تنها دستورالعمل‌های محلی `extern crate` در اینجا جستجو شوند
native: تنها کتابخانه‌های محلی (native) در اینجا جستجو شوند
framework: تنها فریم‌ورک‌های OSX در اینجا جستجو شوند
all: همه موارد در اینجا جستجو شوند (پیش‌فرض)

-l [KIND=]NAME: پیوند دادن crate(های) تولیدشده به کتابخانه مشخص‌شده در NAME. مقدار اختیاری KIND می‌تواند یکی از مقادیر static، dylib یا framework باشد. در صورت مشخص نشدن، dylib در نظر گرفته می‌شود.
--crate-type [bin|lib|rlib|dylib|cdylib|staticlib|proc-macro]: فهرستی جداشده با کاما از انواع crateها که کامپایلر باید تولید کند.
--crate-name NAME: مشخص کردن نام crate در حال ساخت.
--emit [asm|llvm-bc|llvm-ir|obj|metadata|link|dep-info|mir][=PATH]: پیکربندی خروجی‌ای که rustc تولید خواهد کرد. هر خروجی می‌تواند یک مسیر PATH اختیاری و صریح نیز برای آن نوع خروجی خاص داشته باشد. این مسیر بر گزینه -o اولویت دارد.
--print [crate-name|file-names|sysroot|target-libdir|cfg|target-list|target-cpus|target-features|relocation-models|code-models|tls-models|target-spec-json|native-static-libs|stack-protector-strategies|link-args]: فهرستی جداشده با کاما از اطلاعات کامپایلر جهت چاپ در stdout.
-g: معادل با -C debuginfo=2.
-O: معادل با -C opt-level=2.
-o FILENAME: نوشتن خروجی در FILENAME. در صورتی که چندین خروجی --emit مشخص شده باشند که مسیر صریحی ندارند، نادیده گرفته می‌شود.
--out-dir DIR: نوشتن خروجی در DIR با نام فایلی که کامپایلر انتخاب می‌کند. در صورت مشخص شدن -o نادیده گرفته می‌شود. پیش‌فرض، دایرکتوری جاری است.
--explain OPT: ارائه توضیحات دقیق پیرامون یک پیام خطا.
--test: ساخت مهار آزمون (test harness).
--target TARGET: تاپل هدف (target tuple) که کد برای آن کامپایل می‌شود. این گزینه به طور پیش‌فرض تاپل هدف میزبان است. تاپل هدف قالب کلی <arch><sub>-<vendor>-<sys>-<abi> را دارد که در آن:

<arch>: شامل x86، arm، thumb، mips و غیره.
<sub>: برای مثال در ARM شامل: v5، v6m، v7a، v7m و غیره.
<vendor>: شامل pc، apple، nvidia، ibm و غیره.
<sys>: شامل none، linux، win32، darwin، cuda و غیره.
<abi>: شامل eabi، gnu، android، macho، elf و غیره.

-W help: چاپ گزینه‌های 'lint' و تنظیمات پیش‌فرض.
-W OPT, --warn OPT: تنظیم هشدارهای lint.
-A OPT, --allow OPT: مجاز کردن موارد lint.
-D OPT, --deny OPT: رد کردن موارد lint (به عنوان خطا).
-F OPT, --forbid OPT: قدغن کردن موارد lint (غیرقابل لغو).
-C FLAG[=VAL], --codegen FLAG[=VAL]: تنظیم یک پرچم مرتبط با تولید کد (codegen) به مقدار مشخص‌شده. برای چاپ پرچم‌های موجود از -C help استفاده کنید. بخش CODEGEN OPTIONS را در ادامه ببینید.
-V, --version: چاپ اطلاعات نسخه و خروج.
-v, --verbose: استفاده از خروجی پرگو (verbose).
--remap-path-prefix from=to: بازنگاشت پیشوندهای مسیر مبدا در تمام خروجی‌ها، شامل خطایابی‌های کامپایلر، اطلاعات اشکال‌زدایی، گسترش ماکروها و غیره. پارامتر from=to از راست به چپ بررسی می‌شود، بنابراین from می‌تواند شامل '=' باشد، اما to نمی‌تواند.
این گزینه برای نرمال‌سازی نتایج ساخت مفید است، به عنوان مثال با حذف دایرکتوری جاری از نام مسیرهای ثبت‌شده در فایل‌های شیء (object). جایگزینی صرفاً متنی است و نحو نام مسیر سیستم جاری در نظر گرفته نمی‌شود. برای مثال --remap-path-prefix foo=bar با foo/lib.rs مطابقت دارد اما با ./foo/lib.rs تطابق نخواهد داشت.
--extern NAME=PATH: مشخص کردن محل یک کتابخانه خارجی Rust. این موارد باید با اعلان‌های extern در کد منبع crate مطابقت داشته باشند.
--sysroot PATH: بازنویسی ریشه سیستم (system root).
-Z FLAG: تنظیم گزینه‌های ناپایدار (unstable) یا دائماً ناپایدار (perma-unstable). برای چاپ گزینه‌های موجود از -Z help استفاده کنید.
--color auto|always|never: پیکربندی رنگ‌آمیزی خروجی:

auto: رنگی کردن خروجی در صورتی که به یک tty ارسال شود (پیش‌فرض)؛
always: رنگی کردن همیشگی خروجی؛
never: عدم رنگ‌آمیزی خروجی در هیچ حالتی.
linker=/path/to/cc: مسیر ابزار پیونددهنده (linker) برای استفاده هنگام پیوند دادن کتابخانه‌ها، فایل‌های اجرایی، و فایل‌های شیء (objects).
link-args='-flag1 -flag2': فهرستی از آرگومان‌های اضافی جداشده با فاصله برای ارسال به پیونددهنده هنگام فراخوانی آن.
lto: انجام بهینه‌سازی‌های زمان پیوند (LTO) با LLVM.
target-cpu=help: پردازندهٔ مقصد را انتخاب می‌کند. اگر مقدار برابر با 'help' باشد، فهرستی از پردازنده‌های در دسترس چاپ می‌شود.
target-feature='+feature1,-feature2': فهرستی از ویژگی‌های جداشده با کاما برای فعال یا غیرفعال کردن در مقصد. علامت '+' در ابتدا یک ویژگی را فعال و علامت '-' آن را غیرفعال می‌کند. ویژگی‌های موجود را می‌توان با دستور llc -mcpu=help پیدا کرد.
passes=val: فهرستی از گذرهای (passes) اضافی LLVM جداشده با فاصله برای اجرا. مقدار 'list' باعث می‌شود rustc تمام گذرهای شناخته‌شده را چاپ کرده و خارج شود. گذرهای مشخص‌شده به انتهای مدیر گذرهای عادی اضافه می‌شوند.
llvm-args='-arg1 -arg2': فهرستی از آرگومان‌های جداشده با فاصله برای ارسال مستقیم به LLVM.
save-temps: در صورت تعیین، کامپایلر فایل‌های بیشتری (.bc، .o، .no-opt.bc) را که در طول کامپایل تولید می‌شوند در دایرکتوری خروجی ذخیره خواهد کرد.
rpath: در صورت تعیین، مقدار rpath برای کتابخانه‌های پویا در خروجی‌های کتابخانهٔ پویا یا فایل اجرایی تنظیم می‌شود.
no-prepopulate-passes: از مقداردهی اولیه و پیش‌بارگذاری مدیر گذرهای LLVM که روی ماژول اجرا می‌شود، جلوگیری می‌کند.
no-vectorize-loops: صرف‌نظر از سطح بهینه‌سازی، اجرای گذر برداری‌سازی حلقه‌های LLVM را غیرفعال می‌کند.
no-vectorize-slp: صرف‌نظر از سطح بهینه‌سازی، اجرای گذر برداری‌سازی SLP در LLVM را غیرفعال می‌کند.
soft-float: به جای دستورالعمل‌های سخت‌افزاری، فراخوانی‌های کتابخانه‌ای ممیز شناور نرم‌افزاری تولید می‌کند.
prefer-dynamic: پیوند پویا را به پیوند ایستا ترجیح می‌دهد.
no-integrated-as: استفاده از یک اسمبلر خارجی به جای اسمبلر یکپارچهٔ داخلی LLVM را اجباری می‌کند.
no-redzone: استفاده از ناحیهٔ محافظت‌شدهٔ پشته (redzone) را غیرفعال می‌کند.
relocation-model=[pic,static,dynamic-no-pic]: مدل بازنشانی (relocation) مورد استفاده. (پیش‌فرض: pic)
code-model=[small,kernel,medium,large]: مدل کد مورد استفاده را انتخاب می‌کند.
metadata=val: متاداده برای درهم‌ریزی نام نمادها (symbol name mangling).
extra-filename=val: داده‌های اضافی برای درج در نام هر فایل خروجی.
codegen-units=n: کریت (crate) را به n واحد تقسیم می‌کند تا به صورت موازی بهینه‌سازی شوند.
remark=val: چاپ ملاحظات و گزارش‌ها برای این گذرهای بهینه‌سازی (جداشده با فاصله، یا "all").
no-stack-check: بررسی‌های مربوط به سرریز پشته را غیرفعال می‌کند (یک مخاطرهٔ جدی برای ایمنی حافظه!).
debuginfo=val: سطح انتشار اطلاعات اشکال‌زدایی:

0: بدون اطلاعات اشکال‌زدایی؛
1: فقط جدول خطوط کد (برای ردگیری پشته و نقاط توقف)؛
2: اطلاعات اشکال‌زدایی کامل همراه با اطلاعات متغیرها و نوع‌ها.

opt-level=VAL: بهینه‌سازی با سطوح ممکن 0–3، s (بهینه‌سازی برای اندازه)، یا z (برای کمترین اندازهٔ ممکن).SH "محیط (ENVIRONMENT)"
برخی از این متغیرها تنها بر برنامه‌های بستر آزمون (ایجادشده از طریق rustc --test) اثر می‌گذارند؛ سایر متغیرها بر تمام برنامه‌هایی که با کتابخانه استاندارد Rust پیوند می‌خورند تأثیرگذارند.
RUST_TEST_THREADS: چارچوب آزمونی که Rust ارائه می‌دهد، آزمون‌ها را به‌صورت موازی اجرا می‌کند. این متغیر حداکثر تعداد رشته‌های مورد استفاده برای این منظور را مشخص می‌کند. این تنظیم توسط گزینه --test-threads بازنویسی می‌شود.
RUST_TEST_NOCAPTURE: اگر روی مقداری غیر از "0" تنظیم شود، مترادفی برای پرچم --nocapture است.
RUST_MIN_STACK: حداقل اندازه پشته (stack) را برای رشته‌های جدید تعیین می‌کند.
RUST_BACKTRACE: اگر روی مقداری غیر از "0" تنظیم شود، در خروجی برنامه‌ای که دچار panic می‌شود یک backtrace تولید می‌کند.

مثال‌ها (EXAMPLES)

برای ساخت یک فایل اجرایی از یک فایل منبع با تابع main:
$ rustc -o hello hello.rs

برای ساخت یک کتابخانه از یک فایل منبع:
$ rustc --crate-type=lib hello-lib.rs

برای ساخت هر یک با یک فایل crate (.rs):
$ rustc hello.rs

برای ساخت یک فایل اجرایی همراه با اطلاعات اشکال‌زدایی:
$ rustc -g -o hello hello.rs

همچنین ببینید (SEE ALSO)

rustdoc(1)

گزارش باگ‌ها (BUGS)

برای مشاهده و گزارش باگ‌ها به https://github.com/rust-lang/rust/issues مراجعه کنید.

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

صفحه https://github.com/rust-lang/rust/graphs/contributors را ببینید یا از دستور `git log --all --format='%cN <%cE>' | sort -u` در توزیع منبع rust استفاده کنید.

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

این اثر دارای مجوز دوگانه تحت شرایط Apache 2.0 و MIT است. فایل COPYRIGHT را در توزیع منبع rust مشاهده کنید.