.nh .TH podman-unshare 1 .SH "نام (NAME)" podman-unshare \- اجرای یک دستور درون فضای نام کاربری تغییریافته .SH "خلاصه دستور (SYNOPSIS)" \fBpodman unshare\fP [\fIگزینه‌ها\fP] [\fIدستور\fP] .SH "توضیحات (DESCRIPTION)" فرایندی را (به‌طور پیش‌فرض، \fI$SHELL\fP) درون یک فضای نام کاربری (user namespace) جدید اجرا می‌کند. این فضای نام کاربری به‌گونه‌ای پیکربندی می‌شود که شناسه کاربری (UID) و شناسه گروهی اصلی (GID) کاربر فراخواننده به ترتیب برابر با UID 0 و GID 0 به نظر برسند. هر محدوده‌ای که با آن کاربر و گروه در \fB/etc/subuid\fR و \fB/etc/subgid\fR مطابقت داشته باشد نیز به کمک برنامه‌های کمکی \fInewuidmap(1)\fP و \fInewgidmap(1)\fP با همان هویت خودشان نگاشت می‌شوند. .PP دستور \fBpodman unshare\fP برای عیب‌یابی عملیات‌های بدون دسترسی ریشه (unprivileged) و برای پاکسازی دستی فضای ذخیره‌سازی و سایر داده‌های مربوط به ایمیج‌ها و کانتینرها مفید است. .PP همچنین برای استفاده از دستور \fBpodman mount\fP کاربرد دارد. اگر یک کاربر غیرریشه بخواهد کانتینری را سوار کرده و با آن کار کند، باید \fBpodman unshare\fP را اجرا نماید. اجرای \fBpodman mount\fP برای کاربران غیرریشه با شکست مواجه می‌شود مگر اینکه کاربر درون یک نشست \fBpodman unshare\fP در حال اجرا باشد. .PP نشست unshare دو متغیر محیطی را تعریف می‌کند: .IP \(bu 2 \fBCONTAINERS_GRAPHROOT\fP: مسیر داده‌های پایدار (persistent) کانتینر. .IP \(bu 2 \fBCONTAINERS_RUNROOT\fP: مسیر داده‌های موقت و فرار (volatile) کانتینر. .PP \fIمهم: این دستور در کلاینت ریموت پادمن در دسترس نیست.\fP .SH "گزینه‌ها (OPTIONS)" .SS \fB--help\fP, \fB-h\fP چاپ بیانیه راهنمای استفاده .SS \fB--rootless-netns\fP پیوستن به فضای نام شبکه بدون ریشه (rootless network namespace) که برای شبکه‌بندی netavark استفاده می‌شود. این گزینه می‌تواند برای اتصال به یک کانتینر بدون ریشه از طریق نشانی IP (شبکه‌بندی bridge) استفاده شود. در غیر این صورت، این کار از فضای نام شبکه میزبان امکان‌پذیر نیست. .SH "کدهای خروج (EXIT CODES)" کد خروج از \fBpodman unshare\fR اطلاعاتی درباره علت شکست اجرای کانتینر یا پایان یافتن آن ارائه می‌دهد. هنگامی که دستورات \fBpodman unshare\fR با یک کد غیر صفر خارج می‌شوند، کدهای خروج از استاندارد \fBchroot\fR پیروی می‌کنند (به زیر مراجعه کنید): .PP \fB125\fP خطا از خود \fB\fIپادمن\fP\fP است .EX $ podman unshare --foo; echo $? Error: unknown flag: --foo 125 .EE .PP \fB126\fP هنگام اجرای یک \fIدستور محصور\fP و زمانی که این \fIدستور\fP قابل فراخوانی نیست .EX $ podman unshare /etc; echo $? Error: fork/exec /etc: permission denied 126 .EE .PP \fB127\fP هنگام اجرای یک \fIدستور محصور\fP و زمانی که این \fIدستور\fP یافت نمی‌شود .EX $ podman unshare foo; echo $? Error: fork/exec /usr/bin/bogus: no such file or directory 127 .EE .PP \fBکد خروج\fP کد خروج \fIدستور محصور\fP .EX $ podman unshare /bin/sh -c 'exit 3'; echo $? 3 .EE .SH "مثال‌ها (EXAMPLES)" اجرای دستور مشخص‌شده درون فضای نام کاربری بدون ریشه: .EX $ podman unshare id uid=0(root) gid=0(root) groups=0(root),65534(nobody) .EE .PP نمایش نگاشت‌های فضای نام کاربری برای کانتینرهای بدون ریشه: .EX $ podman unshare cat /proc/self/uid_map /proc/self/gid_map 0 1000 1 1 10000 65536 0 1000 1 1 10000 65536 .EE .PP نمایش اطلاعات netns بدون ریشه در فضای نام کاربری برای کانتینرهای بدون ریشه: .EX $ podman unshare --rootless-netns ip addr 1: lo: mtu 65536 qdisc noqueue state UNKNOWN group default qlen 1000 link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00 inet 127.0.0.1/8 scope host lo valid_lft forever preferred_lft forever inet6 ::1/128 scope host valid_lft forever preferred_lft forever 2: tap0: mtu 65520 qdisc fq_codel state UNKNOWN group default qlen 1000 link/ether aa:8c:0b:73:98:f6 brd ff:ff:ff:ff:ff:ff inet 10.0.2.100/24 brd 10.0.2.255 scope global tap0 valid_lft forever preferred_lft forever inet6 fd00::a88c:bff:fe73:98f6/64 scope global dynamic mngtmpaddr valid_lft 86389sec preferred_lft 14389sec inet6 fe80::a88c:bff:fe73:98f6/64 scope link valid_lft forever preferred_lft forever .EE .SH "همچنین ببینید (SEE ALSO)" \fBpodman(1)\fP, \fBpodman-mount(1)\fP, \fBnamespaces(7)\fP, \fBnewuidmap(1)\fP, \fBnewgidmap(1)\fP, \fBuser_namespaces(7)\fP