الاسم

whereis - تحديد موقع ملفات البرنامج الثنائي والمصدر وصفحة الدليل لأمر ما

موجز

whereis [خيارات] [-BMS دليل... -f] اسم...

الوصف

يحدد whereis موقع ملفات الثنائي والمصدر والدليل لأسماء الأوامر المحددة. تُجرد الأسماء المزودة أولاً من مكونات مسار المسار البادئة. كما يتم التعامل مع البادئات من نوع s. الناتجة عن استخدام التحكم في كود المصدر. ثم يحاول whereis تحديد موقع البرنامج المطلوب في أماكن لينكس القياسية، وفي الأماكن المحددة بواسطة $PATH و $MANPATH.

قيود البحث (الخيارات -b و -m و -s) تراكمية وتطبق على أنماط اسم اللاحقة في سطر الأوامر. أي قيد بحث جديد يعيد ضبط قناع البحث. على سبيل المثال،

whereis -bm ls tr -m gcc

يبحث عن ثنائيات وصفحات دليل "ls" و "tr"، وعن صفحات دليل "gcc" فقط.

الخيارات -B و -M و -S تعيد ضبط مسارات البحث لأنماط اسم اللاحقة. على سبيل المثال،

whereis -m ls -M /usr/share/man/man1 -f cal

يبحث عن صفحات دليل "ls" في جميع المسارات المبدئية، ولكن عن "cal" في الدليل /usr/share/man/man1 فقط.

الخيارات

-b

البحث عن الثنائيات.

-m

البحث عن الكتيبات (manuals).

-s

البحث عن المصادر.

-u

إظهار أسماء الأوامر التي تحتوي على مدخلات غير عادية فقط. يُقال إن الأمر غير عادي إذا لم يكن له مدخل واحد فقط من كل نوع مطلوب صراحة. وبذلك، فإن 'whereis -m -u *' يطلب تلك الملفات في الدليل الحالي التي ليس لها ملف توثيق، أو لها أكثر من ملف.

-B قائمة

قصر الأماكن التي يبحث فيها whereis عن الثنائيات، عبر قائمة مجلدات مفصولة بمسافات.

-M قائمة

قصر الأماكن التي يبحث فيها whereis عن الكتيبات والتوثيق بتنسيق Info، عبر قائمة مجلدات مفصولة بمسافات.

-S قائمة

قصر الأماكن التي يبحث فيها whereis عن المصادر، بواسطة قائمة أدلة مفصولة بمسافات بيضاء.

-f

ينهي قائمة الأدلة ويشير إلى بدء أسماء الملفات. يجب استخدامه عند استخدام أي من الخيارات -B أو -M أو -S.

-l

إخراج قائمة مسارات البحث الفعلية التي يستخدمها whereis. عند عدم تحديد أي من -B أو -M أو -S، سيخرج هذا الخيار المسارات المضمنة التي استطاع الأمر العثور عليها في النظام.

-g

تفسير الأسماء التالية كأنماط glob(7). يقارن whereis دائماً أسماء الملفات فقط (المعروفة باسم basename) ولا يقارن المسار الكامل أبداً. ليس لاستخدام أسماء الأدلة في النمط أي تأثير. لا تنس أن الصدفة تفسر النمط عند تحديده في سطر الأوامر دون علامات اقتباس. من الضروري استخدام علامات الاقتباس لـ اسم، على سبيل المثال:

whereis -g 'find*'

-h، --help

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

-V، --version

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

مسارات البحث عن الملفات

يحاول whereis مبدئياً العثور على الملفات من مسارات مضمنة، والمعرفة بأنماط glob. يحاول الأمر استخدام محتويات متغيرات البيئة $PATH و $MANPATH كمسار بحث مبدئي. أسهل طريقة لمعرفة المسارات المستخدمة هي إضافة خيار القائمة -l. تُعرض تأثيرات -B و -M و -S مع -l.

البيئة

WHEREIS_DEBUG=all

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

أمثلة

للعثور على جميع الملفات في /usr/bin غير الموثقة في /usr/man/man1 أو التي ليس لها مصدر في /usr/src:

cd /usr/bin
whereis -u -ms -M /usr/man/man1 -S /usr/src -f *

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

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

التوفر

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