.TH start_erl 1 "erts 17.0.6" "Ericsson AB" "Erlang Module Definition"
.SH "نام (NAME)"
start_erl \- راه‌اندازی ارلنگ برای سامانه‌های تعبیه‌شده در سیستم‌های ویندوز
.SH "توضیحات (DESCRIPTION)"
.PP
برنامه \fIstart_erl\fR مخصوص Windows NT/2000/XP (و نسخه‌های بعدی ویندوز) است. با اینکه برنامه‌هایی با همین نام روی سایر پلتفرم‌ها نیز وجود دارند، عملکرد آن‌ها متفاوت است.

.PP
این برنامه هم به صورت کامپایل‌شده (در مسیر \fI<Erlang root>\\erts-<version>\\bin\fR) و هم به صورت کد منبع (در مسیر \fI<Erlang root>\\erts-<version>\\src\fR) توزیع می‌شود. هدف از ارائه کد منبع، تسهیل سفارشی‌سازی برنامه برای نیازهای محلی، مانند تشخیص راه‌اندازی مجدد چرخه‌ای است. همچنین یک "make-file" وجود دارد که برای برنامه \fInmake\fR (عرضه‌شده همراه با Microsoft Visual C++) نوشته شده است. با این حال، این برنامه را می‌توان با هر کامپایلر C مخصوص Win32 (احتمالاً با اعمال تغییرات جزئی) کامپایل کرد.

.PP
این برنامه به مدیریت انتشارها (Release Handling) در سیستم‌های ویندوز کمک می‌کند. این برنامه توسط برنامه \fIerlsrv\fR فراخوانی می‌شود، فایل داده‌های انتشار یعنی \fIstart_erl.data\fR را می‌خواند و ارلنگ را راه‌اندازی می‌کند. برخی از گزینه‌های \fIstart_erl\fR در طول ارتقا همراه با راه‌اندازی مجدد شبیه‌ساز، توسط مدیر انتشار اضافه و حذف می‌شوند (به‌طور خاص گزینه \fI\-data\fR).

.IP
.nf
start_erl [<erl options>] ++ [<start_erl options>]
.fi

.PP
برنامه \fIstart_erl\fR در شکل اصلی خود گزینه‌های زیر را تشخیص می‌دهد:

++
.RS 2
اجباری. گزینه‌های \fIstart_erl\fR را از گزینه‌های عادی ارلنگ جدا می‌کند. هر آنچه در خط فرمان \fIقبل\fR از \fI++\fR قرار گیرد، به عنوان گزینه‌های ارسالی به برنامه \fIerl\fR تفسیر می‌شود. هر آنچه \fIبعد\fR از \fI++\fR بیاید، به عنوان گزینه‌های خود \fIstart_erl\fR تفسیر خواهد شد.

.RE

\-reldir <release root>
.RS 2
در صورتی که متغیر محیطی \fIRELDIR\fR و گزینه \fI\-rootdir\fR مشخص نشده باشند، اجباری است. به \fIstart_erl\fR اعلام می‌کند که ریشه درخت انتشار در کجای فایل‌سیستم قرار دارد (معمولاً \fI<Erlang root>\\releases\fR). انتظار می‌رود فایل \fIstart_erl.data\fR در این دایرکتوری قرار داشته باشد (مگر اینکه به شکل دیگری تعیین شده باشد). اگر فقط گزینه \fI\-rootdir\fR مشخص شده باشد، این دایرکتوری \fI<Erlang root>\\releases\fR در نظر گرفته می‌شود.

.RE

\-rootdir <Erlang root directory>
.RS 2
در صورتی که \fI\-reldir\fR مشخص نشده باشد و متغیر \fIRELDIR\fR در محیط وجود نداشته باشد، اجباری است. این گزینه دایرکتوری ریشه نصب ارلنگ را مشخص می‌کند (دایرکتوری که پوشه‌های \fIlib\fR، \fIreleases\fR و \fIerts-<Version>\fR در آن قرار دارند). اگر تنها \fI\-reldir\fR (یا متغیر محیطی \fIRELDIR\fR) مشخص شده باشد، ریشه ارلنگ دقیقاً یک سطح بالاتر از دایرکتوری انتشار در نظر گرفته می‌شود.

.RE

\-data <data file name>
.RS 2
اختیاری. فایل داده‌ای غیر از \fIstart_erl.data\fR را در \fI<release root>\fR تعیین می‌کند. این مسیر می‌تواند نسبی نسبت به \fI<release root>\fR یا مطلق (شامل حرف درایو و غیره) باشد. این گزینه توسط مدیر انتشار در طول ارتقا استفاده می‌شود و نباید در عملکرد عادی به کار رود. در حالت عادی نیازی به تغییر نام فایل داده‌های انتشار نیست.

.RE

\-bootflags <boot flags file name>
.RS 2
اختیاری. نام فایلی را به صورت نسبی نسبت به دایرکتوری انتشار مشخص می‌کند (یعنی زیرپوشه‌ای از \fI<release root>\fR که فایل \fI.boot\fR و سایر فایل‌ها در آن قرار دارند). محتویات این فایل هنگام راه‌اندازی ارلنگ به خط فرمان ضمیمه می‌شود. این امر راه‌اندازی شبیه‌ساز با گزینه‌های مختلف برای نسخه‌های انتشار متفاوت را آسان می‌سازد.

.RE

.SH "نکات (NOTES)"

.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}.PP
از آنجا که کد منبع توزیع می‌شود، می‌توان به راحتی آن را برای پذیرش گزینه‌های دیگر تغییر داد. برنامه برای اینکه مدیر انتشار به درستی کار کند، همچنان باید گزینه \fI\-data\fR را با همان مفاهیم شرح‌داده‌شده در بالا بپذیرد.

.RE

.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}.PP
شبیه‌ساز ارلنگ با بررسی کلیدهای رجیستری برای نسخه شبیه‌ساز مشخص‌شده در فایل داده‌های انتشار پیدا می‌شود. شبیه‌ساز جدید باید قبل از ارتقا به درستی نصب شده باشد تا این فرآیند کار کند.

.RE

.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}.PP
اگرچه این برنامه در کنار فایل‌های مختص نسخه شبیه‌ساز قرار دارد، اما انتظار نمی‌رود که مختص یک نسخه خاص از شبیه‌ساز باشد. مدیر انتشار در طول راه‌اندازی مجدد شبیه‌ساز، گزینه \fI\-machine\fR را برای \fIerlsrv\fR تغییر \fIنمی‌دهد\fR. برنامه \fIstart_erl\fR (که احتمالاً سفارشی شده است) را در جایی قرار دهید که در هنگام ارتقا بازنویسی نشود.

.RE

.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}.PP
گزینه‌های پیش‌فرض برنامه \fIerlsrv\fR برای مدیریت انتشار کافی نیستند. ماشین راه‌اندازی‌شده توسط \fIerlsrv\fR باید به عنوان برنامه \fIstart_erl\fR تعیین شود و آرگومان‌ها باید شامل \fI++\fR و به دنبال آن گزینه‌های مورد نظر باشند.

.RE

.SH "همچنین ببینید (SEE ALSO)"

.PP
\fIerlsrv\fR, \fIrelease_handler\fR