.nh
.TH toolbox-run 1
.SH "نام (NAME)"
toolbox-run \- اجرای یک دستور در یک کانتینر موجود Toolbx

.SH "خلاصه دستور (SYNOPSIS)"
\fBtoolbox run\fP [\fI--container NAME\fP | \fI-c NAME\fP]
            [\fI--distro DISTRO\fP | \fI-d DISTRO\fP]
            [\fI--preserve-fds N\fP]
            [\fI--release RELEASE\fP | \fI-r RELEASE\fP]
            [\fICOMMAND\fP]

.SH "توضیحات (DESCRIPTION)"
یک دستور را درون یک کانتینر موجود Toolbx اجرا می‌کند. این کانتینر باید قبلاً با
استفاده از دستور \fBtoolbox create\fR ایجاد شده باشد.

.PP
در Fedora، کانتینر پیش‌فرض با نام \fBfedora-toolbox-N\fR شناخته می‌شود، که در آن N
نسخهٔ انتشار سیستم میزبان است. می‌توان یک کانتینر مشخص را با استفاده از گزینهٔ
\fB--container\fR انتخاب کرد.

.PP
یک کانتینر Toolbx در واقع یک کانتینر OCI است. بنابراین، دستور \fBtoolbox run\fR مشابه
یک \fBpodman start\fR است که پس از آن یک \fBpodman exec\fR\& اجرا می‌شود.

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

.PP
\fB--container\fP NAME, \fB-c\fP NAME

.PP
اجرای دستور درون یک کانتینر Toolbx با NAME مشخص‌شده. این گزینه زمانی مفید است
که چندین کانتینر Toolbx از یک ایمیج یکسان ایجاد شده باشند، یا کانتینرهایی
کاملاً سفارشی از ایمیج‌های دست‌ساز ساخته شده باشند.

.PP
\fB--distro\fP DISTRO, \fB-d\fP DISTRO

.PP
اجرای دستور درون یک کانتینر Toolbx برای توزیع (DISTRO) سیستم‌عاملی متفاوت از میزبان.
این گزینه باید با \fB--release\fR همراه باشد مگر آنکه DISTRO انتخاب‌شده با
سیستم میزبان یکسان باشد.

.PP
\fB--preserve-fds\fP N

.PP
منتقل کردن N توصیف‌کننده فایل (file descriptor) اضافی (علاوه بر 0، 1 و 2)
به دستور. تعداد کل توصیف‌کننده‌های فایل 3+N خواهد بود.

.PP
\fB--release\fP RELEASE, \fB-r\fP RELEASE

.PP
اجرای دستور درون یک کانتینر Toolbx برای نسخهٔ انتشار (RELEASE) سیستم‌عاملی
متفاوت از میزبان.

.SH "وضعیت خروج (EXIT STATUS)"
کد خروج، اطلاعاتی دربارهٔ دلیل عدم موفقیت در اجرای دستور درون کانتینر
یا علت پایان یافتن آن ارائه می‌دهد.

.PP
\fB1\fP خطای داخلی در Toolbx رخ داده است

.PP
\fB125\fP خطای داخلی در Podman رخ داده است

.PP
\fB126\fP دستور مورد نظر فراخوانی نشد

.EX
$ toolbox run /etc; echo $?
/bin/sh: line 1: /etc: Is a directory
/bin/sh: line 1: exec: /etc: cannot execute: Is a directory
Error: failed to invoke command /etc in container fedora-toolbox-36
126
.EE

.PP
\fB127\fP دستور مورد نظر پیدا نشد یا دایرکتوری کاری وجود ندارد

.EX
$ toolbox run foo; echo $?
/bin/sh: line 1: exec: foo: not found
Error: command foo not found in container fedora-toolbox-36
127
.EE

.PP
\fBExit code\fP کد خروج دستور اجرا شده

.EX
$ toolbox run false; echo $?
1
.EE

.SH "مثال‌ها (EXAMPLES)"
.SS اجرای ls درون کانتینر پیش‌فرض Toolbx مطابق با سیستم‌عامل میزبان
.EX
$ toolbox run ls -la
.EE

.SS اجرای emacs درون کانتینر پیش‌فرض Toolbx برای Fedora 36
.EX
$ toolbox run --distro fedora --release f36 emacs
.EE

.SS اجرای uptime درون یک کانتینر Toolbx با یک نام سفارشی
.EX
$ toolbox run --container foo uptime
.EE

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