'\" t
.\"     Title: umount
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: مه ۲۰۲۵
.\"    Manual: دستورات مدیریت سیستم
.\"    Source: util-linux
.\"  Language: Persian
.\"
.TH "UMOUNT" "8" "مه ۲۰۲۵" "util-linux" "دستورات مدیریت سیستم"
.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)"
umount \- جدا کردن سیستم پرونده متصلشده
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBumount\fP \fB\-a\fP [\fB\-dflnrv\fP] [\fB\-t\fP \fIfstype\fP] [\fB\-O\fP \fIoption\fP.\|.\|.]
.sp
\fBumount\fP [\fB\-dflnrv\fP] {\fIdirectory\fP|\fIdevice\fP}
.sp
\fBumount\fP \fB\-h\fP|\fB\-V\fP
.SH "توضیحات (DESCRIPTION)"
دستور \fBumount\fR سیستمهای پرونده متصلشده را از درخت دایرکتوری سیستم جدا میکند. یک سیستم پرونده با مشخص کردن پوشه‌ای که در آن سوار شده است تعیین می‌گردد. مشخص کردن فایل دستگاه خاصی که سیستم پرونده روی آن قرار دارد نیز ممکن است کار کند، اما منسوخ شده است، عمدتاً به این دلیل که اگر آن دستگاه روی بیش از یک پوشه سوار شده باشد، عملیات با شکست مواجه خواهد شد.
.sp
توجه داشته باشید که یک سیستم پرونده را هنگامی که در وضعیت «مشغول» (\*(Aqbusy\*(Aq) است نمی‌توان پیاده کرد \- برای مثال، هنگامی که پرونده‌های بازی روی آن وجود دارد، یا هنگامی که فرایندی پوشه کاری خود را آنجا قرار داده است، یا زمانی که یک پرونده حافظه مجازی (swap) روی آن در حال استفاده است. حتی خود فرایند \fBumount\fP نیز ممکن است مسبب این وضعیت باشد \- زیرا کتابخانه libc را باز می‌کند و libc به نوبه خود ممکن است پرونده‌های محلی (locale) را باز کند. پیاده‌سازی تنبل از بروز این مشکل جلوگیری می‌کند، اما ممکن است مسائل دیگری را به وجود آورد. توضیحات \fB\-\-lazy\fP را در ادامه مشاهده کنید.
.SH "گزینه‌ها (OPTIONS)"
.sp
\fB\-a\fP, \fB\-\-all\fP
.RS 4
تمام سیستم‌های پرونده شرح داده شده در \fI/proc/self/mountinfo\fP (یا در \fI/etc/mtab\fP منسوخ‌شده) پیاده می‌شوند، به جز سیستم‌های پرونده proc، devfs، devpts، sysfs، rpc_pipefs و nfsd. این فهرست سیستم‌های پرونده را می‌توان با گزینه \fB\-\-types\fP در umount جایگزین کرد.
.RE
.sp
\fB\-A\fP, \fB\-\-all\-targets\fP
.RS 4
پیاده کردن تمامی نقاط اتصال در فضای‌نام اتصال جاری برای سیستم پرونده مشخص‌شده. سیستم پرونده را می‌توان با یکی از نقاط اتصال یا نام دستگاه (یا UUID و غیره) مشخص کرد. هنگامی که این گزینه همراه با \fB\-\-recursive\fP استفاده می‌شود، تمام اتصالات تو در تو در داخل سیستم پرونده به صورت بازگشتی پیاده می‌شوند. این گزینه فقط در سیستم‌هایی پشتیبانی می‌شود که در آن‌ها \fI/etc/mtab\fP یک پیوند نمادین (symlink) به \fI/proc/mounts\fP باشد.
.RE
.sp
\fB\-c\fP, \fB\-\-no\-canonicalize\fP
.RS 4
مسیرها را متعارف‌سازی نکن. متعارف‌سازی مسیرها بر اساس فراخوان‌های سیستمی \fBstat\fP(2) و \fBreadlink\fP(2) انجام می‌شود. این فراخوان‌های سیستمی در برخی موارد ممکن است متوقف شوند (برای مثال در NFS اگر سرور در دسترس نباشد). این گزینه باید همراه با مسیر متعارف نقطه اتصال استفاده شود.
.sp
این گزینه برای کاربران غیر ریشه به طور خاموش توسط \fBumount\fP نادیده گرفته می‌شود.
.sp
برای جزئیات بیشتر در مورد این گزینه، صفحه راهنمای \fBmount\fP(8) را ببینید. توجه داشته باشید که \fBumount\fP این گزینه را به برنامه‌های کمکی \fB/sbin/umount.\fP\fItype\fP ارسال نمی‌کند.
.RE
.sp
\fB\-d\fP, \fB\-\-detach\-loop\fP
.RS 4
در صورتی که دستگاه پیاده‌شده یک دستگاه حلقه (loop device) باشد، این دستگاه حلقه را نیز آزاد کن. این گزینه برای دستگاه‌هایی که توسط \fBmount\fP(8) مقداردهی اولیه‌شده‌اند غیرضروری است، زیرا در این حالت قابلیت «پاکسازی خودکار» (autoclear) به طور پیش‌فرض فعال است.
.RE
.sp
\fB\-\-fake\fP
.RS 4
باعث می‌شود تمام مراحل به جز فراخوان سیستمی واقعی یا اجرای برنامه کمکی umount انجام شود؛ این گزینه پیاده کردن سیستم پرونده را شبیه‌سازی می‌کند. می‌توان از آن برای حذف ورودی‌هایی از \fI/etc/mtab\fP منسوخ‌شده استفاده کرد که پیش‌تر با گزینه \fB\-n\fP پیاده شده بودند.
.RE
.sp
\fB\-f\fP, \fB\-\-force\fP
.RS 4
اجبار به پیاده‌سازی (در صورت عدم دسترسی به سیستم NFS).
.sp
توجه داشته باشید که این گزینه تضمین نمی‌کند دستور umount متوقف نشود. اکیداً توصیه می‌شود برای جلوگیری از فراخوان‌های سیستمی ناخواسته \fBreadlink\fP(2) و \fBstat\fP(2) روی NFS غیرقابل‌دسترس در \fBumount\fP، از مسیرهای مطلق بدون پیوندهای نمادین استفاده شود.
.RE
.sp
\fB\-i\fP, \fB\-\-internal\-only\fP
.RS 4
برنامه کمکی \fB/sbin/umount.\fP\fIfilesystem\fP را حتی در صورت وجود فراخوانی نکن. به طور پیش‌فرض چنین برنامه کمکی در صورت وجود فراخوانی می‌شود.
.RE
.sp
\fB\-l\fP, \fB\-\-lazy\fP
.RS 4
پیاده‌سازی تنبل (Lazy unmount). سیستم پرونده را بلافاصله از سلسله‌مراتب فایل‌ها جدا می‌کند و به محض اینکه دیگر مشغول نباشد، تمام ارجاعات به این سیستم پرونده را پاکسازی می‌کند.
.sp
اگر قصد دارید از این گزینه برای سیستم پرونده تحت شبکه یا سیستم پرونده محلی دارای زیراتصالات (submounts) استفاده کنید، انتظار می‌رود که سیستم در آینده نزدیک نیاز به راه‌اندازی مجدد (reboot) داشته باشد. مورد کاربرد توصیه‌شده برای \fBumount \-l\fP جلوگیری از متوقف شدن سیستم هنگام خاموش شدن به دلیل اشتراک شبکه غیرقابل‌دسترس است، جایی که یک \fBumount\fP معمولی به دلیل قطع شدن سرور یا تفکیک شبکه متوقف خواهد شد. اتصال مجدد اشتراک امکان‌پذیر نخواهد بود.
.RE
.sp
\fB\-N\fP, \fB\-\-namespace\fP \fIns\fP
.RS 4
اجرای \fBumount\fP در فضای‌نام اتصال مشخص‌شده با \fIns\fP. مقدار \fIns\fP می‌تواند PID فرایند در حال اجرا در آن فضای‌نام یا فایل ویژه‌ای باشد که نمایانگر آن فضای‌نام است.
.sp
دستور \fBumount\fP هنگامی که \fI/etc/fstab\fP را می‌خواند، در \fI/etc/mtab\fP (یا در \fI/run/mount\fP) می‌نویسد و فراخوان سیستمی \fBumount\fP(2) را فراخوانی می‌کند به آن فضای‌نام منتقل می‌شود، در غیر این صورت در فضای‌نام اصلی اجرا می‌گردد. این بدان معناست که فضای‌نام اتصال مقصد نیازی به داشتن کتابخانه‌ها یا سایر ملزومات لازم برای اجرای دستور \fBumount\fP(2) ندارد.
.sp
برای اطلاعات بیشتر \fBmount_namespaces\fP(7) را ببینید.
.RE
.sp
\fB\-n\fP, \fB\-\-no\-mtab\fP
.RS 4
پیاده کردن بدون نوشتن در \fI/etc/mtab\fP.
.RE
.sp
\fB\-O\fP, \fB\-\-test\-opts\fP \fIoption\fP.\|.\|.
.RS 4
فقط سیستم‌های پرونده‌ای را پیاده کن که گزینه مشخص‌شده در \fI/etc/fstab\fP برای آن‌ها تنظیم شده باشد. می‌توان بیش از یک گزینه را در فهرستی که با کاما جدا شده است مشخص کرد. هر گزینه می‌تواند با پیشوند \fBno\fP همراه باشد تا نشان دهد هیچ اقدامی نباید برای این گزینه انجام شود.
.RE
.sp
\fB\-q\fP, \fB\-\-quiet\fP
.RS 4
سرکوب پیام‌های خطای «متصل نیست» ("not mounted").
.RE
.sp
\fB\-R\fP, \fB\-\-recursive\fP
.RS 4
پیاده کردن بازگشتی هر دایرکتوری مشخص‌شده. در صورتی که هر عملیات پیاده‌سازی در زنجیره به هر دلیلی با شکست مواجه شود، بازگشت برای هر دایرکتوری متوقف خواهد شد. رابطه بین نقاط اتصال توسط ورودی‌های \fI/proc/self/mountinfo\fP تعیین می‌شود. سیستم پرونده باید با مسیر نقطه اتصال مشخص شود؛ پیاده‌سازی بازگشتی با نام دستگاه (یا UUID) پشتیبانی نمی‌شود. از نسخه ۲.۳۷ به بعد، تمام سیستم‌های پرونده هم‌پوشانی‌شده (چندین سیستم پرونده روی یک نقطه اتصال) را نیز پیاده می‌کند.
.RE
.sp
\fB\-r\fP, \fB\-\-read\-only\fP
.RS 4
هنگامی که پیاده‌سازی با شکست مواجه می‌شود، تلاش کن تا سیستم پرونده را به صورت فقط‌خواندنی اتصال مجدد (remount) کنی.
.RE
.sp
\fB\-t\fP, \fB\-\-types\fP \fItype\fP.\|.\|.
.RS 4
نشان می‌دهد که اقدامات باید فقط روی سیستم‌های پرونده از نوع (\fItype\fP) مشخص‌شده انجام شوند. می‌توان بیش از یک نوع را در فهرستی که با کاما جدا شده است مشخص کرد. فهرست انواع سیستم‌های پرونده می‌تواند با پیشوند \fBno\fP همراه باشد تا مشخص شود هیچ اقدامی نباید برای تمامی انواع ذکرشده انجام گیرد. توجه داشته باشید که \fBumount\fP اطلاعات مربوط به سیستم‌های پرونده متصل‌شده را از هسته (\fI/proc/mounts\fP) می‌خواند و ممکن است نام‌های سیستم پرونده با نام‌های استفاده‌شده در \fI/etc/fstab\fP متفاوت باشند (مثلاً "nfs4" در مقابل "nfs").
.RE
.sp
\fB\-v\fP, \fB\-\-verbose\fP
.RS 4
حالت با جزئیات کامل.
.RE
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
نمایش راهنما و خروج.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
نمایش نسخه و خروج.
.RE
.SH "پیاده‌سازی توسط کاربران غیرریشه (NON\-SUPERUSER UMOUNTS)"
.sp
به طور معمول، فقط کاربر ارشد می‌تواند سیستم‌های پرونده را پیاده کند. با این حال، هنگامی که \fIfstab\fP شامل گزینه \fBuser\fP در یک خط باشد، هر کسی می‌تواند سیستم پرونده مربوطه را پیاده کند. برای جزئیات بیشتر به صفحه راهنمای \fBmount\fP(8) مراجعه کنید.
.sp
از نسخه ۲.۳۴ دستور \fBumount\fP می‌تواند برای انجام عملیات پیاده‌سازی سیستم‌های پرونده fuse نیز استفاده شود، مشروط بر اینکه جدول اتصال هسته شامل شناسه کاربر باشد. در این حالت گزینه اتصال \fBuser=\fP در \fIfstab\fP مورد نیاز نیست.
.sp
از نسخه ۲.۳۵ دستور \fBumount\fP هنگامی که دسترسی‌های کاربر طبق قوانین امنیتی داخلی \fBlibmount\fP ناکافی باشد، با خطا متوقف نمی‌شود. این دستور مجوزهای suid را کنار می‌گذارد و به عنوان یک کاربر عادی غیر ریشه ادامه می‌دهد. از این سازوکار می‌توان برای پشتیبانی از مواردی که دسترسی ریشه در آن‌ها ضروری نیست (مانند سیستم‌های پرونده fuse، فضاهای‌نام کاربر و غیره) استفاده کرد.
.SH "دستگاه حلقه (LOOP DEVICE)"
.sp
دستور \fBumount\fP به طور خودکار دستگاه حلقه (loop device) را که پیش‌تر توسط دستور \fBmount\fP(8) مقداردهی اولیه شده بود، مستقل از \fI/etc/mtab\fP جدا می‌کند.
.sp
در این حالت دستگاه با پرچم "autoclear" مقداردهی اولیه می‌شود (برای جزئیات بیشتر به خروجی \fBlosetup\fP(8) مراجعه کنید)، در غیر این صورت لازم است از گزینه \fB\-\-detach\-loop\fP استفاده کنید یا \fBlosetup \-d\fP \fIdevice\fP را فراخوانی نمایید. ویژگی autoclear از لینوکس ۲.۶.۲۵ پشتیبانی می‌شود.
.sp
توجه داشته باشید که از لینوکس نسخه ۳.۷ هسته از «نابودی تنبل دستگاه» (lazy device destruction) استفاده می‌کند. سیستم فقط دستگاه حلقه را با پرچم autoclear نشانه‌گذاری کرده و بعداً آن را پاک می‌کند. اگر نیاز دارید تا حذف کامل دستگاه حلقه صبر کنید، پس از \fBumount\fP دستور \fBudevadm settle\fP را فراخوانی نمایید.
.SH "وضعیت خروج (EXIT STATUS)"
.sp
دستور \fBumount\fP دارای مقادیر وضعیت خروج زیر است (بیت‌ها می‌توانند با یکدیگر OR شوند):
.sp
\fB0\fP
.RS 4
موفقیت
.RE
.sp
\fB1\fP
.RS 4
فراخوانی نادرست یا دسترسی ناکافی
.RE
.sp
\fB2\fP
.RS 4
خطای سیستم (کمبود حافظه، عدم امکان fork، نبود دستگاه حلقه دیگر)
.RE
.sp
\fB4\fP
.RS 4
باگ داخلی \fBmount\fP
.RE
.sp
\fB8\fP
.RS 4
وقفه توسط کاربر
.RE
.sp
\fB16\fP
.RS 4
مشکل در نوشتن یا قفل کردن \fI/etc/mtab\fP
.RE
.sp
\fB32\fP
.RS 4
شکست در اتصال
.RE
.sp
\fB64\fP
.RS 4
برخی پیاده‌سازی‌ها موفقیت‌آمیز بودند
.sp
دستور \fBumount \-a\fP مقادیر 0 (همه موفق)، 32 (همه ناموفق) یا 64 (برخی ناموفق، برخی موفق) را برمی‌گرداند.
.RE
.sp
\fB126\fP
.RS 4
شکست در اجرای برنامه کمکی اتصال خارجی /sbin/umount.<type> (از util\-linux نسخه ۲.۴۱)
.RE
.SH "برنامه‌های کمکی خارجی (EXTERNAL HELPERS)"
.sp
نحو برنامه‌های کمکی پیاده‌سازی خارجی به صورت زیر است:
.RS 3
.ll -.6i
.sp
\fBumount.\fP\fIsuffix\fP {\fIdirectory\fP|\fIdevice\fP} [\fB\-flnrv\fP] [\fB\-N\fP \fInamespace\fP] [\fB\-t\fP \fItype\fP.\fIsubtype\fP]
.br
.RE
.ll
.sp
که در آن \fIsuffix\fP نوع سیستم پرونده است (یا مقدار حاصل از نشانگر \fBuhelper=\fP یا \fBhelper=\fP در فایل mtab). گزینه \fB\-t\fP می‌تواند برای سیستم‌های پرونده‌ای که از نوع فرعی (subtype) پشتیبانی می‌کنند به کار رود. برای مثال:
.RS 3
.ll -.6i
.sp
\fBumount.fuse \-t fuse.sshfs\fP
.br
.RE
.ll
.sp
یک نشانگر \fBuhelper=\fP\fIsomething\fP (برنامه کمکی غیرممتاز) می‌تواند در فایل \fI/etc/mtab\fP ظاهر شود زمانی که کاربران عادی باید بتوانند نقطه اتصالی را پیاده کنند که در \fI/etc/fstab\fP تعریف نشده است (برای مثال برای دستگاهی که توسط \fBudisks\fP(1) متصل شده است).
.sp
یک نشانگر \fBhelper=\fP\fItype\fP در فایل \fImtab\fP تمامی درخواست‌های پیاده‌سازی را صرف‌نظر از UID به برنامه کمکی \fB/sbin/umount.\fP\fItype\fP هدایت خواهد کرد.
.sp
توجه داشته باشید که در حال حاضر \fI/etc/mtab\fP منسوخ شده است و \fBhelper=\fP و سایر گزینه‌های اتصال فضای کاربر توسط \fBlibmount\fP نگهداری می‌شوند.
.sp
مقدار وضعیت خروج برنامه کمکی به عنوان وضعیت خروج \fBumount\fP(8) بازگردانده می‌شود. مقدار 126 زمانی استفاده می‌شود که برنامه کمکی پیدا شود اما execl() با شکست مواجه گردد.
.SH "محیط (ENVIRONMENT)"
.sp
\fBLIBMOUNT_FSTAB\fP=<path>
.RS 4
مسیر پیش‌فرض فایل \fIfstab\fP را بازنویسی می‌کند (برای \fBsuid\fP نادیده گرفته می‌شود)
.RE
.sp
\fBLIBMOUNT_DEBUG\fP=all
.RS 4
خروجی اشکال‌زدایی \fBlibmount\fP را فعال می‌کند
.RE
.SH "فایل‌ها (FILES)"
.sp
\fI/etc/mtab\fP
.RS 4
جدول سیستم‌های پرونده متصل‌شده (منسوخ شده و معمولاً با یک پیوند نمادین به \fI/proc/mounts\fP جایگزین شده است)
.RE
.sp
\fI/etc/fstab\fP
.RS 4
جدول سیستم‌های پرونده شناخته‌شده
.RE
.sp
\fI/proc/self/mountinfo\fP
.RS 4
جدول سیستم‌های پرونده متصل‌شده تولیدشده توسط هسته.
.RE
.SH "پیشینه (HISTORY)"
.sp
دستور \fBumount\fP در نسخه ۶ یونیکس AT&T ظاهر شد.
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBumount\fP(2),
\fBlosetup\fP(8),
\fBmount_namespaces\fP(7),
\fBmount\fP(8)
.SH "گزارش باگ‌ها (REPORTING BUGS)"
.sp
برای گزارش باگ‌ها، از سامانه پیگیری مشکلات در \c
.URL "https://github.com/util-linux/util-linux/issues" "util-linux issues" "."
استفاده کنید.
.SH "در دسترس بودن (AVAILABILITY)"
.sp
دستور \fBumount\fP بخشی از بسته util-linux است که می‌توان آن را از \c
.URL "https://www.kernel.org/pub/linux/utils/util-linux" "Linux Kernel Archive" "."
دریافت کرد.