نام (NAME)

elixir — اجراکننده اسکریپت‌های الیکسیر

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

elixir [OPTIONS] file ...

توضیحات (DESCRIPTION)

این برنامه سیستم زمان اجرا را معمولاً برای اجرای یک یا چند اسکریپت راه‌اندازی می‌کند. این ابزار شبیه به iex(1), است، اما elixir هنگامی که اسکریپت اجراشده به پایان می‌رسد، خارج می‌شود.

گزینه‌ها (OPTIONS)

توجه داشته باشید که بسیاری از گزینه‌های ذکرشده در اینجا از پوسته ارلنگ وام گرفته شده‌اند، بنابراین erl(1) می‌تواند به عنوان منبع اطلاعاتی اضافی برای این گزینه‌ها استفاده شود.

-h, --help

پیام راهنما را در خطای استاندارد (stderr) نمایش می‌دهد و خارج می‌شود.

-v, --version

نسخه الیکسیر را در خروجی استاندارد (stdout) نمایش می‌دهد و خارج می‌شود.

-e, --eval expression

عبارت مشخص‌شده را ارزیابی می‌کند (گزینه --rpc-eval را ببینید).

-r file

فایل مشخص‌شده را الزام (require) می‌کند. به عبارت دیگر، وجود فایل در هنگام شروع elixir بررسی می‌شود.

-S script

اسکریپت مشخص‌شده را اجرا می‌کند.

-pa directory

دایرکتوری مشخص‌شده را به ابتدای مسیر کد اضافه می‌کند. اگر دایرکتوری از قبل وجود داشته باشد، از موقعیت قبلی خود حذف شده و در ابتدا قرار می‌گیرد.

تابع Code.prepend_path/1 را نیز ببینید.

-pr file

همان کار -r (در بالا را ببینید) را انجام می‌دهد اما به صورت موازی.

-pz directory

دایرکتوری مشخص‌شده را به انتهای مسیر کد اضافه می‌کند. اگر دایرکتوری از قبل وجود داشته باشد، نه از موقعیت قبلی خود حذف می‌شود و نه در انتها قرار می‌گیرد.

تابع Code.append_path/1 را نیز ببینید.

--app application

برنامه کاربردی مشخص‌شده و تمامی وابستگی‌های آن را راه‌اندازی می‌کند.

--boot file

نام فایل بوت، file.boot، را مشخص می‌کند که برای راه‌اندازی سیستم استفاده می‌شود. مگر اینکه File حاوی یک مسیر مطلق باشد، سیستم به دنبال file.boot در دایرکتوری جاری و دایرکتوری $ROOT/bin می‌گردد.

مقدار پیش‌فرض $ROOT/bin/start.boot است.

این گزینه معادل -boot در ارلنگ است.

--boot-var var dir

اگر اسکریپت بوت حاوی یک متغیر مسیر var غیر از $ROOT باشد، این متغیر به dir بسط می‌یابد. زمانی استفاده می‌شود که برنامه‌ها در دایرکتوری دیگری غیر از $ROOT/lib نصب شده باشند.

این گزینه معادل -boot_var در ارلنگ است.

تابع :systools.make_script/1,2 در SASL را نیز ببینید.

--erl parameters

همان هدف ELIXIR_ERL_OPTIONS را برآورده می‌کند (بخش ENVIRONMENT را ببینید)

--erl-config file

نام یک فایل پیکربندی، file.config، را مشخص می‌کند که برای پیکربندی برنامه‌ها استفاده می‌شود. توجه داشته باشید که فایل پیکربندی باید به زبان ارلنگ نوشته شده باشد.

این گزینه معادل -config در ارلنگ است.

--cookie value

مقدار کوکی جادویی (magic cookie) را مشخص می‌کند. اگر این مقدار هنگام راه‌اندازی گره از طریق گزینه مشخص نشده باشد، از فایل ~/.erlang.cookie خوانده می‌شود (بخش FILES را ببینید). گره‌های توزیع‌شده تنها زمانی می‌توانند با یکدیگر تعامل داشته باشند که کوکی‌های جادویی آن‌ها یکسان باشد.

تابع Node.set_cookie/2 را نیز ببینید.

