FINDMNT(8) إدارة النظام FINDMNT(8)

الاسم

findmnt - العثور على نظام ملفات

موجز

findmnt [خيارات]

findmnt [خيارات] ‎جهاز|‎نقطة_الوصل

findmnt [خيارات] [--source] جهاز [--target مسار|--mountpoint نقطة_الوصل]

الوصف

سيسرد findmnt جميع أنظمة الملفات الموصولة أو يبحث عن نظام ملفات. يستطيع الأمر findmnt البحث في /etc/fstab، أو /etc/mtab، أو /proc/self/mountinfo. إذا لم يُحدد جهاز أو نقطة_الوصل، فستُعرض جميع أنظمة الملفات.

يمكن تحديد الجهاز عن طريق اسم الجهاز، أو الأرقام الرئيسية والثانوية، أو لصيقة نظام الملفات أو معرفه الفريد (UUID)، أو لصيقة القسم أو معرفه الفريد. لاحظ أن findmnt يتبع سلوك mount(8) حيث يمكن تفسير اسم الجهاز كنقطة وصل (والعكس صحيح) إذا لم تُحدد الخيارات --target، أو --mountpoint، أو --source.

يقبل خيار سطر الأوامر --target أي ملف أو دليل، ومن ثم يعرض findmnt نظام الملفات للمسار المحدد.

يطبع الأمر جميع أنظمة الملفات الموصولة بتنسيق شبيه بالشجرة مبدئيًا. المخرجات المبدئية عرضة للتغيير. لذا، كلما أمكن، يجب تجنب استخدام المخرجات المبدئية في برمجياتك (scripts). حدد دائمًا الأعمدة المتوقعة صراحةً باستخدام --output columns-list في البيئات التي تتطلب مخرجات ثابتة.

العلاقة بين الأجهزة الكتلية وأنظمة الملفات ليست دائمًا علاقة واحد لواحد. قد يستخدم نظام الملفات أكثر من جهاز كتلي. لهذا السبب يوفر findmnt عمودي SOURCE و SOURCES (للجمع). يعرض عمود SOURCES جميع الأجهزة التي يمكن العثور فيها على نفس المعرف الفريد (UUID) لنظام الملفات (أو وسم آخر محدد في fstab عند التنفيذ مع --fstab و --evaluate).

الخيارات

-A، --all

عطّل جميع المرشحات المدمجة واطبع جميع أنظمة الملفات.

-a، --ascii

استخدم محارف ascii لتنسيق الشجرة.

-b، --bytes

اطبع الأحجام بالبايت بدلاً من الصيغة السهلة القراءة للبشر.

مبدئياً، تُعرض الأحجام بوحدات هي قوى لـ 1024 بايت. الاختصارات الرسمية لهذه الوحدات (KiB، MiB، GiB، ...) تُختصر لاحقاً إلى حرفها الأول فقط: K، M، G، ....

-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 كلمة

اتجاه البحث، إما forward (للأمام) أو backward (للخلف).

-e، --evaluate

حوّل جميع الأوسمة (LABEL أو UUID أو PARTUUID أو PARTLABEL) إلى أسماء الأجهزة المقابلة لعمود SOURCE. إنه موقف غير معتاد، ولكن قد يتكرر نفس الوسم (يُستخدم لأكثر من جهاز). لهذا الغرض، يوجد عمود SOURCES (للجمع). يعرض هذا العمود عبر خلية متعددة الأسطر جميع الأجهزة التي اكتُشف فيها الوسم بواسطة libblkid. هذا الخيار له معنى بالنسبة لملف fstab فقط.

-F، --tab-file مسار

ابحث في ملف بديل. إذا استُخدم مع --fstab أو --mtab أو --kernel، فإنه يتخطى المسارات المبدئية. إذا حُدد أكثر من مرة، فسيُعطل الإخراج الشجري (راجع خيار --list).

-f، --first-only

اطبع أول نظام ملفات مطابق فقط.

-H، --list-columns

يسرد الأعمدة التي يمكن تحديدها بالخيار ‎--output‎. يمكن استخدامه مع ‎--json‎ أو ‎--raw‎ للحصول على القائمة بتنسيق مقروء آلياً.

--hyperlink[=متى]

