.\
.\"
.TH "DISTROBOX\-HOST\-EXEC" "1" "Mar 2026" "Distrobox" "User Manual"
.SH "نام (NAME)"
distrobox\-host\-exec \- اجرای دستورات روی سیستم میزبان از درون کانتینر
.SH "توضیحات (DESCRIPTION)"
دستور distrobox\-host\-exec به شما امکان می‌دهد در حالی که درون یک کانتینر هستید، دستوراتی را روی سیستم میزبان اجرا کنید.
.PP
در پشت صحنه، distrobox\-host\-exec از \f[CR]host\-spawn\f[R] استفاده می‌کند؛ پروژه‌ای که امکان اجرای دستورات را بر روی سیستم میزبان فراهم می‌سازد.
اگر این ابزار یافت نشود، از کاربر خواسته می‌شود تا آن را نصب کند.
.SH "خلاصه دستور (SYNOPSIS)"
کافی است هر دستوری و تمامی آرگومان‌های آن (در صورت وجود) را به \[lq]distrobox\-host\-exec\[rq] بدهید.
.IP
.EX
\-\-help/\-h:      نمایش این پیام
\-\-verbose/\-v:       نمایش جزئیات بیشتر
\-\-version/\-V:       نمایش نسخه
\-\-yes/\-Y:       پاسخ خودکار بله به پرسش‌ها:
                            در صورت شناسایی نشدن host\-spawn، این ابزار
                            روی سیستم مهمان نصب خواهد شد.
                            این رفتار هنگام اجرا در یک پوسته غیرتعاملی پیش‌فرض است.
.EE
.PP
اگر هیچ دستوری مشخص نشود، \[lq]$SHELL\[rq] اجرا خواهد شد.
.PP
همچنین می‌توانید یک پیوند نمادین (symlink) از نام یک دستور به
\f[CR]distrobox\-host\-exec\f[R] ایجاد کنید و سپس آن دستور را با نامش
بر روی میزبان، در حالی که درون کانتینر هستید فراخوانی نمایید.
.SH "مثال‌ها (EXAMPLES)"
.SS اجرای دستورهای مجزا
.IP
.EX
distrobox\-host\-exec ls
distrobox\-host\-exec bash \-l
distrobox\-host\-exec flatpak run org.mozilla.firefox
distrobox\-host\-exec podman ps \-a
.EE
.SS ورود به پوسته میزبان
.IP
.EX
\[ti]$: distrobox\-host\-exec # بدون دستور، \[dq]$SHELL\[dq] را روی میزبان اجرا می‌کند
\[ti]$: distrobox\-host\-exec # این دستور اکنون روی میزبان اجرا می‌شود
You must run  distrobox\-host\-exec inside a container!
.EE
.SS ایجاد پیوند نمادین برای دستورات میزبان
از نام دستور میزبان برای ایجاد یک پیوند نمادین (symlink) به
\f[CR]distrobox\-host\-exec\f[R] استفاده کنید.
سپس می‌توانید آن دستور میزبان را از درون کانتینر فراخوانی کنید.
.IP
.EX
\[ti]$: git # ما دستور git را درون کانتینر نداریم
bash: git: command not found
\[ti]$: sudo ln \-s /usr/bin/distrobox\-host\-exec /usr/local/bin/git
\[ti]$: git version
git version 2.51.1
.EE
.PP
می‌توانید podman موجود در میزبان را از درون کانتینر به صورت زیر کنترل کنید:
.IP
.EX
\[ti]$: ln \-s /usr/bin/distrobox\-host\-exec /usr/local/bin/podman
\[ti]$: ls \-l /usr/local/bin/podman
lrwxrwxrwx. 1 root root 51 Jul 11 19:26 /usr/local/bin/podman \-> /usr/bin/distrobox\-host\-exec
\[ti]$: podman version
\&...این دستور روی میزبان اجرا می‌شود...
.EE