.\" SPDX-License-Identifier: Apache-2.0
.\" SPDX-FileCopyrightText: 2021 The Elixir Team
.\" SPDX-FileCopyrightText: 2012 Plataformatec
.Dd February 3, 2019
.Dt IEX 1
.Os
.Sh "نام (NAME)"
.Nm iex
.Nd پوسته تعاملی Elixir
.Sh "خلاصه دستور (SYNOPSIS)"
.Nm
.Op Ar OPTIONS
.Sh "توضیحات (DESCRIPTION)"
پوسته تعاملی برای ارزیابی، اشکال‌زدایی و درون‌نگری (introspection) سامانه زمان اجرای Elixir به کار می‌رود. همچنین می‌توان از این برنامه برای آزمایش عملکرد قطعه‌کدهای کوچک، بدون نیاز به ذخیره کردن کد در یک فایل، استفاده کرد.
.Sh "گزینه‌ها (OPTIONS)"
توجه داشته باشید که بسیاری از گزینه‌های ذکر شده در اینجا از پوسته Erlang به امانت گرفته شده‌اند، بنابراین
.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
نسخه Elixir را در خروجی استاندارد (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
دایرکتوری مشخص‌شده را به ابتدای مسیر کد (code path) اضافه می‌کند. اگر دایرکتوری از قبل وجود داشته باشد، از جایگاه قبلی خود حذف شده و در ابتدا قرار می‌گیرد.
.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
برنامه (application) مشخص‌شده و تمام وابستگی‌های آن را راه‌اندازی می‌کند.
.It Fl -boot Ar file
نام فایل بوت،
.Ar file Ns .boot
را که برای راه‌اندازی سامانه استفاده می‌شود، مشخص می‌کند. مگر اینکه
.Ar file
شامل یک مسیر مطلق باشد، سامانه به دنبال
.Ar file Ns .boot
در دایرکتوری جاری و دایرکتوری‌های $ROOT/bin می‌گردد.
.Pp
پیش‌فرض $ROOT/bin/start.boot است.
.Pp
این گزینه معادل
.Fl boot
در Erlang است.
.It Fl -boot-var Ar var Ar dir
اگر اسکریپت بوت شامل یک متغیر مسیر
.Ar var
به جز $ROOT باشد، این متغیر به
.Ar dir
بسط می‌یابد. زمانی استفاده می‌شود که برنامه‌ها در دایرکتوری دیگری غیر از $ROOT/lib نصب شده باشند.
.Pp
این گزینه معادل
.Fl boot_var
در Erlang است.
.Pp
همچنین تابع
.Sy :systools.make_script/1,2 No در SASL
را ببینید.
.It Fl -erl Ar parameters
همان کاربرد
.Ev ELIXIR_ERL_OPTIONS
را ارائه می‌دهد
.Pq بخش Sy "محیط (ENVIRONMENT)" No را ببینید .
.It Fl -erl-config Ar file
نام یک فایل پیکربندی،
.Ar file Ns .config
را مشخص می‌کند که برای پیکربندی برنامه‌ها به کار می‌رود. توجه داشته باشید که فایل پیکربندی باید به زبان Erlang نوشته شده باشد.
.Pp
این گزینه معادل
.Fl config
در Erlang است.
.It Fl -cookie Ar value
مقدار مجیک کوکی (magic cookie) را مشخص می‌کند. اگر هنگام شروع به کار گره این مقدار از طریق گزینه مشخص نشده باشد، از فایل
.Pa ~/.erlang.cookie
خوانده خواهد شد
.Pq بخش Sy "فایل‌ها (FILES)" No را ببینید .
گره‌های توزیع‌شده تنها زمانی می‌توانند با یکدیگر تعامل داشته باشند که مجیک کوکی‌های یکسانی داشته باشند.
.Pp
همچنین تابع
.Sy Node.set_cookie/2
را ببینید.
.It Fl -hidden
یک گره پنهان (hidden node) را راه‌اندازی می‌کند.
.Pp
اتصالات میان گره‌ها متعدی (transitive) هستند. برای مثال، اگر گره 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
ماشین مجازی Erlang را با یک
.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
می‌خواند و آن‌ها را به ماشین مجازی Erlang ارسال می‌کند.
.Pp
این گزینه معادل
.Fl args_file
در Erlang است.
.It Fl -dot-iex Ar file
فایل مشخص‌شده را به جای
.Pa .iex.exs
بارگذاری می‌کند
.Pq بخش Sy "فایل‌ها (FILES)" No را ببینید .
.It Fl -remsh Ar node
به گره مشخص‌شده‌ای که با گزینه‌های
.Fl -sname
یا
.Fl -name
راه‌اندازی شده است متصل می‌شود
.Pq بالا را ببینید .
.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
امکان ارسال پارامترها به زمان اجرای Erlang را فراهم می‌کند.
.El
.Sh "فایل‌ها (FILES)"
.Bl -tag -width Ds
.It Pa ~/.erlang.cookie
مقدار مجیک کوکی را ذخیره می‌کند که تنها در صورتی استفاده می‌شود که از طریق گزینه
.Fl -cookie
مشخص نشده باشد
.Pq بالا را ببینید .
اگر هنگام راه‌اندازی گره این فایل وجود نداشته باشد، ایجاد خواهد شد.
.It Pa .iex.exs
پس از شروع به کار
.Nm Ns ،
به دنبال فایل
.Pa .iex.exs
می‌گردد و در صورت یافتن، کد موجود در فایل را در زمینه (context) پوسته اجرا می‌کند. در ابتدا جستجو در دایرکتوری کاری جاری آغاز می‌شود؛ سپس در صورت نیاز، در دایرکتوری خانگی (home) ادامه می‌یابد.
.El
.Sh "همچنین ببینید (SEE ALSO)"
.Xr elixir 1 ,
.Xr elixirc 1 ,
.Xr mix 1
.Sh "نویسندگان (AUTHORS)"
.Bl -tag -width Ds
.It Elixir توسط The Elixir Team نگهداری می‌شود.
.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
.El