اطبع المسارات كروابط تشعبية للطرفية. يمكن أن يكون معامل متى الاختياري always أو never أو auto. وإذا حُذف المعامل، فسيُضبط مبدئياً على auto، مما يعني أن الروابط التشعبية ستُستخدم فقط عندما يذهب المخرج إلى طرفية.

-I، --dfi

حاكِ مخرج df(1) مع خياره -i. هذا الخيار يكافئ -o SOURCE,FSTYPE,INO.TOTAL,INO.USED,INO.AVAIL,INO.USE%,TARGET لكنه يستثني كل أنظمة الملفات الزائفة. استخدم --all لطباعة كل أنظمة الملفات.

-i، --invert

اعكس منطق المطابقة.

--id رقم

اختر نظام ملفات باستخدام معرف عقدة الوصل.

--uniq-id رقم

اختر نظام ملفات باستخدام معرف عقدة الوصل ذي 64 بت، واستخدمه مع خيار --kernel=listmount.

-J، --json

استخدم تنسيق مخرجات JSON.

-k، --kernel[=الأسلوب]

يقرأ معلومات عن أنظمة الملفات من النواة. هذا هو المخرج المبدئي. التنسيق شجري ويتضمن فقط خيارات الوصل التي تديرها النواة (راجع أيضاً --mtab).

المعطى الاختياري الأسلوب مدعوم فقط في الصيغة الطويلة (--kernel). الصيغة القصيرة (-k) تستخدم أسلوب mountinfo مبدئياً للتوافقية مع الإصدارات السابقة. الأساليب المدعومة يمكن أن تكون إما:

•mountinfo - هذا هو الأسلوب المبدئي ويقرأ البيانات من ملف /proc/self/mountinfo.
•listmount - هذا أسلوب تجريبي يستخدم نداءات النظام listmount(2) و statmount(2) لتوليد جدول الوصل. قد لا يحتوي المخرج على كل التفاصيل حول عقد الوصل (على سبيل المثال، SOURCE مفقود حالياً).

-l، --list

استخدم تنسيق مخرج القائمة. يُفعل تنسيق المخرج هذا آلياً إذا قُيد المخرج بالخيارات -t أو -O أو -S أو -T ولم يُستخدم الخيار --submounts أو إذا حُدد أكثر من ملف مصدر (الخيار -F).

-M، --mountpoint مسار

حدد صراحة ملف أو دليل نقطة الوصل. راجع أيضاً --target.

-m، --mtab

ابحث في /etc/mtab. يكون المخرج بتنسيق القائمة مبدئياً (راجع --tree). قد يتضمن المخرج خيارات وصل مساحة المستخدم.

-N، --task tid

استخدم مساحة أسماء بديلة /proc/<tid>/mountinfo بدلاً من المبدئية /proc/self/mountinfo. إذا حُدد الخيار أكثر من مرة، يُعطل المخرج الشجري (راجع خيار --list). راجع أيضاً أمر unshare(1).

-n، --noheadings

عدم طباعة سطر الترويسة.

-O، --options قائمة

قيد مجموعة أنظمة الملفات المطبوعة. يمكن تحديد أكثر من خيار واحد في قائمة مفصولة بفاصلة. الخياران -t و -O تراكميان في الأثر. يختلف هذا عن -t في أن كل خيار يطابق تماماً؛ والسابقة no في البداية ليس لها معنى عام. يمكن استخدام "no" للعناصر الفردية في القائمة. يمكن تعطيل تفسير بادئة "no" بواسطة البادئة "+".

-o، --output قائمة

حدد أعمدة المخرج. راجع مخرج --help للحصول على قائمة بالأعمدة المتاحة حالياً. يحتوي عمود TARGET على تنسيق شجري إذا لم تُحدد الخيارات --list أو --raw.

يمكن تمديد القائمة المبدئية للأعمدة إذا حُددت قائمة في التنسيق +list (على سبيل المثال، findmnt -o +PROPAGATION).

--output-all

أخرج تقريباً كل الأعمدة المتاحة. الأعمدة التي تتطلب --poll غير مضمنة.

-P، --pairs

