'\" t
.nh
.TH toolbox 1
.SH "نام (NAME)"
toolbox \- ابزاری برای محیط‌های تعاملی خط فرمان در لینوکس

.SH "خلاصه دستور (SYNOPSIS)"
\fBtoolbox\fP [\fI--assumeyes\fP | \fI-y\fP]
        [\fI--help\fP | \fI-h\fP]
        [\fI--log-level LEVEL\fP]
        [\fI--log-podman\fP]
        [\fI--verbose\fP | \fI-v\fP]
        \fICOMMAND\fP [\fIARGS\fP\&...]

.SH "توضیحات (DESCRIPTION)"
Toolbx ابزاری برای لینوکس است که امکان استفاده از محیط‌های خط فرمان تعاملی را برای توسعه نرم‌افزار و عیب‌یابی سیستم‌عامل میزبان، بدون نیاز به نصب نرم‌افزار روی میزبان، فراهم می‌کند. این ابزار بر پایه Podman و سایر فناوری‌های استاندارد کانتینر از OCI ساخته شده است.

.PP
محیط‌های Toolbx به شکلی یکپارچه به دایرکتوری خانگی کاربر، سوکت‌های Wayland و X11، شبکه (شامل Avahi)، دستگاه‌های جداشدنی (مانند حافظه‌های فلش USB)، ژورنال systemd، کارگزار SSH، D-Bus، ulimits، /dev و پایگاه‌داده udev و غیره دسترسی دارند.

.PP
این ویژگی به‌ویژه در سیستم‌عامل‌های مبتنی بر OSTree مانند Fedora CoreOS و Silverblue سودمند است. هدف این سیستم‌ها بازداشتن کاربر از نصب نرم‌افزار روی میزبان و در عوض نصب نرم‌افزار به‌صورت کانتینر (یا درون کانتینرها) است — این سیستم‌ها اغلب حتی مدیر بسته‌هایی مانند DNF یا YUM نیز ندارند. این امر راه‌اندازی محیط توسعه یا عیب‌یابی سیستم‌عامل به روش‌های معمول را دشوار می‌سازد.

.PP
Toolbx با فراهم کردن یک کانتینر کاملاً تغییرپذیر (mutable) که در آن می‌توان ابزارهای توسعه و عیب‌یابی، ویرایشگرها و SDKهای مورد علاقه خود را نصب کرد، این مشکل را حل می‌کند. برای نمونه، می‌توان دستور \fByum install ansible\fR را بدون اثرگذاری بر سیستم‌عامل پایه اجرا کرد.

.PP
با این حال، این ابزار نیازمند استفاده از یک سیستم مبتنی بر OSTree \fIنیست\fP. این برنامه روی Fedora Workstation و Server نیز به همان خوبی کار می‌کند و راهکاری سودمند برای به‌کارگیری تدریجی کانتینرسازی است.

.PP
محیط Toolbx بر پایه یک ایمیج OCI است. در Fedora این ایمیج \fBfedora-toolbox\fR است. از این ایمیج برای ایجاد یک کانتینر Toolbx که محیط خط فرمان تعاملی را فراهم می‌کند استفاده می‌شود.

.PP
توجه داشته باشید که Toolbx هیچ تضمین امنیتی فراتر از آنچه از پیش در محیط معمول خط فرمان روی میزبان وجود دارد، ارائه نمی‌دهد.

