mandb - إنشاء أو تحديث ذاكرات فهرس صفحات الدليل
ملخص
mandb [-dqsucpt?V] [-C file] [manpath]
mandb [-dqsut] [-C file] -f filename ...
الوصف
يُستخدم mandb لتهيئة أو تحديث ذاكرات فهرس قاعدة البيانات يدويًا. تحتوي الذاكرات على معلومات ذات صلة بالحالة الحالية لنظام صفحة الدليل، وتُستخدم المعلومات المخزنة داخلها بواسطة أدوات man-db لتعزيز سرعتها ووظائفها.
عند إنشاء أو تحديث فهرس، سيحذر mandb من طلبات ROFF غير الصحيحة في ملف .so، وأسماء ملفات صفحات الدليل غير الصحيحة، وصفحات الدليل التي لا يمكن تحليل ما هي (whatis) منها.
يمكن لـ mandb أن يقبل مسارًا مفصولاً بعلامات النقطتين (:) كخيار، مما سيتجاوز مسار التسلسل الهرمي الداخلي لنظام صفحة الدليل، والذي يتم تحديده من المعلومات الموجودة داخل ملف تكوين man-db.
ذاكرات قاعدة البيانات
يمكن تجميع mandb مع دعم أي من أنواع قواعد البيانات التالية.
الاسم غير متزامن اسم الملف
Berkeley db نعم index.bt
GNU gdbm نعم index.db
UNIX ndbm لا index.(dir|pag)
توفر أنواع قواعد البيانات التي تدعم التحديثات غير المتزامنة سرعة محسنة على حساب احتمال حدوث تلف في حالة حدوث إنهاء غير عادي. في حالة نادرة حيث حدث هذا، قد يكون من الضروري تشغيل mandb مرة أخرى باستخدام الخيار -c لإعادة إنشاء قواعد البيانات من البداية.
الخيارات
-d، --debug
اطبع معلومات التصحيح.
-q، --quiet
لا تُصدر أي تحذيرات.
-s، --no-straycats
لا تضيع الوقت في البحث عن أو إضافة معلومات إلى قواعد البيانات الخاصة بالقطط الضالة.
-p، --no-purge
لا تضيع الوقت في التحقق من صفحات الدليل المحذوفة وإزالتها من قواعد البيانات.
-c، --create
افتراضيًا، سيحاول mandb تحديث أي قواعد بيانات تم إنشاؤها مسبقًا. إذا لم تكن قاعدة البيانات موجودة، فسيقوم بإنشائها. يجبر هذا الخيار mandb على حذف قواعد البيانات السابقة وإعادة إنشائها من البداية، ويتضمن --no-purge. قد يكون هذا ضروريًا إذا أصبحت قاعدة البيانات تالفة أو إذا تم تقديم مخطط تخزين قاعدة بيانات جديد في المستقبل.
-u، --user-db
إنشاء قواعد بيانات المستخدم فقط، حتى مع وجود أذونات كتابة ضرورية لإنشاء قواعد بيانات النظام.
-t، --test
إجراء فحوصات صحة على صفحات الدليل في مسار التسلسل الهرمي. مع هذا الخيار، لن يقوم mandb بتغيير قواعد البيانات الموجودة.
-f، --filename
تحديث الإدخالات لاسم الملف المحدد فقط. هذا الخيار ليس للاستخدام العام؛ يتم استخدامه داخليًا بواسطة man عندما تم تجميعه مع خيار MAN_DB_UPDATES ووجد أن الصفحة قديمة. يتضمن -p ويعطل -c و -s.
-C file، --config-file=file
استخدم ملف تكوين المستخدم هذا بدلاً من ملف ~/.manpath الافتراضي.
-?، --help
اعرض رسالة الاستخدام ثم اخرج.
--usage
اطبع رسالة استخدام قصيرة واخرج.
-V، --version
اعرض الإصدار، ثم اخرج.
حالة الخروج
0 تنفيذ البرنامج بنجاح.
1 خطأ في الاستخدام أو بناء الجملة أو ملف التكوين.
2 خطأ تشغيلي.
3 فشل عملية فرعية.
التشخيصات
يمكن إصدار رسائل التحذير التالية أثناء بناء قاعدة البيانات.
<filename>: فشل تحليل whatis للصفحة (sec)
فشل محاولة استخراج سطر (أو أسطر) whatis من <filename> المحدد. عادةً ما يكون هذا بسبب صفحة دليل مكتوبة بشكل سيئ، ولكن إذا تم إصدار العديد من هذه الرسائل، فمن المحتمل أن يحتوي النظام على صفحات دليل غير قياسية غير متوافقة مع محلل whatis الخاص بـ man-db. انظر قسم WHATIS PARSING في lexgrog(1) لمزيد من المعلومات.
<filename>: رابط رمزي معلق
<filename> غير موجود ولكنه مشير إليه بواسطة رابط رمزي. عادةً ما يتم إصدار المزيد من التشخيصات لتحديد اسم ملف الرابط المخالف.
<filename>: رابط رمزي أو طلب ROFF غير صحيح في ملف .so
<filename> هو إما رابط رمزي لـ، أو يحتوي على طلب تضمين ROFF لـ، ملف غير موجود.
<filename>: تجاهل اسم ملف غير صالح
قد يكون <filename> صفحة دليل صالحة أو لا، ولكن اسمه غير صالح. عادةً ما يكون هذا بسبب صفحة دليل ذات امتداد قسم <x> موضوعة في قسم صفحة الدليل <y>.
<filename_mask>: امتدادات متنافسة
علامة النجمة <filename_mask> ليست فريدة. عادةً ما يكون هذا بسبب وجود نسخة مضغوطة وغير مضغوطة من نفس صفحة الدليل. يتم تجاهل جميع النسخ باستثناء الأحدث.
الملفات
/etc/manpath.config
ملف تكوين man-db.
/var/cache/man/index.(bt|db|dir|pag)
ذاكرة تخزين مؤقت عالمية متوافقة مع FHS لقاعدة البيانات الفهرس.
تشمل المواقع الأقدم لذاكرة التخزين المؤقت لقاعدة البيانات:
/usr/man/index.(bt|db|dir|pag)
ذاكرة تخزين مؤقت عالمية تقليدية لقاعدة البيانات الفهرس.
/var/catman/index.(bt|db|dir|pag)
ذاكرة تخزين مؤقت عالمية بديلة أو متوافقة مع FSSTND لقاعدة البيانات الفهرس.
انظر أيضًا
lexgrog(1)، man(1)، manpath(5)، catman(8)
يتم الآن تضمين قسم WHATIS PARSING الذي كان في السابق في صفحة الدليل هذه في lexgrog(1).
الأخطاء
https://gitlab.com/man-db/man-db/-/issues
https://savannah.nongnu.org/bugs/?group=man-db