mandb - δημιουργία ή ενημέρωση των δεικτών της βάσης δεδομένων των σελίδων εγχειριδίου
ΣΥΝΤΑΚΤΙΚΟ
mandb [-dqsucpt?V] [-C file] [manpath]
mandb [-dqsut] [-C file] -f filename ...
ΠΕΡΙΓΡΑΦΗ
Η εντολή mandb χρησιμοποιείται για την αρχικοποίηση ή την χειροκίνητη ενημέρωση των δεικτών της βάσης δεδομένων. Οι δείκτες περιέχουν πληροφορίες σχετικά με την τρέχουσα κατάσταση του συστήματος των σελίδων εγχειριδίου και οι πληροφορίες που είναι αποθηκευμένες σε αυτούς χρησιμοποιούνται από τα βοηθητικά προγράμματα man-db για την ενίσχυση της ταχύτητας και της λειτουργικότητάς τους.
Κατά τη δημιουργία ή την ενημέρωση ενός δείκτη, η εντολή mandb προειδοποιεί για κακές αιτήσεις .so ROFF, λανθασμένα ονόματα αρχείων σελίδων εγχειριδίου και σελίδες εγχειριδίου από τις οποίες δεν μπορεί να αναλυθεί η εντολή 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> του παραβιαστικού συνδέσμου.
<filename>: κακός συμβολικός σύνδεσμος ή αίτηση .so ROFF
Το <filename> είναι είτε ένας συμβολικός σύνδεσμος προς, είτε περιέχει μια αίτηση συμπερίληψης ROFF προς, ένα ανύπαρκτο αρχείο.
<filename>: αγνοείται λανθασμένο όνομα αρχείου
Το <filename> μπορεί ή όχι να είναι μια έγκυρη σελίδα εγχειριδίου, αλλά το όνομά του είναι άκυρο. Αυτό συνήθως οφείλεται σε μια σελίδα εγχειριδίου με επεκτειμένη ενότητα <x> που έχει τοποθετηθεί στην ενότητα σελίδας εγχειριδίου <y>.
<filename_mask>: ανταγωνιστικές επεκτάσεις
Η χρήση εwildcard <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).
ΣΥΓΓΡΑΦΕΙΣ
Wilf. (_)
Fabrizio Polacco (_)
Colin Watson (_)
ΣΦΑΛΜΑΤΑ
https://gitlab.com/man-db/man-db/-/issues
https://savannah.nongnu.org/bugs/?group=man-db