.nh
.TH toolbox-init-container 1
.SH "نام (NAME)"
toolbox-init-container \- راه‌اندازی یک کانتینر در حال اجرا

.SH "خلاصه دستور (SYNOPSIS)"
\fBtoolbox init-container\fP \fI--gid GID\fP
                       \fI--home HOME\fP
                       \fI--home-link\fP
                       \fI--media-link\fP
                       \fI--mnt-link\fP
                       \fI--shell SHELL\fP
                       \fI--uid UID\fP
                       \fI--user USER\fP

.SH "توضیحات (DESCRIPTION)"
یک کانتینر تازه ایجادشده که در حال اجرا است را مقداردهی اولیه (راه‌اندازی) می‌کند. هدف اصلی این دستور استفاده به عنوان نقطه ورود (entry point) برای تمام کانتینرهای Toolbx است و باید داخل کانتینری که قرار است راه‌اندازی شود اجرا گردد. انتظار نمی‌رود این دستور مستقیماً توسط کاربران فراخوانی شود و نمی‌توان آن را روی میزبان استفاده کرد.

.PP
یک ویژگی کلیدی کانتینرهای Toolbx، نقطه ورود آن‌ها یعنی دستور \fBtoolbox init-container\fR است.

.PP
کانتینرهای OCI ذاتاً تغییرناپذیرند. گزینه‌های پیکربندی که از طریق \fBpodman create\fR فرستاده می‌شوند، در تعریف کانتینر OCI تثبیت شده و بعداً قابل تغییر نیستند. این بدان معناست که تغییرات و بهبودهای اعمال‌شده در نسخه‌های جدیدتر Toolbx را نمی‌توان روی کانتینرهای از پیش‌موجود Toolbx که با نسخه‌های قدیمی‌تر ساخته شده‌اند اعمال کرد. برای جلوگیری از این مشکل، از نقطه ورود برای پیکربندی کانتینر در زمان اجرا (runtime) استفاده می‌شود.

.PP
نقطه ورود یک کانتینر Toolbx، کانتینر را سفارشی‌سازی می‌کند تا با کاربر فعلی سازگار شود؛ این کار از طریق اطمینان از وجود کاربری منطبق با کاربر میزبان و اعطای دسترسی‌های \fBsudo\fR و \fBroot\fR به آن انجام می‌شود.

.PP
فایل‌های پیکربندی حیاتی درون کانتینر، مانند \fB/etc/host.conf\fR، \fB/etc/hosts\fR، \fB/etc/localtime\fR، \fB/etc/resolv.conf\fR و \fB/etc/timezone\fR همواره با سیستم میزبان همگام نگه داشته می‌شوند. همچنین نقطه ورود، بخش‌های مختلفی از سلسله‌مراتب سیستم فایل میزبان را به مکان‌های متناظرشان در داخل کانتینر متصل (bind mount) می‌کند تا یکپارچگی کاملی با میزبان فراهم شود. این بخش‌ها شامل \fB/run/libvirt\fR، \fB/run/systemd/journal\fR، \fB/run/udev/data\fR، \fB/var/lib/libvirt\fR، \fB/var/lib/systemd/coredump\fR، \fB/var/log/journal\fR و موارد دیگر می‌شود.

.PP
در برخی از سیستم‌عامل‌های میزبان، مسیرهای مهمی مانند \fB/home\fR، \fB/media\fR یا \fB/mnt\fR پیوندهای نمادین (symbolic links) به مکان‌های دیگر هستند. نقطه ورود تضمین می‌کند که مسیرهای درون کانتینر با مسیرهای روی میزبان مطابقت داشته باشند تا از سردرگمی‌های بیهوده جلوگیری شود.

.SH "گزینه‌ها (OPTIONS)"
گزینه‌های زیر پشتیبانی می‌شوند:

.PP
\fB--gid\fP GID

.PP
مقدار GID را به عنوان شناسه عددی گروه کاربر از سیستم میزبان به کانتینر Toolbx ارسال می‌کند.

.PP
\fB--home\fP HOME

.PP
کاربری در داخل کانتینر Toolbx ایجاد می‌کند که دایرکتوری ورود آن HOME است. این گزینه الزامی است.

.PP
\fB--home-link\fP

.PP
مسیر \fB/home\fR را به یک پیوند نمادین به \fB/var/home\fR\& تبدیل می‌کند.

.PP
\fB--media-link\fP

.PP
مسیر \fB/media\fR را به یک پیوند نمادین به \fB/run/media\fR\& تبدیل می‌کند.

.PP
\fB--mnt-link\fP

.PP
مسیر \fB/mnt\fR را به یک پیوند نمادین به \fB/var/mnt\fR\& تبدیل می‌کند.

.PP
\fB--monitor-host\fP

.PP
منسوخ شده و هیچ کاری انجام نمی‌دهد.

.PP
فایل‌های پیکربندی حیاتی داخل کانتینر Toolbx همواره با معادل‌های خود در سیستم میزبان همگام نگه داشته می‌شوند، و بخش‌های مختلفی از سلسله‌مراتب سیستم فایل میزبان همواره در مکان‌های متناظر خود درون کانتینر Toolbx متصل (bind mount) می‌گردند.

.PP
\fB--shell\fP SHELL

.PP
کاربری در داخل کانتینر Toolbx ایجاد می‌کند که شل ورود (login shell) آن SHELL است. این گزینه الزامی است.

.PP
\fB--uid\fP UID

.PP
کاربری در داخل کانتینر Toolbx ایجاد می‌کند که شناسه عددی کاربری آن UID است. این گزینه الزامی است.

.PP
\fB--user\fP USER

.PP
کاربری در داخل کانتینر Toolbx ایجاد می‌کند که نام ورود آن LOGIN است. این گزینه الزامی است.

.SH "همچنین ببینید (SEE ALSO)"
\fBtoolbox(1)\fR, \fBpodman(1)\fR, \fBpodman-create(1)\fR, \fBpodman-start(1)\fR