.SH "توزیع‌های سیستم‌عامل پشتیبانی‌شده (SUPPORTED OPERATING SYSTEM DISTRIBUTIONS)"
به‌طور پیش‌فرض، Toolbx تلاش می‌کند برای ایجاد کانتینرها از ایمیجی منطبق با توزیع سیستم‌عامل میزبان استفاده کند. اگر میزبان پشتیبانی نشود، به یک ایمیج Fedora بازمی‌گردد. سیستم‌عامل‌های میزبان پشتیبانی‌شده عبارتند از:
.IP \(bu 2
Arch Linux
.IP \(bu 2
Fedora
.IP \(bu 2
Red Hat Enterprise Linux >= 8.5
.IP \(bu 2
Ubuntu

.PP
با این حال، می‌توان با استفاده از گزینه‌های \fB--distro\fR و \fB--release\fR که توسط دستورهای مربوطه پذیرفته می‌شوند یا معادل‌های آن‌ها در فایل پیکربندی، کانتینرهایی برای یک توزیع متفاوت ایجاد کرد. پرچم \fB--distro\fR نام توزیع و پرچم \fB--release\fR نسخه آن را مشخص می‌کند. ترکیب‌های پشتیبانی‌شده عبارتند از:

.TS
allbox;
l l 
l l .
\fBDistro\fP	\fBRelease\fP
arch	latest یا rolling
fedora	<release> یا f<release>، مثلاً 36 یا f36
rhel	<major>\&.<minor>، مثلاً 8.5
ubuntu	<YY>\&.<MM>، مثلاً 22.04
.TE

.SH "نحوه استفاده (USAGE)"
.SS ایجاد یک کانتینر Toolbx:
.EX
[user@hostname ~]$ toolbox create
Image required to create toolbox container.
Download registry.fedoraproject.org/fedora-toolbox:36 (294.1MB)? [y/N]: y
Created container: fedora-toolbox-36
Enter with: toolbox enter
[user@hostname ~]$
.EE

.SS ورود به کانتینر Toolbx:
.EX
[user@hostname ~]$ toolbox enter
⬢[user@toolbox ~]$
.EE

.SS حذف کانتینر Toolbx:
.EX
[user@hostname ~]$ toolbox rm fedora-toolbox-36
[user@hostname ~]$
.EE

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

.PP
\fB--assumeyes, -y\fP

.PP
پاسخ خودکار «بله» (yes) به تمام پرسش‌ها.

.PP
\fB--help, -h\fP

.PP
نمایش خلاصه‌ای از این راهنما و خروج.

.PP
\fB--log-level\fP=\fIlevel\fP

.PP
ثبت پیام‌های لاگ بالاتر از سطح مشخص‌شده: debug، info، warn، error، fatal یا panic (پیش‌فرض: error)

.PP
\fB--log-podman\fP

.PP
نمایش پیام‌های لاگ حاصل از فراخوانی‌های Podman بر اساس سطح لاگ مشخص‌شده توسط گزینه \fBlog-level\fP\&.

.PP
\fB--verbose, -v\fP

.PP
مشابه \fB--log-level=debug\fR\&. برای گنجاندن \fB--log-podman\fR از \fB-vv\fR استفاده کنید.

.SH "دستورها (COMMANDS)"
دستورهایی برای کار با کانتینرها و ایمیج‌های Toolbx:

.PP
\fBtoolbox-create(1)\fP

.PP
ایجاد یک کانتینر جدید Toolbx.

.PP
\fBtoolbox-enter(1)\fP

.PP
ورود به یک کانتینر Toolbx برای استفاده تعاملی.

.PP
\fBtoolbox-help(1)\fP

.PP
نمایش اطلاعات راهنما درباره Toolbx.

.PP
\fBtoolbox-init-container(1)\fP

.PP
مقداردهی اولیه یک کانتینر در حال اجرا.

.PP
\fBtoolbox-list(1)\fP

.PP
فهرست کردن کانتینرها و ایمیج‌های موجود Toolbx.

.PP
\fBtoolbox-rm(1)\fP

.PP
حذف یک یا چند کانتینر Toolbx.

.PP
\fBtoolbox-rmi(1)\fP

.PP
حذف یک یا چند ایمیج Toolbx.

.PP
\fBtoolbox-run(1)\fP

.PP
اجرای یک دستور در یک کانتینر موجود Toolbx.

.SH "فایل‌ها (FILES)"
\fBtoolbox.conf(5)\fP

.PP
فایل پیکربندی Toolbx.

.SH "همچنین ببینید (SEE ALSO)"
\fBpodman(1)\fR, https://github.com/containers/toolbox