ELIXIR(1)                   General Commands Manual                  ELIXIR(1)

نام (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

Linux 6.12.107+deb13-amd64     February 3, 2019     Linux 6.12.107+deb13-amd64