--hidden

یک گره پنهان را راه‌اندازی می‌کند.

اتصالات بین گره‌ها متعدی (ترایا) هستند. به عنوان مثال، اگر گره A به گره B متصل باشد و گره B به گره C متصل باشد، آنگاه گره A به گره C متصل است. گزینه --hidden امکان ایجاد گره‌ای را فراهم می‌کند که می‌تواند به گره دیگری متصل شود بدون ایجاد اتصالات اضافی و زائد.

تابع Node.list/0 امکان دریافت فهرست گره‌های متصل به گره هدف را فراهم می‌کند؛ با این حال، این فهرست شامل گره‌های پنهان نخواهد بود. بسته به پارامتر ورودی، تابع Node.list/1 امکان دریافت فهرستی را فراهم می‌کند که تنها شامل گره‌های پنهان است (پارامتر :hidden) یا هر دو دسته گره‌های پنهان و غیرپنهان (پارامتر :connected).

--logger-otp-reports val

گزارش‌دهی OTP را فعال یا غیرفعال می‌کند (val می‌تواند true یا false باشد).

--logger-sasl-reports val

گزارش‌دهی SASL را فعال یا غیرفعال می‌کند (val می‌تواند true یا false باشد).

--sname name

یک نام کوتاه به گره اختصاص داده و آن را راه‌اندازی می‌کند. نام‌های کوتاه به شکل name@host هستند، که در آن host نام میزبان هدف است (hostname(1)) که گره را اجرا می‌کند. گره‌های با نام کوتاه تنها می‌توانند در همان شبکه محلی با یکدیگر تعامل داشته باشند.

--name name

یک نام بلند به گره اختصاص داده و آن را راه‌اندازی می‌کند. نام‌های بلند به شکل name@host هستند، که در آن host آدرس IP میزبانی است که گره را اجرا می‌کند. برخلاف گره‌های با نام کوتاه، گره‌های با نام بلند محدود به مرزهای یک شبکه محلی نیستند (در بالا را ببینید).

--pipe-to pipedir logdir

ماشین مجازی ارلنگ را به صورت یک لوله نام‌گذاری‌شده در pipedir و logdir راه‌اندازی می‌کند (تنها برای سیستم‌عامل‌های شبه‌یونیکس).

--rpc-eval node expression

عبارت مشخص‌شده را روی گره مشخص‌شده ارزیابی می‌کند (گزینه --eval را ببینید).

--vm-args file

آرگومان‌های خط فرمان را از file می‌خواند و آن‌ها را به ماشین مجازی ارلنگ منتقل می‌کند.

این گزینه معادل -args_file در ارلنگ است.

--no-halt

ماشین مجازی ارلنگ را پس از اجرا متوقف نمی‌کند.

--

گزینه‌های ارائه‌شده به کامپایلر را از گزینه‌های ارائه‌شده به کد اجراشونده جدا می‌کند.

نکات (NOTES)

گزینه‌های زیر را می‌توان بیش از یک بار مشخص کرد: --boot-var, --erl-config, --eval, --rpc-eval.

محیط (ENVIRONMENT)

ELIXIR_ERL_OPTIONS

امکان ارسال پارامترها به زمان اجرای ارلنگ را فراهم می‌کند.

فایل‌ها (FILES)

~/.erlang.cookie

مقدار کوکی جادویی را ذخیره می‌کند که تنها زمانی استفاده می‌شود که از طریق گزینه --cookie مشخص نشده باشد (در بالا را ببینید). اگر هنگام راه‌اندازی گره این فایل وجود نداشته باشد، ایجاد خواهد شد.

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

elixirc(1), iex(1), mix(1)

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

تیم الیکسیر مسئول نگهداری الیکسیر است.

 

این صفحه راهنما توسط Evgeny Golyshev ایجاد شده است.

 

Copyright (c) 2012 Plataformatec.

 

Copyright (c) 2021 The Elixir Team.

 

منابع اینترنتی (INTERNET RESOURCES)

وب‌سایت اصلی: https://elixir-lang.org

 

مستندات: https://elixir-lang.org/docs.html

 

مدیر بسته: https://hex.pm