.TH "WHEREIS" "1" "2026-06-16" "util\-linux 2.41.5" "دستورات کاربر"
.SH "نام (NAME)"
whereis \- یافتن فایل‌های دودویی، منبع و راهنمای یک دستور
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBwhereis\fP [\fIگزینه‌ها\fP] [\fB\-BMS\fP \fIدایرکتوری\fP.\|.\|. \fB\-f\fP] \fIنام\fP.\|.\|.
.SH "توضیحات (DESCRIPTION)"
.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 "گزینه‌ها (OPTIONS)"
.TP
\fB\-b\fP
جستجو برای فایل‌های دودویی.
.TP
\fB\-m\fP
جستجو برای صفحات راهنما.
.TP
\fB\-s\fP
جستجو برای فایل‌های منبع.
.TP
\fB\-u\fP
تنها نمایش نام دستوراتی که ورودی‌های غیرمعمول دارند. یک دستور زمانی غیرمعمول نامیده می‌شود که برای هر نوع درخواست‌شده به صورت صریح، دقیقاً یک ورودی نداشته باشد. بنابراین '\fBwhereis \-m \-u *\fP' فایل‌هایی از دایرکتوری جاری را درخواست می‌کند که فاقد فایل مستندات هستند، یا بیش از یک فایل دارند.
.TP
\fB\-B\fP \fIفهرست\fP
محدود کردن مکان‌هایی که \fBwhereis\fP در آن‌ها به دنبال فایل‌های دودویی می‌گردد، با فهرستی از دایرکتوری‌ها که با فاصله از هم جدا شده‌اند.
.TP
\fB\-M\fP \fIفهرست\fP
محدود کردن مکان‌هایی که \fBwhereis\fP در آن‌ها به دنبال فایل‌های راهنما و مستندات در قالب Info می‌گردد، با فهرستی از دایرکتوری‌ها که با فاصله از هم جدا شده‌اند.
.TP
\fB\-S\fP \fIفهرست\fP
محدود کردن مکان‌هایی که \fBwhereis\fP در آن‌ها به دنبال فایل‌های منبع می‌گردد، با فهرستی از دایرکتوری‌ها که با فاصله از هم جدا شده‌اند.
.TP
\fB\-f\fP
پایان دادن به فهرست دایرکتوری‌ها و اعلام شروع نام فایل‌ها. استفاده از این گزینه هنگام به‌کارگیری هر یک از گزینه‌های \fB\-B\fP، \fB\-M\fP یا \fB\-S\fP \fIالزامی\fP است.
.TP
\fB\-l\fP
چاپ فهرست مسیرهای جستجوی مؤثری که \fBwhereis\fP استفاده می‌کند. زمانی که هیچ‌یک از گزینه‌های \fB\-B\fP، \fB\-M\fP یا \fB\-S\fP مشخص نشده باشند، این گزینه مسیرهای ثابتی (hard-coded) را که دستور موفق به یافتن آن‌ها در سیستم شده است نمایش می‌دهد.
.TP
\fB\-g\fP
تفسیر نام‌های بعدی به عنوان الگوهای \fBglob(7)\fP. دستور \fBwhereis\fP همواره فقط نام فایل‌ها (نام پایه یا basename) را مقایسه می‌کند و هرگز مسیر کامل را نمی‌سنجد. استفاده از نام دایرکتوری در الگو هیچ اثری ندارد. فراموش نکنید که پوسته الگو را هنگام تعیین در خط فرمان بدون نقل‌قول تفسیر می‌کند. استفاده از نقل‌قول برای \fIنام\fP الزامی است؛ برای مثال:
.RS 3
.ll -.6i
.sp
.if n .RS 4
.nf
.fam C
whereis \-g \(aqfind*\(aq
.fam
.fi
.if n .RE
.br
.RE
.ll
.TP
\fB\-h\fP, \fB\-\-help\fP
نمایش متن راهنما و خروج.
.TP
\fB\-V\fP, \fB\-\-version\fP
نمایش اطلاعات نسخه و خروج.
.SH "مسیرهای جستجوی فایل (FILE SEARCH PATHS)"
.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 "محیط (ENVIRONMENT)"
.TP
\fBWHEREIS_DEBUG\fP=all
فعال‌سازی خروجی اشکال‌زدایی (دیباگ).
.SH "مثال‌ها (EXAMPLES)"
.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 "گزارش باگ‌ها (REPORTING BUGS)"
.sp
برای گزارش باگ‌ها از سامانه پیگیری اشکالات استفاده کنید:
.RS 4
.UR https://github.com/util\-linux/util\-linux/issues
سامانه پیگیری اشکالات
.UE
.RE
.SH "دسترس‌پذیری (AVAILABILITY)"
.sp
دستور \fBwhereis\fP بخشی از بسته util\-linux است که می‌توان آن را از آرشیو کرنل لینوکس دانلود کرد:
.RS 4
.UR https://www.kernel.org/pub/linux/utils/util\-linux
Linux Kernel Archive
.UE
.RE
.SH "همچنین ببینید (SEE ALSO)"
.BR find (1),
.BR type (1),
.BR which (1),
.BR glob (7)