أنتج المخرج على شكل أزواج مفتاح="قيمة". كل محارف القيم غير الآمنة المحتملة تُهرب ست عشرياً (\x<code>). راجع أيضاً خيار --shell.

لاحظ أن عمود SOURCES يستخدم خلايا متعددة الأسطر. في هذه الحالات، يستخدم العمود تنسيقاً يشبه المصفوفة في المخرج، على سبيل المثال name=("aaa" "bbb" "ccc").

-p، --poll[=القائمة]

راقب التغييرات في ملف /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

اطبع أنظمة الملفات الزائفة فقط.

-Q، --filter تعبير

اطبع فقط أنظمة الملفات التي تستوفي الشروط المحددة بواسطة التعبير (expr).

هذه الميزة تجريبية. راجع أيضاً scols-filter(5). على سبيل المثال، تضمين xfs الذي يحتوي على مساحة فارغة تزيد عن 50%:

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

-R، --submounts

اطبع تكرارياً كل عمليات الوصل الفرعية لأنظمة الملفات المحددة. لا تُطبق القيود المحددة بالخيارات -t و -O و -S و -T و --direction على عمليات الوصل الفرعية. تُطبع دائماً جميع عمليات الوصل الفرعية بترتيب شجري. يُفعل هذا الخيار تنسيق الإخراج الشجري بشكل مبدئي. ليس لهذا الخيار تأثير على --mtab أو --fstab.

-r، --raw

استخدم تنسيق الإخراج الخام. تُهرب جميع المحارف التي قد تكون غير آمنة ستة عشرياً (\x<code>).

لاحظ أن العمود SOURCES يستخدم خلايا متعددة الأسطر. في هذه الحالات، قد ينتج عن العمود سلاسل نصية أكثر في نفس السطر.

--real

اطبع أنظمة الملفات الحقيقية فقط.

-S، --source spec

حدد مصدر الوصل صراحةً. المواصفات المتاحة هي جهاز، و maj:min، و LABEL=لصيقة، و UUID=uuid، و PARTLABEL=لصيقة و PARTUUID=uuid.

-s، --fstab

ابحث في /etc/fstab. يكون الإخراج بتنسيق القائمة (راجع --list).

--shadowed

طباعة أنظمة الملفات التي وُصل فوقها نظام ملفات آخر فقط.

-T، --target مسار

حدد هدف الوصل. إذا لم يكن مسار ملف أو دليل لنقطة وصل، فإن findmnt يفحص عناصر مسار بترتيب عكسي للحصول على نقطة الوصل (هذه الميزة متاحة فقط عند البحث في ملفات النواة وغير متاحة لـ --fstab). يُنصح باستخدام الخيار --mountpoint عندما يكون فحص عناصر مسار غير مرغوب فيه وكان مسار نقطة وصل محددة بدقة.

-t، --types قائمة

يقيد مجموعة أنظمة الملفات المطبوعة. يمكن تحديد أكثر من نوع في قائمة مفصولة بفاصلات. يمكن بادئة قائمة أنواع أنظمة الملفات بكلمة no لتحديد أنواع أنظمة الملفات التي لا ينبغي اتخاذ أي إجراء بشأنها. لمزيد من التفاصيل، راجع mount(8).

--tree

يفعّل المخرجات الشجرية إذا كان ذلك ممكنًا. تُتجاهل هذه الخيارات بصمت في الجداول التي تفتقر إلى علاقة الابن بالأصل (مثل fstab).

-U، --uniq

يتجاهل أنظمة الملفات ذات أهداف الوصل المتكررة، مما يؤدي فعليًا إلى تخطي نقاط الوصل الموصولة فوق غيرها.

-u، --notruncate

لا تبتر النص في الأعمدة. المبدئي هو عدم بتر أعمدة TARGET، و SOURCE، و UUID، و LABEL، و PARTUUID، و PARTLABEL. هذا الخيار يعطل بتر النص في كل الأعمدة الأخرى أيضاً.

-v، --nofsroot

لا تطبع [/dir] في عمود SOURCE لعمليات الوصل المربوطة (bind mounts) أو الأحجام الفرعية لـ btrfs.

--verbose

يجبر findmnt على طباعة المزيد من المعلومات (--verify فقط حاليًا).

--vfs-all

