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.

المؤلفين

انظر أيضاً

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

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

لتقارير العِلل، استخدم

التوفر

الأمر findmnt جزء من حزمة util-linux التي يمكن تنزيلها من