.\" SPDX-License-Identifier: Apache-2.0
.\" SPDX-FileCopyrightText: 2021 The Elixir Team
.\" SPDX-FileCopyrightText: 2012 Plataformatec
.Dd February 3, 2019
.Dt ELIXIR 1
.Os
.Sh "نام (NAME)"
.Nm elixir
.Nd اجراکننده اسکریپت‌های الیکسیر
.Sh "خلاصه دستور (SYNOPSIS)"
.Nm
.Op Ar OPTIONS
.Ar
.Sh "توضیحات (DESCRIPTION)"
این برنامه سیستم زمان اجرا را معمولاً برای اجرای یک یا چند اسکریپت راه‌اندازی می‌کند. این ابزار شبیه به
.Xr iex 1 ,
است، اما
.Nm
هنگامی که اسکریپت اجراشده به پایان می‌رسد، خارج می‌شود.
.Sh "گزینه‌ها (OPTIONS)"
توجه داشته باشید که بسیاری از گزینه‌های ذکرشده در اینجا از پوسته ارلنگ وام گرفته شده‌اند، بنابراین
.Xr erl 1
می‌تواند به عنوان منبع اطلاعاتی اضافی برای این گزینه‌ها استفاده شود.
.Bl -tag -width Ds
.\" SPDX-License-Identifier: Apache-2.0
.\" SPDX-FileCopyrightText: 2021 The Elixir Team
.\" SPDX-FileCopyrightText: 2012 Plataformatec
.It Fl h , -help
پیام راهنما را در خطای استاندارد (stderr) نمایش می‌دهد و خارج می‌شود.
.It Fl v , -version
نسخه الیکسیر را در خروجی استاندارد (stdout) نمایش می‌دهد و خارج می‌شود.
.It Fl e , -eval Ar expression
عبارت مشخص‌شده را ارزیابی می‌کند
.Pq گزینه Fl -rpc-eval No را ببینید .
.It Fl r Ar file
فایل مشخص‌شده را الزام (require) می‌کند. به عبارت دیگر، وجود فایل در هنگام شروع
.Nm
بررسی می‌شود.
.It Fl S Ar script
اسکریپت مشخص‌شده را اجرا می‌کند.
.It Fl pa Ar directory
دایرکتوری مشخص‌شده را به ابتدای مسیر کد اضافه می‌کند. اگر دایرکتوری از قبل وجود داشته باشد، از موقعیت قبلی خود حذف شده و در ابتدا قرار می‌گیرد.
.Pp
تابع
.Sy Code.prepend_path/1
را نیز ببینید.
.It Fl pr Ar file
همان کار
.Fl r
.Pq در بالا را ببینید
را انجام می‌دهد اما به صورت موازی.
.It Fl pz Ar directory
دایرکتوری مشخص‌شده را به انتهای مسیر کد اضافه می‌کند. اگر دایرکتوری از قبل وجود داشته باشد، نه از موقعیت قبلی خود حذف می‌شود و نه در انتها قرار می‌گیرد.
.Pp
تابع
.Sy Code.append_path/1
را نیز ببینید.
.It Fl -app Ar application
برنامه کاربردی مشخص‌شده و تمامی وابستگی‌های آن را راه‌اندازی می‌کند.
.It Fl -boot Ar file
نام فایل بوت،
.Ar file Ns .boot،
را مشخص می‌کند که برای راه‌اندازی سیستم استفاده می‌شود. مگر اینکه File حاوی یک مسیر مطلق باشد، سیستم به دنبال
.Ar file Ns .boot
در دایرکتوری جاری و دایرکتوری $ROOT/bin می‌گردد.
.Pp
مقدار پیش‌فرض $ROOT/bin/start.boot است.
.Pp
این گزینه معادل
.Fl boot
در ارلنگ است.
.It Fl -boot-var Ar var Ar dir
اگر اسکریپت بوت حاوی یک متغیر مسیر
.Ar var
غیر از $ROOT باشد، این متغیر به
.Ar dir
بسط می‌یابد. زمانی استفاده می‌شود که برنامه‌ها در دایرکتوری دیگری غیر از $ROOT/lib نصب شده باشند.
.Pp
این گزینه معادل
.Fl boot_var
در ارلنگ است.
.Pp
تابع
.Sy :systools.make_script/1,2 No در SASL
را نیز ببینید.
.It Fl -erl Ar parameters
همان هدف ELIXIR_ERL_OPTIONS را برآورده می‌کند
.Pq بخش Sy ENVIRONMENT No را ببینید
.It Fl -erl-config Ar file
نام یک فایل پیکربندی،
.Ar file Ns .config،
را مشخص می‌کند که برای پیکربندی برنامه‌ها استفاده می‌شود. توجه داشته باشید که فایل پیکربندی باید به زبان ارلنگ نوشته شده باشد.
.Pp
این گزینه معادل
.Fl config
در ارلنگ است.
.It Fl -cookie Ar value
مقدار کوکی جادویی (magic cookie) را مشخص می‌کند. اگر این مقدار هنگام راه‌اندازی گره از طریق گزینه مشخص نشده باشد، از فایل
.Pa ~/.erlang.cookie
خوانده می‌شود
.Pq بخش Sy FILES No را ببینید .
گره‌های توزیع‌شده تنها زمانی می‌توانند با یکدیگر تعامل داشته باشند که کوکی‌های جادویی آن‌ها یکسان باشد.
.Pp
تابع
.Sy Node.set_cookie/2
را نیز ببینید.
.It Fl -hidden
یک گره پنهان را راه‌اندازی می‌کند.
.Pp
اتصالات بین گره‌ها متعدی (ترایا) هستند. به عنوان مثال، اگر گره A به گره B متصل باشد و گره B به گره C متصل باشد، آنگاه گره A به گره C متصل است. گزینه
.Fl -hidden
امکان ایجاد گره‌ای را فراهم می‌کند که می‌تواند به گره دیگری متصل شود بدون ایجاد اتصالات اضافی و زائد.
.Pp
تابع
.Sy Node.list/0
امکان دریافت فهرست گره‌های متصل به گره هدف را فراهم می‌کند؛ با این حال، این فهرست شامل گره‌های پنهان نخواهد بود. بسته به پارامتر ورودی، تابع
.Sy Node.list/1
امکان دریافت فهرستی را فراهم می‌کند که تنها شامل گره‌های پنهان است
.Pq پارامتر Ar :hidden
یا هر دو دسته گره‌های پنهان و غیرپنهان
.Pq پارامتر Ar :connected .
.It Fl -logger-otp-reports Ar val
گزارش‌دهی OTP را فعال یا غیرفعال می‌کند
.Pq Ar val No می‌تواند true یا false باشد .
.It Fl -logger-sasl-reports Ar val
گزارش‌دهی SASL را فعال یا غیرفعال می‌کند
.Pq Ar val No می‌تواند true یا false باشد .
.It Fl -sname Ar name
یک نام کوتاه به گره اختصاص داده و آن را راه‌اندازی می‌کند. نام‌های کوتاه به شکل
.Ar name Ns
@host هستند، که در آن host نام میزبان هدف است
.Pq Xr hostname 1
که گره را اجرا می‌کند. گره‌های با نام کوتاه تنها می‌توانند در همان شبکه محلی با یکدیگر تعامل داشته باشند.
.It Fl -name Ar name
یک نام بلند به گره اختصاص داده و آن را راه‌اندازی می‌کند. نام‌های بلند به شکل
.Ar name Ns
@host هستند، که در آن host آدرس IP میزبانی است که گره را اجرا می‌کند. برخلاف گره‌های با نام کوتاه، گره‌های با نام بلند محدود به مرزهای یک شبکه محلی نیستند
.Pq در بالا را ببینید .
.It Fl -pipe-to Ar pipedir Ar logdir
ماشین مجازی ارلنگ را به صورت یک لوله نام‌گذاری‌شده در
.Ar pipedir
و
.Ar logdir
راه‌اندازی می‌کند
.Pq تنها برای سیستم‌عامل‌های شبه‌یونیکس .
.It Fl -rpc-eval Ar node Ar expression
عبارت مشخص‌شده را روی گره مشخص‌شده ارزیابی می‌کند
.Pq گزینه Fl -eval No را ببینید .
.It Fl -vm-args Ar file
آرگومان‌های خط فرمان را از
.Ar file
می‌خواند و آن‌ها را به ماشین مجازی ارلنگ منتقل می‌کند.
.Pp
این گزینه معادل
.Fl args_file
در ارلنگ است.
.It Fl -no-halt
ماشین مجازی ارلنگ را پس از اجرا متوقف نمی‌کند.
.It Fl -
گزینه‌های ارائه‌شده به کامپایلر را از گزینه‌های ارائه‌شده به کد اجراشونده جدا می‌کند.
.El
.Sh "نکات (NOTES)"
گزینه‌های زیر را می‌توان بیش از یک بار مشخص کرد:
.Fl -boot-var Ns , Fl -erl-config Ns , Fl -eval Ns , Fl -rpc-eval Ns .
.Sh "محیط (ENVIRONMENT)"
.Bl -tag -width Ds
.It Ev ELIXIR_ERL_OPTIONS
امکان ارسال پارامترها به زمان اجرای ارلنگ را فراهم می‌کند.
.El
.Sh "فایل‌ها (FILES)"
.Bl -tag -width Ds
.It Pa ~/.erlang.cookie
مقدار کوکی جادویی را ذخیره می‌کند که تنها زمانی استفاده می‌شود که از طریق گزینه
.Fl -cookie
مشخص نشده باشد
.Pq در بالا را ببینید .
اگر هنگام راه‌اندازی گره این فایل وجود نداشته باشد، ایجاد خواهد شد.
.El
.Sh "همچنین ببینید (SEE ALSO)"
.Xr elixirc 1 ,
.Xr iex 1 ,
.Xr mix 1
.Sh "نویسندگان (AUTHORS)"
.Bl -tag -width Ds
.It تیم الیکسیر مسئول نگهداری الیکسیر است.
.It این صفحه راهنما توسط Evgeny Golyshev ایجاد شده است.
.It Copyright (c) 2012 Plataformatec.
.It Copyright (c) 2021 The Elixir Team.
.El
.Sh "منابع اینترنتی (INTERNET RESOURCES)"
.Bl -tag -width Ds
.It وب‌سایت اصلی: https://elixir-lang.org
.It مستندات: https://elixir-lang.org/docs.html
.It مدیر بسته: https://hex.pm
.El