الاسم¶

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 أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

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