locate(1)

الاسم
plocate - ابحث عن الملفات بالاسم، بسرعة

موجز
plocate [خيار]... نمط...

الوصف
يجد plocate جميع الملفات على النظام المطابقة للنمط المعطى (أو جميع الأنماط إذا أُعطيت متعددة). يفعل ذلك بواسطة فهرس يُنشأ بواسطة updatedb(8) أو (بشكل أقل شيوعًا) يُحوّل من فهرس آخر بواسطة plocate-build(8).

plocate متوافق إلى حد كبير مع وسائط mlocate(1)، لكنه أسرع بشكل ملحوظ. على وجه الخصوص، نادرًا ما يحتاج إلى مسح قاعدة بياناته بالكامل، إلا إذا كان النمط قصيرًا جدًا (أقل من ثلاثة بايتات) أو أردت البحث عن تعبير نمطي. لا يحاول الحفاظ على التوافق مع BSD locate، أو أسماء الملفات والإعدادات المحلية غير UTF-8. معظم عمليات الإدخال/الإخراج تتم بشكل غير متزامن، لكن النتائج تُزامن بحيث يخرج الناتج بنفس الترتيب في كل مرة.

عند إعطاء أنماط متعددة، سيبحث plocate عن الملفات التي تطابق جميعها. هذا هو عدم التوافق الرئيسي مع mlocate(1)، الذي يبحث عن الملفات التي تطابق نمطًا واحدًا أو أكثر، ما لم يُعط الخيار -A.

مبدئيًا، تُعتبر الأنماط سلاسل فرعية للبحث عنها. إذا أُعطي حرف بدل عام واحد على الأقل غير مُهرب (*، ? أو [])، يُعتبر ذلك النمط بدلاً من ذلك نمطًا عامًا (مما يعني أنه يحتاج إلى البدء والانتهاء بـ * لمطابقة سلسلة فرعية). إذا أُعطي --regexp، تُعتبر الأنماط بدلاً من ذلك تعبيرات نمطية أساسية POSIX (غير مثبتة)، وإذا أُعطي --regex، تُعتبر الأنماط تعبيرات نمطية موسعة POSIX. كل هذا يطابق سلوك mlocate(1).

مثل mlocate(1)، يُظهر plocate جميع الملفات المرئية للمستخدم المستدعي (بفضل امتلاك أذونات القراءة والتنفيذ على جميع الدلائل الأم)، ولا شيء غير ذلك، عن طريق التشغيل مع تعيين بت setgid للوصول إلى الفهرس (الذي يُبنى كجذر)، لكن باختبار الرؤية كمستخدم مستدعي.

حالة الخروج
يخرج plocate بـ 0 للإشارة إلى أنه وُجد تطابق أو أن --help أو --version مُررت. خلاف ذلك، يخرج plocate برمز حالة 1، للإشارة إلى حدوث خطأ أو عدم وجود تطابقات.

الخيارات

-A، --all
    مُتجاهل للتوافق مع mlocate(1).

-b, --basename
    طابق فقط ضد جزء اسم الملف من اسم المسار، أي، ستُستبعد أسماء الدلائل من المطابقة (لكن تُطبع مع ذلك). هذا لا يُسرع البحث، لكن يمكنه كبت التطابقات غير المهمة.

-c، --count
    لا تطبع كل تطابق. بدلاً من ذلك، احسبها، واطبع عددًا إجماليًا في النهاية.

-d, --database مسار قاعدة البيانات
    ابحث عن تطابقات في قاعدة البيانات المعطاة، بدلاً من /var/lib/plocate/plocate.db. يمكن إعطاء هذه الوسيطة عدة مرات، للبحث في قواعد بيانات متعددة. من الممكن أيضًا إعطاء قواعد بيانات متعددة في وسيطة واحدة، مفصولة بـ :. (أي حرف، بما في ذلك : و \، يمكن تهريبه بإضافة \ قبله.)

-e, --existing
    اطبع فقط الإدخالات التي تشير إلى ملفات موجودة في وقت تشغيل locate. لاحظ أنه على عكس mlocate(1)، لا تُتبع الروابط الرمزية مبدئيًا (وبالفعل، لا يوجد خيار لتغيير هذا).

-i، --ignore-case
    قم بمطابقة غير حساسة لحالة الأحرف كما هو معطى بواسطة الإعداد المحلي الحالي (المبدئي هو مطابقة حساسة لحالة الأحرف، بايت ببايت). لاحظ أن plocate لا يدعم النطاق الكامل لقواعد طي حالة الأحرف Unicode؛ على وجه الخصوص، البحث عن ß لن يعطيك تطابقات على ss حتى في إعداد محلي ألماني. لاحظ أيضًا أن هذا الخيار سيكون أبطأ إلى حد ما من مطابقة حساسة لحالة الأحرف، لأنه يحتاج إلى توليد مرشحين أكثر للبحث في الفهرس.

-l, --limit حد
    توقف عن البحث بعد العثور على حد تطابقًا. إذا أُعطي --count، سيكون الرقم المطبوع على الأكثر حد.

-N، --literal
    اطبع أسماء الإدخالات دون اقتباس. عادةً، سيهرب plocate الأحرف الخاصة في أسماء الملفات، بحيث تكون آمنة للاستهلاك بواسطة الصدف النمطية (مشابه لأسلوب الاقتباس shell-escape-always في GNU coreutils)، ما لم يُطبع إلى أنبوب، لكن هذا الخيار سيعطل هذا الاقتباس.

-0، --null
    بدلاً من كتابة سطر جديد بعد كل تطابق، اكتب NUL (ASCII 0). هذا مفيد لإنشاء ناتج لا لبس فيه عندما يُعالج بواسطة أدوات أخرى (مثل xargs(1))، حيث يُسمح لأسماء الملفات باحتواء أسطر جديدة مضمنة.

-r, --regexp
    تُعتبر الأنماط تعبيرات نمطية أساسية POSIX. انظر regex(7) لمزيد من المعلومات. لاحظ أن هذا يُجبر مسحًا خطيًا عبر قاعدة البيانات بأكملها، وهو بطيء.

--regex
    مثل --regexp، لكن الأنماط تُعتبر بدلاً من ذلك تعبيرات نمطية POSIX موسعة.

-w, --wholename
    طابق ضد اسم المسار بالكامل. هذا هو المبدئي، لذا ما لم يُعط -b أولاً (انظر أعلاه)، لن يفعل شيئًا. هذا الخيار موجود فقط كتوافق مع mlocate(1).

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

--version
    اطبع معلومات الإصدار، ثم اخرج بنجاح.

البيئة

LOCATE_PATH
    إذا تم تقديمه، يُلحق بعد قائمة مسارات --database (سواء تم تقديم مسار صريح أو استخدام المبدئي). يتبع الفصل بنقطتين الرأسية وهروب الأحرف نفس القواعد المتبعة لـ --database.

المؤلف
ستينار إتش. غندرسون <steinar+plocate@gunderson.no>

انظر أيضًا
plocate-build(8)، mlocate(1)، updatedb(8)

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

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

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