'\" t
.\"     Title: whereis
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-05-18
.\"    Manual: أوامر المستخدم
.\"    Source: util-linux 2.42.1
.\"  Language: English
.\"
.TH "WHEREIS" "1" "2026-05-18" "util\-linux 2.42.1" "أوامر المستخدم"
.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 "الاسم"
whereis \- تحديد موقع ملفات البرنامج الثنائي والمصدر وصفحة الدليل لأمر ما
.SH "موجز"
.sp
\fBwhereis\fP [خيارات] [\fB\-BMS\fP \fIدليل\fP.\|.\|. \fB\-f\fP] \fIاسم\fP.\|.\|.
.SH "الوصف"
.sp
يحدد \fBwhereis\fP موقع ملفات الثنائي والمصدر والدليل لأسماء الأوامر المحددة. \fBتُجرد الأسماء المزودة أولاً من مكونات مسار المسار البادئة\fP. كما يتم التعامل مع البادئات من نوع \fBs.\fP الناتجة عن استخدام التحكم في كود المصدر. ثم يحاول \fBwhereis\fP تحديد موقع البرنامج المطلوب في أماكن لينكس القياسية، وفي الأماكن المحددة بواسطة \fB$PATH\fP و \fB$MANPATH\fP.
.sp
قيود البحث (الخيارات \fB\-b\fP و \fB\-m\fP و \fB\-s\fP) تراكمية وتطبق على أنماط \fIاسم\fP اللاحقة في سطر الأوامر. أي قيد بحث جديد يعيد ضبط قناع البحث. على سبيل المثال،
.RS 3
.ll -.6i
.sp
\fBwhereis \-bm ls tr \-m gcc\fP
.br
.RE
.ll
.sp
يبحث عن ثنائيات وصفحات دليل "ls" و "tr"، وعن صفحات دليل "gcc" فقط.
.sp
الخيارات \fB\-B\fP و \fB\-M\fP و \fB\-S\fP تعيد ضبط مسارات البحث لأنماط \fIاسم\fP اللاحقة. على سبيل المثال،
.RS 3
.ll -.6i
.sp
\fBwhereis \-m ls \-M /usr/share/man/man1 \-f cal\fP
.br
.RE
.ll
.sp
يبحث عن صفحات دليل "\fBls\fP" في جميع المسارات المبدئية، ولكن عن "cal" في الدليل \fI/usr/share/man/man1\fP فقط.
.SH "الخيارات"
.sp
\fB\-b\fP
.RS 4
البحث عن الثنائيات.
.RE
.sp
\fB\-m\fP
.RS 4
البحث عن الكتيبات (manuals).
.RE
.sp
\fB\-s\fP
.RS 4
البحث عن المصادر.
.RE
.sp
\fB\-u\fP
.RS 4
إظهار أسماء الأوامر التي تحتوي على مدخلات غير عادية فقط. يُقال إن الأمر غير عادي إذا لم يكن له مدخل واحد فقط من كل نوع مطلوب صراحة. وبذلك، فإن \*(Aq\fBwhereis \-m \-u *\fP\*(Aq يطلب تلك الملفات في الدليل الحالي التي ليس لها ملف توثيق، أو لها أكثر من ملف.
.RE
.sp
\fB\-B\fP \fIقائمة\fP
.RS 4
قصر الأماكن التي يبحث فيها \fBwhereis\fP عن الثنائيات، عبر قائمة مجلدات مفصولة بمسافات.
.RE
.sp
\fB\-M\fP \fIقائمة\fP
.RS 4
قصر الأماكن التي يبحث فيها \fBwhereis\fP عن الكتيبات والتوثيق بتنسيق Info، عبر قائمة مجلدات مفصولة بمسافات.
.RE
.sp
\fB\-S\fP \fIقائمة\fP
.RS 4
قصر الأماكن التي يبحث فيها \fBwhereis\fP عن المصادر، بواسطة قائمة أدلة مفصولة بمسافات بيضاء.
.RE
.sp
\fB\-f\fP
.RS 4
ينهي قائمة الأدلة ويشير إلى بدء أسماء الملفات. \fIيجب\fP استخدامه عند استخدام أي من الخيارات \fB\-B\fP أو \fB\-M\fP أو \fB\-S\fP.
.RE
.sp
\fB\-l\fP
.RS 4
إخراج قائمة مسارات البحث الفعلية التي يستخدمها \fBwhereis\fP. عند عدم تحديد أي من \fB\-B\fP أو \fB\-M\fP أو \fB\-S\fP، سيخرج هذا الخيار المسارات المضمنة التي استطاع الأمر العثور عليها في النظام.
.RE
.sp
\fB\-g\fP
.RS 4
تفسير الأسماء التالية كأنماط \fBglob(7)\fP. يقارن \fBwhereis\fP دائماً أسماء الملفات فقط (المعروفة باسم basename) ولا يقارن المسار الكامل أبداً. ليس لاستخدام أسماء الأدلة في النمط أي تأثير. لا تنس أن الصدفة تفسر النمط عند تحديده في سطر الأوامر دون علامات اقتباس. من الضروري استخدام علامات الاقتباس لـ \fIاسم\fP، على سبيل المثال:
.RE
.RS 3
.ll -.6i
.sp
.if n .RS 4
.nf
.fam C
whereis \-g \*(Aqfind*\*(Aq
.fam
.fi
.if n .RE
.br
.RE
.ll
.sp
\fB\-h\fP، \fB\-\-help\fP
.RS 4
اعرض نص المساعدة ثم اخرج.
.RE
.sp
\fB\-V\fP، \fB\-\-version\fP
.RS 4
اعرض الإصدار واخرج.
.RE
.SH "مسارات البحث عن الملفات"
.sp
يحاول \fBwhereis\fP مبدئياً العثور على الملفات من مسارات مضمنة، والمعرفة بأنماط glob. يحاول الأمر استخدام محتويات متغيرات البيئة \fB$PATH\fP و \fB$MANPATH\fP كمسار بحث مبدئي. أسهل طريقة لمعرفة المسارات المستخدمة هي إضافة خيار القائمة \fB\-l\fP. تُعرض تأثيرات \fB\-B\fP و \fB\-M\fP و \fB\-S\fP مع \fB\-l\fP.
.SH "البيئة"
.sp
\fBWHEREIS_DEBUG\fP=all
.RS 4
يفعّل مخرجات التنقيح.
.RE
.SH "أمثلة"
.sp
للعثور على جميع الملفات في \fI/usr/bin\fP غير الموثقة في \fI/usr/man/man1\fP أو التي ليس لها مصدر في \fI/usr/src\fP:
.RS 3
.ll -.6i
.sp
\fBcd /usr/bin\fP
.br
\fBwhereis \-u \-ms \-M /usr/man/man1 \-S /usr/src \-f *\fP
.br
.RE
.ll
.SH "التبليغ عن الأخطاء"
.sp
لتقارير العِلل، استخدم \c
.URL "https://github.com/util\-linux/util\-linux/issues" "مُتتبع المشكلات" "."
.SH "التوفر"
.sp
الأمر \fBwhereis\fP جزء من حزمة util\-linux التي يمكن تنزيلها من \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "أرشيف نواة لينكس" "."