'\" t
.\"     Title: pivot_root
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-09-02
.\"    Manual: System Administration
.\"    Source: util-linux 2.42.3
.\"  Language: Persian
.\"
.TH "PIVOT_ROOT" "8" "2026-09-02" "util\-linux 2.42.3" "مدیریت سیستم"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "نام (NAME)"
pivot_root \- جابجایی دایرکتوری ریشه سیستم فایل به مکان جدید
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBpivot_root\fP \fInew_root\fP \fIput_old\fP
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBpivot_root\fP سیستم فایل ریشه فرایند جاری را به دایرکتوری \fIput_old\fP منتقل کرده و \fInew_root\fP را به عنوان سیستم فایل ریشه جدید قرار می‌دهد. از آنجا که \fBpivot_root\fP(8) صرفاً \fBpivot_root\fP(2) را فراخوانی می‌کند، برای جزئیات بیشتر به صفحه راهنمای دومی ارجاع داده می‌شود.
.sp
توجه داشته باشید که بسته به پیاده‌سازی \fBpivot_root\fP، دایرکتوری ریشه و دایرکتوری کاری جاری فراخواننده ممکن است تغییر کند یا نکند. موارد زیر ترتیبی برای فراخوانی \fBpivot_root\fP است که در هر دو حالت کار می‌کند، با این فرض که \fBpivot_root\fP و \fBchroot\fP در \fBPATH\fP جاری قرار دارند:
.sp
.if n .RS 4
.nf
.fam C
cd new_root
pivot_root . put_old
exec chroot . command
.fam
.fi
.if n .RE
.sp
توجه داشته باشید که \fBchroot\fP باید هم در زیر ریشه قدیمی و هم در زیر ریشه جدید در دسترس باشد، زیرا \fBpivot_root\fP ممکن است دایرکتوری ریشه پوسته را به طور ضمنی تغییر داده باشد یا نداده باشد.
.sp
توجه داشته باشید که \fBexec chroot\fP فایل اجرایی در حال اجرا را تغییر می‌دهد، که اگر قرار است دایرکتوری ریشه قدیمی پس از آن پیاده‌سازی (unmount) شود، ضروری است. همچنین توجه داشته باشید که ورودی، خروجی و خطای استاندارد ممکن است همچنان به دستگاهی در سیستم فایل ریشه قدیمی اشاره کنند و آن را مشغول نگه دارند. آنها را می‌توان هنگام فراخوانی \fBchroot\fP به‌راحتی تغییر داد (زیر را ببینید؛ به عدم وجود اسلش‌های آغازین توجه کنید تا چه \fBpivot_root\fP ریشه پوسته را تغییر داده باشد چه نداده باشد، کار کند).
.SH "گزینه‌ها (OPTIONS)"
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
نمایش متن راهنما و خروج.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
نمایش نسخه و خروج.
.RE
.SH "مثال (EXAMPLE)"
.sp
تغییر سیستم فایل ریشه به \fI/dev/hda1\fP از یک پوسته تعاملی:
.sp
.if n .RS 4
.nf
.fam C
mount /dev/hda1 /new\-root
cd /new\-root
pivot_root . old\-root
exec chroot . sh <dev/console >dev/console 2>&1
umount /old\-root
.fam
.fi
.if n .RE
.sp
سوار کردن سیستم فایل ریشه جدید از طریق NFS از 10.0.0.1:/my_root و اجرای \fBinit\fP:
.sp
.if n .RS 4
.nf
.fam C
ifconfig lo 127.0.0.1 up\&   # for portmap
# configure Ethernet or such
portmap\&   # for lockd (implicitly started by mount)
mount \-o ro 10.0.0.1:/my_root /mnt
killall portmap\&   # portmap keeps old root busy
cd /mnt
pivot_root . old_root
exec chroot . sh \-c \*(Aqumount /old_root; exec /sbin/init\*(Aq \(rs
  <dev/console >dev/console 2>&1
.fam
.fi
.if n .RE
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBchroot\fP(1),
\fBpivot_root\fP(2),
\fBmount\fP(8),
\fBswitch_root\fP(8),
\fBumount\fP(8)
.SH "گزارش باگ‌ها (REPORTING BUGS)"
.sp
برای گزارش باگ‌ها، از \c
.URL "https://github.com/util\-linux/util\-linux/issues" "ردیاب اشکال" "."
.SH "در دسترس بودن (AVAILABILITY)"
.sp
دستور \fBpivot_root\fP بخشی از بسته util\-linux است که می‌توان آن را از \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux" "بایگانی هسته لینوکس" "."
دریافت کرد.