FINDMNT(8)

مدیریت سیستم

FINDMNT(8)

نام (NAME)

findmnt - جستجو و یافتن یک سیستم فایل سوارشده

خلاصه دستور (SYNOPSIS)

findmnt [options]

findmnt [options] device|mountpoint

findmnt [options] [--source] device [--target path|--mountpoint mountpoint]

توضیحات (DESCRIPTION)

دستور findmnt تمام سیستم‌فایل‌های سوارشده را فهرست کرده یا به جستجوی یک سیستم‌فایل می‌پردازد. این دستور قادر است در /etc/fstab، /etc/mtab یا /proc/self/mountinfo جستجو کند. اگر device یا mountpoint مشخص نشده باشد، تمام سیستم‌فایل‌ها نمایش داده می‌شوند.

دستگاه را می‌توان با نام دستگاه، شماره‌های major:minor، برچسب (LABEL) یا UUID سیستم‌فایل، یا برچسب یا UUID افراز (پارتیشن) مشخص کرد. توجه داشته باشید که findmnt از رفتار mount(8) پیروی می‌کند که در آن چنانچه گزینه‌های --target، --mountpoint یا --source مشخص نشده باشند، نام دستگاه ممکن است به عنوان نقطه اتصال تفسیر شود (و برعکس).

گزینه خط فرمانی --target هر پرونده یا دایرکتوری را می‌پذیرد و سپس findmnt سیستم‌فایل مربوط به مسیر ارائه‌شده را نمایش می‌دهد.

این دستور به‌طور پیش‌فرض تمام سیستم‌فایل‌های سوارشده را در قالبی درخت‌مانند چاپ می‌کند. خروجی پیش‌فرض ممکن است تغییر کند. بنابراین تا جای ممکن باید از به‌کارگیری خروجی پیش‌فرض در اسکریپت‌های خود خودداری کنید. در محیط‌هایی که خروجی پایدار نیاز است، همیشه ستون‌های مورد انتظار را با استفاده از --output columns-list به‌طور صریح مشخص کنید.

رابطه میان دستگاه‌های بلوکی و سیستم‌فایل‌ها همیشه یک‌به‌یک نیست. سیستم‌فایل ممکن است از چندین دستگاه بلوکی استفاده کند. به همین دلیل findmnt ستون‌های SOURCE و SOURCES (جمع) را ارائه می‌دهد. ستون SOURCES تمام دستگاه‌هایی را نمایش می‌دهد که در آن‌ها امکان یافتن همان UUID سیستم‌فایل (یا برچسب دیگری که هنگام اجرا با --fstab و --evaluate در fstab مشخص شده) وجود دارد.

گزینه‌ها (OPTIONS)

-A, --all

غیرفعال‌سازی تمام فیلترهای توکار و چاپ تمام سیستم‌فایل‌ها.

-a, --ascii

استفاده از نویسه‌های ASCII برای قالب‌بندی درختی.

-b, --bytes

چاپ اندازه‌ها بر حسب بایت به‌جای قالبی خوانا برای انسان.

به‌طور پیش‌فرض، یکایی که اندازه‌ها بر حسب آن بیان می‌شوند بایت است و پیشوندهای یکا در توان‌های 2^10 (1024) هستند. کوته‌نوشت نمادها برای خوانایی بهتر با نمایش تنها حرف اول آن‌ها خلاصه شده است؛ برای مثال: "1 KiB" و "1 MiB" به ترتیب به صورت "1 K" و "1 M" نمایش داده می‌شوند و عبارت "iB" که بخشی از این کوته‌نوشت‌هاست عمداً حذف می‌شود.

-C, --nocanonicalize

عدم استانداردسازی (canonicalize) مسیرها به هیچ وجه. این گزینه بر مقایسه مسیرها و ارزیابی برچسب‌ها (LABEL، UUID و غیره) تأثیر می‌گذارد.

-c, --canonicalize

استانداردسازی تمام مسیرهای چاپ‌شده.

-D, --df

تقلید خروجی دستور df(1). این گزینه معادل -o SOURCE,FSTYPE,SIZE,USED,AVAIL,USE%,TARGET است اما تمام سیستم‌فایل‌های کاذب (pseudo) را مستثنی می‌کند. برای چاپ تمام سیستم‌فایل‌ها از --all استفاده کنید. همچنین گزینه‌های -I و --dfi را ببینید.

-d, --direction word

جهت جستجو، یا forward (رو به جلو) یا backward (رو به عقب).

-e, --evaluate