عند استخدامه مع عمود VFS-OPTIONS، يطبع جميع أعلام VFS (المستقلة عن نظام الملفات). صُمم هذا الخيار لأغراض المراجعة لإدراج خيارات وصل نواة VFS المبدئية أيضًا والتي لا تُدرج عادةً.

-w، --timeout مللي_ثانية

حدد حداً أقصى للوقت الذي سيحجبه --poll، بالملي ثانية.

-x، --verify

يفحص محتوى جدول الوصل. الإجراء المبدئي هو التحقق من قابلية /etc/fstab للتحليل والاستخدام. يمكن استخدام هذا الخيار أيضًا مع --tab-file. يمكن تحديد المصدر (الجهاز) أو الهدف (نقطة الوصل) لتصفية جدول الوصل. يجبر الخيار --verbose الأداة findmnt على طباعة المزيد من التفاصيل.

-y، --shell

سيعُدل اسم العمود ليحتوي فقط على المحارف المسموح بها لمعرفات متغيرات الصدفة. هذا مفيد، على سبيل المثال، مع --pairs. لاحظ أن هذه الميزة فُعّلت آليًا للخيار --pairs في الإصدار 2.37، ولكن بسبب مشكلات التوافق، أصبح من الضروري الآن طلب هذا السلوك عبر --shell.

-h، --help

اعرض نص المساعدة ثم اخرج.

-V، --version

اعرض الإصدار واخرج.

حالة الخروج

قيمة الخروج هي 0 إذا كان هناك ما يُعرض، أو 1 عند حدوث أي خطأ (على سبيل المثال إذا لم يُعثر على نظام ملفات بناءً على مواصفات مرشح المستخدم، أو إذا كان مسار الجهاز أو نقطة الوصل غير موجودين).

البيئة

LIBMOUNT_FSTAB=<مسار>

يتخطى الموقع المبدئي لملف fstab

LIBMOUNT_MTAB=<مسار>

يتخطى الموقع المبدئي لملف mtab

LIBMOUNT_DEBUG=all

يفعّل مخرجات تنقيح libmount

LIBSMARTCOLS_DEBUG=all

يُفعّل مخرجات تصحيح أخطاء libsmartcols.

LIBSMARTCOLS_DEBUG_PADDING=on

يستخدم محارف حشو مرئية.

أمثلة

findmnt --fstab -t nfs

يطبع جميع أنظمة ملفات NFS المعرفة في /etc/fstab.

findmnt --fstab /mnt/foo

يُطبع كافة نظم الملفات في /etc/fstab حيث دليل نقطة الوصل هو /mnt/foo. كما تُطبع نقاط الوصل المربوطة (bind mounts) حيث /mnt/foo هو المصدر.

findmnt --fstab --target /mnt/foo

يُطبع كافة نظم الملفات في /etc/fstab حيث دليل نقطة الوصل هو /mnt/foo.

findmnt --fstab --evaluate

يُطبع كافة نظم الملفات في /etc/fstab وتُحوّل وسوم LABEL=‎ و UUID=‎ إلى أسماء الأجهزة الحقيقية.

findmnt -n --raw --evaluate --output=target LABEL=/boot

تُطبع نقطة الوصل فقط حيث وُصل نظام الملفات ذو اللصيقة "/boot".

findmnt --poll --mountpoint /mnt/foo

يُراقب الوصل، والفصل، وإعادة الوصل، والنقل على /mnt/foo.

findmnt --poll=umount --first-only --mountpoint /mnt/foo

يُنظر فصل /mnt/foo.

findmnt --poll=remount -t ext3 -O ro

تُراقب عمليات إعادة الوصل إلى وضع القراءة فقط على كافة نظم ملفات ext3.

المؤلفين

Karel Zak <kzak@redhat.com>

انظر أيضاً

fstab(5)، mount(8) scols-filter(5)

التبليغ عن الأخطاء

لتقارير العِلل، استخدم مُتتبع المشكلات https://github.com/util-linux/util-linux/issues.

التوفر

الأمر findmnt جزء من حزمة util-linux التي يمكن تنزيلها من أرشيف نواة لينكس https://www.kernel.org/pub/linux/utils/util-linux/.

2026-05-18 util-linux 2.42.1