WHICH(1)

الاسم
which - يعرض المسار الكامل لأوامر (الصدفة).

موجز
which [خيارات] [--] اسم_البرنامج [...]

الوصف
يأخذ Which معاملًا واحدًا أو أكثر. يطبع لكل معامل منها المسار الكامل للملفات التنفيذية التي كانت ستُنفذ لو أُدخل هذا المعامل في محث الصدفة، وذلك عبر البحث عن ملف تنفيذي أو بريمج في الأدلة المدرجة في متغير البيئة PATH باستخدام نفس خوارزمية bash(1).

وُلدت صفحة الدليل هذه من ملف which.texinfo.

الخيارات

--all، -a
    اطبع كافة الملفات التنفيذية المطابقة في PATH، وليس الأول فقط.

--read-alias، -i
    اقرأ الأسماء المستعارة من الدخل القياسي، وأبلغ عن المطابق منها في المخرج القياسي. يفيد هذا عند استخدامه مع اسم مستعار للأمر which نفسه. على سبيل المثال
    alias which='alias | which -i'.

--skip-alias
    تجاهل الخيار `--read-alias'، إن وُجد. يُفيد هذا الخيار في البحث صراحةً عن الملفات الثنائية العادية، مع استخدام الخيار `--read-alias' في اسم مستعار أو دالة مُخصصة لذلك.

--read-functions
    اقرأ تعريفات دالات الصدفة من الدخل القياسي، وأبلغ عن المطابق منها في المخرج القياسي. يفيد هذا عند استخدامه مع دالة صدفة للأمر which نفسه. على سبيل المثال:
    which() { declare -f | which --read-functions $@ }
    export -f which

--skip-functions
    تجاهل الخيار `--read-functions'، إن وُجد. يُفيد هذا الخيار في البحث صراحةً عن الملفات الثنائية العادية، مع استخدام الخيار `--read-functions' في اسم مستعار أو دالة مُخصصة لذلك.

--skip-dot
    تخطَّ الأدلة في PATH التي تبدأ بنقطة.

--skip-tilde
    تخطَّ الأدلة في PATH التي تبدأ بعلامة التلدة (~) والملفات التنفيذية التي تقع في دليل المنزل HOME.

--show-dot
    إذا بدأ دليل في PATH بنقطة ووُجد ملف تنفيذي مطابق لذلك المسار، فاطبع "./اسم_البرنامج" بدلاً من المسار الكامل.

--show-tilde
    أخرج علامة تلدة (~) عندما يطابق الدليل دليل المنزل HOME. يُتجاهل هذا الخيار عند استدعاء which كمستخدم جذر (root).

--tty-only
    توقف عن معالجة الخيارات على اليمين إذا لم يكن على tty.

--version، -v، -V
    اطبع معلومات الإصدار في المخرج القياسي ثم اخرج بنجاح.

--help
    اطبع معلومات الاستخدام في المخرج القياسي ثم اخرج بنجاح.

قيمة الإرجاع
Which تُرجع عدد الوسائط الفاشلة، أو -1 في حالة عدم وجود`programname'.

مثال
الطريقة الموصى بها لاستخدام هذه الأداة هي إضافة اسم مستعار (صدفة C) أو دالة صدفة (صدفة Bourne) للأمر which كالتالي:

[ba]sh:

which ()
{
  (alias; declare -f) | /usr/bin/which --tty-only --read-alias --read-functions --show-tilde --show-dot $@
}
export -f which

[t]csh:

alias which 'alias | /usr/bin/which --tty-only --read-alias --show-dot --show-tilde'

سيؤدي هذا إلى طباعة المسارات المقروءة ~/ و ./ عند تشغيل which من محثك، بينما يستمر في طباعة المسار الكامل عند استخدامه من بريمج:

> which q2
~/bin/q2
> echo `which q2`
/home/carlo/bin/q2

العلل
يُحدد دليل HOME بالبحث عن متغير البيئة HOME، ويتوقف البرنامج عند عدم وجود هذا المتغير. يعتبر Which دليلين متكافئين مختلفين عندما يحتوي أحدهما على مسار برابط رمزي.

المؤلف
Carlo Wood <carlo@gnu.org>

انظر أيضًا
bash(1)

ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي <zayed.alsaidi@gmail.com>

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 (https://www.gnu.org/licenses/gpl-3.0.html) أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: kde-l10n-ar@kde.org.