تبدیل تمام برچسب‌ها (LABEL، UUID، PARTUUID یا PARTLABEL) به نام‌های دستگاه متناظر برای ستون SOURCE. این وضعیتی نامعمول است، اما ممکن است یک برچسب تکراری باشد (برای دستگاه‌های بیشتری استفاده شود). برای این منظور، ستون SOURCES (جمع) وجود دارد. این ستون در یک سلول چندخطی تمام دستگاه‌هایی را که برچسب در آن‌ها توسط libblkid شناسایی شده است نمایش می‌دهد. این گزینه تنها برای fstab کاربرد دارد.

--hyperlink[=mode]

چاپ مسیرهای نقطه اتصال به صورت پیوندهای یکپارچه (هایپرلینک) ترمینال. mode می‌تواند روی "always"، "never" یا "auto" تنظیم شود. آرگومان اختیاری when می‌تواند روی "auto"، "never" یا "always" باشد. اگر آرگومان when حذف شود، مقدار پیش‌فرض "auto" خواهد بود. تنظیم "auto" بدان معناست که هایپرلینک‌ها تنها در صورتی استفاده می‌شوند که خروجی در ترمینال باشد.

-F, --tab-file path

جستجو در یک پرونده جایگزین. اگر به همراه --fstab، --mtab یا --kernel استفاده شود، مسیرهای پیش‌فرض را بازنویسی می‌کند. اگر بیش از یک بار مشخص شود، خروجی درخت‌مانند غیرفعال می‌شود (گزینه --list را ببینید).

-f, --first-only

تنها چاپ اولین سیستم‌فایل منطبق.

-H, --list-columns

فهرست کردن ستون‌های موجود؛ استفاده همراه با --json یا --raw برای دریافت خروجی در قالب ماشین‌خوان.

-I, --dfi

تقلید خروجی دستور df(1) همراه با گزینه -i آن. این گزینه معادل -o SOURCE,FSTYPE,INO.TOTAL,INO.USED,INO.AVAIL,INO.USE%,TARGET است اما تمام سیستم‌فایل‌های کاذب را مستثنی می‌کند. برای چاپ تمام سیستم‌فایل‌ها از --all استفاده کنید.

-i, --invert

معکوس کردن منطق انطباق.

--id number

انتخاب یک سیستم‌فایل با استفاده از شناسه گره اتصال (mount node ID).

--uniq-id number

انتخاب یک سیستم‌فایل با استفاده از شناسه ۶۴بیتی گره اتصال؛ استفاده به همراه گزینه --kernel=listmount.

-J, --json

استفاده از قالب خروجی JSON.

-k, --kernel[=method]

خواندن اطلاعات مربوط به سیستم‌فایل‌ها از هسته. این خروجی پیش‌فرض است. قالب خروجی درخت‌مانند است و تنها شامل گزینه‌های اتصالی می‌شود که توسط هسته مدیریت می‌شوند (همچنین --mtab را ببینید).

آرگومان اختیاری method تنها برای گونه بلند (--kernel) پشتیبانی می‌شود. گونه کوتاه (-k) برای سازگاری با گذشته به‌طور پیش‌فرض از روش mountinfo استفاده می‌کند. روش‌های پشتیبانی‌شده عبارتند از:

•mountinfo - این روش پیش‌فرض است و داده‌ها را از پرونده /proc/self/mountinfo می‌خواند.

•listmount - این یک روش آزمایشی (EXPERIMENTAL) است که از فراخوان‌های سیستمی listmount() و statmount() برای تولید جدول اتصالات استفاده می‌کند. خروجی ممکن است شامل تمام جزئیات مربوط به گره‌های اتصال نباشد (برای مثال، در حال حاضر SOURCE وجود ندارد).

-l, --list

استفاده از قالب خروجی فهرستی (لیست). این قالب خروجی در صورتی که خروجی با گزینه‌های -t، -O، -S یا -T محدود شده باشد و گزینه --submounts استفاده نشده باشد، یا اگر بیش از یک پرونده مبدأ (گزینه -F) مشخص شده باشد، به‌طور خودکار فعال می‌شود.

-M, --mountpoint path

تعریف صریح پرونده یا دایرکتوری نقطه اتصال. همچنین --target را ببینید.

-m, --mtab

جستجو در /etc/mtab. خروجی به‌طور پیش‌فرض در قالب فهرستی است (گزینه --tree را ببینید). خروجی ممکن است شامل گزینه‌های اتصال فضای کاربری (user space) باشد.

-N, --task tid

استفاده از فضای نام جایگزین /proc/<tid>/mountinfo به‌جای پیش‌فرض /proc/self/mountinfo. اگر این گزینه بیش از یک بار مشخص شود، خروجی درخت‌مانند غیرفعال می‌شود (گزینه --list را ببینید). همچنین دستور unshare(1) را ببینید.

-n, --noheadings

عدم چاپ خط سربرگ (هدر).

-O, --options list

محدود کردن مجموعه سیستم‌فایل‌های چاپ‌شده. می‌توان بیش از یک گزینه را در یک فهرست جداشده با کاما مشخص کرد. اثر گزینه‌های -t و -O انباشتی است. تفاوت آن با -t در این است که هر گزینه دقیقاً منطبق می‌شود؛ وجود no در ابتدا معنای سراسری ندارد. پیشوند "no" را می‌توان برای موارد منفرد در فهرست استفاده کرد. تفسیر پیشوند "no" را می‌توان با پیشوند "+" غیرفعال کرد.

-o, --output list

تعریف ستون‌های خروجی. برای دریافت فهرستی از ستون‌های پشتیبانی‌شده کنونی، خروجی --help را ببینید. ستون TARGET در صورتی که گزینه‌های --list یا --raw مشخص نشده باشند، حاوی قالب‌بندی درختی خواهد بود.

در صورتی که list در قالب +list مشخص شود، فهرست پیش‌فرض ستون‌ها می‌تواند گسترش یابد (برای مثال findmnt -o +PROPAGATION).

--output-all

چاپ تقریباً تمام ستون‌های موجود. ستون‌هایی که نیازمند --poll هستند گنجانده نمی‌شوند.

-P, --pairs

تولید خروجی در قالب جفت‌های key="value". تمام نویسه‌های مقدار بالقوه ناامن به‌صورت هگزادسیمال اسکیپ می‌شوند (\x<code>). همچنین گزینه --shell را ببینید.

توجه داشته باشید که ستون SOURCES از سلول‌های چندخطی استفاده می‌کند. در این موارد، ستون از قالب‌بندی شبه‌آرایه در خروجی استفاده می‌کند؛ برای مثال name=("aaa" "bbb" "ccc").

-p, --poll[=list]

پایش تغییرات در پرونده /proc/self/mountinfo. عملیات‌های پشتیبانی‌شده عبارتند از: mount، umount، remount و move. می‌توان بیش از یک عملیات را در یک فهرست جداشده با کاما مشخص کرد. تمام عملیات‌ها به‌طور پیش‌فرض پایش می‌شوند.

مدت زمانی که --poll مسدود خواهد شد را می‌توان با گزینه‌های --timeout یا --first-only محدود کرد.

ستون‌های استاندارد همیشه از نسخه جدید اطلاعات پرونده mountinfo استفاده می‌کنند، به‌جز عملیات umount که بر اساس اطلاعات اصلی کش‌شده توسط findmnt است. حالت poll امکان استفاده از ستون‌های اضافی زیر را می‌دهد:

ACTION

نام عملیات mount، umount، move یا remount؛ این ستون به‌طور پیش‌فرض فعال است.

OLD-TARGET

برای عملیات‌های umount و move موجود است.

OLD-OPTIONS

برای عملیات‌های umount و remount موجود است.

--pseudo

تنها چاپ سیستم‌فایل‌های کاذب (pseudo).

--shadow

تنها چاپ سیستم‌فایل‌هایی که توسط یک سیستم‌فایل دیگر پوشانده شده‌اند (over-mounted).

-Q, --filter expr

تنها چاپ سیستم‌فایل‌هایی که شرایط مشخص‌شده توسط عبارت expr را برآورده می‌کنند.

این قابلیت به صورت آزمایشی (EXPERIMENTAL) است. همچنین scols-filter(5) را ببینید. برای مثال، گنجاندن xfs با بیش از ۵۰٪ فضای آزاد:

findmnt -Q 'INO.USED < INO.AVAIL && FSTYPE == "xfs"'

-R, --submounts

چاپ بازگشتی تمام اتصالات فرعی برای سیستم‌فایل‌های انتخاب‌شده. محدودیت‌های تعریف‌شده توسط گزینه‌های -t، -O، -S، -T و --direction روی اتصالات فرعی اعمال نمی‌شوند. تمام اتصالات فرعی همواره با ترتیبی درخت‌مانند چاپ می‌شوند. این گزینه قالب خروجی درخت‌مانند را به‌طور پیش‌فرض فعال می‌کند. این گزینه هیچ اثری برای --mtab یا --fstab ندارد.

-r, --raw

استفاده از قالب خروجی خام (raw). تمام نویسه‌های بالقوه ناامن به‌صورت هگزادسیمال اسکیپ می‌شوند (\x<code>).

توجه داشته باشید که ستون SOURCES از سلول‌های چندخطی استفاده می‌کند. در این موارد، این ستون ممکن است رشته‌های بیشتری را در همان خط تولید کند.

--real

تنها چاپ سیستم‌فایل‌های واقعی.

-S, --source spec

تعریف صریح مبدأ اتصال (mount source). مشخصه‌های پشتیبانی‌شده عبارتند از: device، maj:min، LABEL=label، UUID=uuid، PARTLABEL=label و PARTUUID=uuid.

-s, --fstab

جستجو در /etc/fstab. خروجی در قالب فهرستی است (گزینه --list را ببینید).

-T, --target path

تعریف هدف اتصال (mount target). اگر path یک پرونده یا دایرکتوری نقطه اتصال نباشد، findmnt عناصر path را به ترتیب معکوس بررسی می‌کند تا به نقطه اتصال برسد (این قابلیت تنها هنگام جستجو در پرونده‌های هسته پشتیبانی می‌شود و برای --fstab پشتیبانی نمی‌شود). توصیه می‌شود هنگامی که بررسی عناصر path ناخواسته است و path یک نقطه اتصال به‌طور دقیق مشخص‌شده است، از گزینه --mountpoint استفاده کنید.

-t, --types list

محدود کردن مجموعه سیستم‌فایل‌های چاپ‌شده. می‌توان بیش از یک نوع را در یک فهرست جداشده با کاما مشخص کرد. فهرست انواع سیستم‌فایل می‌تواند دارای پیشوند no باشد تا مشخص کند روی کدام نوع سیستم‌فایل‌ها نباید هیچ اقدامی انجام شود. برای جزئیات بیشتر به mount(8) مراجعه کنید.

--tree

فعال‌سازی خروجی درخت‌مانند در صورت امکان. این گزینه برای جدول‌هایی که رابطه فرزند-والد در آن‌ها وجود ندارد (مانند fstab) نادیده گرفته می‌شود.

--shadowed

تنها چاپ سیستم‌فایل‌هایی که توسط یک سیستم‌فایل دیگر پوشانده شده‌اند.

-U, --uniq

نادیده گرفتن سیستم‌فایل‌ها با اهداف اتصال تکراری، و در نتیجه نادیده گرفتن مؤثر نقاط اتصال پوشانده‌شده.

-u, --notruncate

عدم کوتاه‌سازی متن در ستون‌ها. حالت پیش‌فرض، عدم کوتاه‌سازی ستون‌های TARGET، SOURCE، UUID، LABEL، PARTUUID و PARTLABEL است. این گزینه کوتاه‌سازی متن را در تمام ستون‌های دیگر نیز غیرفعال می‌کند.

-v, --nofsroot

عدم چاپ [/dir] در ستون SOURCE برای اتصالات bind یا زیرحجم‌های btrfs.

-w, --timeout milliseconds

تعیین حد بالای زمان مسدود شدن --poll بر حسب میلی‌ثانیه.

-x, --verify

بررسی محتوای جدول اتصالات. حالت پیش‌فرض، بررسی قابلیت تجزیه و کاربردپذیری /etc/fstab است. امکان استفاده از این گزینه همراه با --tab-file نیز وجود دارد. می‌توان مبدأ (دستگاه) یا هدف (نقطه اتصال) را برای فیلتر کردن جدول اتصالات مشخص کرد. گزینه --verbose دستور findmnt را ملزم به چاپ جزئیات بیشتر می‌کند.

--verbose

وادار ساختن findmnt به چاپ اطلاعات بیشتر (در حال حاضر تنها برای --verify).

--vfs-all

هنگام استفاده با ستون VFS-OPTIONS، تمام پرچم‌های VFS (مستقل از نوع سیستم‌فایل) را چاپ می‌کند. این گزینه برای اهداف بازرسی طراحی شده است تا گزینه‌های اتصال پیش‌فرض هسته VFS را که معمولاً فهرست نمی‌شوند نیز نشان دهد.

-y, --shell

نام ستون به‌گونه‌ای اصلاح می‌شود که تنها شامل نویسه‌های مجاز برای شناسه‌های متغیرهای پوسته (shell) باشد. این ویژگی برای مثال همراه با --pairs قابل استفاده است. توجه داشته باشید که این ویژگی در نگارش 2.37 به‌طور خودکار برای --pairs فعال بود، اما به دلیل مسائل سازگاری، اکنون لازم است این رفتار با --shell درخواست شود.

-h, --help

نمایش متن راهنما و خروج.

-V, --version

نمایش نگارش و خروج.

وضعیت خروج (EXIT STATUS)

مقدار خروج در صورتی که موردی برای نمایش وجود داشته باشد 0 است، و در صورت بروز هرگونه خطا 1 خواهد بود (برای مثال اگر بر اساس فیلتر مشخص‌شده توسط کاربر هیچ سیستم‌فایلی یافت نشود، یا مسیر دستگاه یا نقطه اتصال وجود نداشته باشد).