ΟΝΟΜΑ
man - μορφοποίηση και εμφάνιση των εγχειριδίων σε απευθείας σύνδεση
manpath - προσδιορισμός της πορείας αναζήτησης χρήστη για σελίδες man
ΣΥΝΟΨΗ
man [ -acdfFhkKtwW ] [ --path ] [ -m σύστημα ] [ -p συμβολοσειρά ] [ -C config_file ] [ -Μ λίστα διαδρομών ] [ -P pager ] [ -S section_list ] όνομα [ τμήμα ] ...
ΠΕΡΙΓΡΑΦΗ
man μορφές και εμφανίζει τις σε απευθείας σύνδεση εγχειρίδιο σελίδες. Εάν ορίσετε ενότητα , ο άνθρωπος εμφανίζεται μόνο σε εκείνη την ενότητα του εγχειριδίου. το όνομα είναι συνήθως το όνομα της σελίδας εγχειριδίου, που είναι συνήθως το όνομα μιας εντολής, μιας λειτουργίας ή ενός αρχείου. Ωστόσο, αν το όνομα περιέχει μια κάθετο ( / ) τότε ο άνθρωπος το ερμηνεύει ως προδιαγραφή αρχείου, έτσι ώστε να μπορείτε να κάνετε τον άνθρωπο ./foo.5 ή ακόμα και τον άνθρωπο /cd/foo/bar.1.gz .
Δείτε παρακάτω για μια περιγραφή του πού ο άνθρωπος αναζητά τα αρχεία σελίδας χειροκίνητα.
ΕΠΙΛΟΓΕΣ
-C config_file
Καθορίστε το αρχείο διαμόρφωσης που θέλετε να χρησιμοποιήσετε. η προεπιλογή είναι /etc/man.config . (Δείτε man.conf (5).)
-Μ διαδρομή
Καθορίστε τη λίστα των καταλόγων για να αναζητήσετε σελίδες ανθρώπου. Διαχωρίστε τους καταλόγους με ορθογώνια. Ένας κενός κατάλογος είναι ο ίδιος με τον μη προσδιορισμό καθόλου -M . Ανατρέξτε στην ενότητα ΑΝΑΖΗΤΗΣΗ ΑΝΑΖΗΤΗΣΗΣ ΓΙΑ ΧΕΙΡΟΚΙΝΗΜΑΤΑ
-P pager
Καθορίστε ποια συσκευή τηλεειδοποίησης θα χρησιμοποιήσει. Αυτή η επιλογή υπερισχύει της μεταβλητής περιβάλλοντος MANPAGER , η οποία με τη σειρά της υπερισχύει της μεταβλητής PAGER . Από προεπιλογή, ο άνθρωπος χρησιμοποιεί το / usr / bin / less -isr .
-S λίστα_αρχείων
Η λίστα είναι μια λίστα χωριστών κόμβων με χειροκίνητες ενότητες για αναζήτηση. Αυτή η επιλογή αντικαθιστά τη μεταβλητή περιβάλλοντος MANSECT .
-ένα
Από προεπιλογή, ο άνθρωπος θα βγει μετά την εμφάνιση της πρώτης σελίδας που εντοπίζει. Χρησιμοποιώντας αυτήν την επιλογή, ο άνθρωπος θα εμφανίσει όλες τις σελίδες χειρισμού που ταιριάζουν με το όνομα, όχι μόνο την πρώτη.
-ντο
Αναμορφώστε τη σελίδα πηγαίου κώδικα, ακόμα και όταν υπάρχει μια ενημερωμένη σελίδα γάτας . Αυτό μπορεί να έχει νόημα εάν η σελίδα γάτας έχει μορφοποιηθεί για μια οθόνη με διαφορετικό αριθμό στηλών ή εάν η προμορφωμένη σελίδα είναι κατεστραμμένη.
-ρε
Στην πραγματικότητα δεν εμφανίζονται οι σελίδες του man, αλλά εκτυπώνετε πληροφορίες σχετικά με την αποσφαλμάτωση.
-ΡΕ
Και οι δύο πληροφορίες απεικόνισης και εκτύπωσης.
-φά
Ισοδύναμο με whatis .
-F ή -preformat
Μόνο μορφοποίηση - δεν εμφανίζεται.
-h
Εκτυπώστε ένα μήνυμα βοήθειας μιας γραμμής και έξοδο.
-κ
Ισοδύναμο με apropos .
-Κ
Αναζήτηση για την καθορισμένη συμβολοσειρά σε σελίδες * all * man. Προειδοποίηση: αυτό είναι πιθανόν πολύ αργό! Βοηθάει στον προσδιορισμό μιας ενότητας. (Ακριβώς για να δώσω μια γενική ιδέα, στη μηχανή μου διαρκεί περίπου ένα λεπτό ανά 500 man pages.)
-m
Καθορίστε ένα εναλλακτικό σύνολο σελίδων που θα αναζητήσετε με βάση το όνομα συστήματος που δίνεται.
-p συμβολοσειρά
Καθορίστε την ακολουθία προεπεξεργαστών που θα τρέξει πριν από το nroff ή το troff . Όχι όλες οι εγκαταστάσεις θα έχουν μια πλήρη σειρά προεπεξεργαστών. Μερικοί από τους προεπεξεργαστές και τα γράμματα που χρησιμοποιούνται για τον προσδιορισμό τους είναι: eqn (e), grap (g), pic (p), tbl (t), vgrind (v), αναφέρονται (r). Αυτή η επιλογή υπερισχύει της μεταβλητής περιβάλλοντος MANROFFSEQ .
-t
Χρησιμοποιήστε το / usr / bin / groff -Tps -mandoc για να μορφοποιήσετε τη σελίδα του εγχειριδίου, μεταβιβάζοντας την έξοδο στο stdout. Η έξοδος από το / usr / bin / groff -Tps -mandoc ενδέχεται να χρειαστεί να περάσει από κάποιο φίλτρο ή άλλο πριν να εκτυπωθεί.
-w ή - διαδρομή
Μην εμφανίζετε πραγματικά τις σελίδες του χρήστη, αλλά εκτυπώνετε τις θέσεις των αρχείων που θα μορφοποιηθούν ή θα εμφανιστούν. Εάν δεν δίνεται κανένα επιχείρημα: εμφάνιση (στο stdout) της λίστας των καταλόγων που αναζητά ο άνθρωπος για τις σελίδες man. Αν το manpath είναι ένας σύνδεσμος με τον άνθρωπο, τότε το "manpath" είναι ισοδύναμο με το "man-path".
-W
Όπως -w, αλλά εκτυπώνετε ονόματα αρχείων ανά γραμμή, χωρίς πρόσθετες πληροφορίες. Αυτό είναι χρήσιμο στις εντολές κελύφους όπως ο άνθρωπος - ο άνθρωπος | xargs ls -l
ΚΑΤΗΓΟΡΙΕΣ ΣΕΛ
Ο άνθρωπος θα προσπαθήσει να αποθηκεύσει τις μορφοποιημένες σελίδες man, προκειμένου να εξοικονομήσει χρόνο μορφοποίησης την επόμενη φορά που χρειάζονται αυτές οι σελίδες. Παραδοσιακά, οι μορφοποιημένες εκδόσεις των σελίδων στο DIR / manX αποθηκεύονται σε DIR / catX, αλλά άλλες αντιστοιχίσεις από το dir man σε cat dir μπορούν να καθοριστούν στο /etc/man.config . Δεν αποθηκεύονται σελίδες γάτας όταν δεν υπάρχει ο απαιτούμενος κατάλογος γατών. Δεν αποθηκεύονται σελίδες γάτας όταν μορφοποιούνται για μήκος γραμμής διαφορετικό από 80. Δεν αποθηκεύονται σελίδες γάτας όταν το man.conf περιέχει τη γραμμή NOCACHE.
Είναι δυνατό να γίνει ο άνθρωπος suid σε έναν άνθρωπο χρήστη. Στη συνέχεια, εάν ένας κατάλογος γάτας έχει τον άνθρωπο ιδιοκτήτη και τη λειτουργία 0755 (μόνο εγγράψιμο από τον άνθρωπο), και τα αρχεία γάτας έχουν τον άνθρωπο ιδιοκτήτη και τον τρόπο λειτουργίας 0644 ή 0444 (μόνο εγγράψιμο από τον άνθρωπο ή μη εγγράψιμο καθόλου), κανένας απλός χρήστης δεν μπορεί να αλλάξει σελίδες γάτας ή να θέσετε άλλα αρχεία στον κατάλογο γάτας. Εάν ο άνθρωπος δεν είναι suid, τότε ένας κατάλογος γάτα θα πρέπει να έχει τη λειτουργία 0777, αν όλοι οι χρήστες θα πρέπει να μπορούν να αφήσουν τις σελίδες γάτας εκεί.
Η επιλογή -c αναγκάζει τη μορφοποίηση μιας σελίδας, ακόμη και αν υπάρχει πρόσφατη σελίδα γάτας.
ΑΝΑΖΗΤΗΣΗ PATH ΓΙΑ ΧΕΙΡΟΚΙΝΗΜΑΤΑ
ο άνθρωπος χρησιμοποιεί μια εξελιγμένη μέθοδο εύρεσης μη αυτόματων αρχείων σελίδας, με βάση τις επιλογές επίκλησης και τις μεταβλητές περιβάλλοντος, το αρχείο ρυθμίσεων /etc/man.config και κάποιες ενσωματωμένες συμβάσεις και ευρετικά.
Πρώτα απ 'όλα, όταν το όρισμα του ονόματος για τον άνθρωπο περιέχει μια κάθετο ( / ), ο άνθρωπος υποθέτει ότι είναι μια προδιαγραφή αρχείου η ίδια και δεν υπάρχει αναζήτηση που να εμπλέκεται.
Αλλά στη συνήθη περίπτωση όπου το όνομα δεν περιέχει μια κάθετο, ο άνθρωπος αναζητά μια ποικιλία καταλόγων για ένα αρχείο που θα μπορούσε να είναι μια σελίδα με το εγχειρίδιο για το θέμα που ονομάζεται.
Εάν καθορίσετε την επιλογή -M λίστα διαδρομών , η λίστα διαδρομών είναι μια λίστα διαχωρισμένων με κόλον των καταλόγων που αναζητά ο άνθρωπος .
Αν δεν καθορίσετε το -M, αλλά ρυθμίσετε τη μεταβλητή περιβάλλοντος MANPATH , η τιμή αυτής της μεταβλητής είναι η λίστα των καταλόγων που αναζητά ο άνθρωπος .
Εάν δεν καθορίσετε μια λίστα ρητών διαδρομών με -M ή MANPATH , ο άνθρωπος αναπτύσσει τη δική του λίστα διαδρομών βάσει των περιεχομένων του αρχείου διαμόρφωσης /etc/man.config . Οι εντολές MANPATH στο αρχείο ρυθμίσεων αναγνωρίζουν συγκεκριμένους καταλόγους που συμπεριλαμβάνονται στη διαδρομή αναζήτησης.
Επιπλέον, οι καταστάσεις MANPATH_MAP προσθέτουν στη διαδρομή αναζήτησης ανάλογα με τη διαδρομή αναζήτησης εντολών (δηλ. Τη μεταβλητή περιβάλλοντος PATH ). Για κάθε κατάλογο που μπορεί να βρίσκεται στη διαδρομή αναζήτησης εντολών, μια εντολή MANPATH_MAP καθορίζει έναν κατάλογο ο οποίος πρέπει να προστεθεί στη διαδρομή αναζήτησης για αρχεία σελίδας χειροκίνητα. ο άνθρωπος εξετάζει τη μεταβλητή PATH και προσθέτει τους αντίστοιχους καταλόγους στη διαδρομή αναζήτησης αρχείου σελίδας χειροκίνητης. Επομένως, με τη σωστή χρήση του MANPATH_MAP , όταν εκδίδετε την εντολή man xyz , λαμβάνετε μια σελίδα με το εγχειρίδιο για το πρόγραμμα που θα εκτελεστεί αν εκδώσετε την εντολή xyz .
Επιπλέον, για κάθε κατάλογο της διαδρομής αναζήτησης εντολών (ονομάζεται "κατάλογος εντολών") για τον οποίο δεν έχετε μια δήλωση MANPATH_MAP , ο άνθρωπος αναζητά αυτόματα έναν κατάλογο μη αυτόματης σελίδας "κοντινό" δηλαδή έναν υποκατάλογο στον κατάλογο τον ίδιο τον κατάλογο εντολών ή στον γονικό κατάλογο του καταλόγου εντολών.
Μπορείτε να απενεργοποιήσετε τις αυτόματες "κοντινές" αναζητήσεις συμπεριλαμβάνοντας μια δήλωση NOAUTOPATH στο /etc/man.config .
Σε κάθε κατάλογο της διαδρομής αναζήτησης, όπως περιγράφεται παραπάνω, ο άνθρωπος αναζητά ένα αρχείο που ονομάζεται θέμα . , με ένα προαιρετικό επίθημα στον αριθμό του τμήματος και ενδεχομένως ένα επίθημα συμπίεσης. Αν δεν βρει ένα τέτοιο αρχείο, τότε εμφανίζεται σε οποιονδήποτε υποκατάλογο που ονομάζεται man N ή cat N όπου N είναι ο αριθμός μη αυτόματου τμήματος. Εάν το αρχείο βρίσκεται σε έναν υποκατάλογο cat N , ο άνθρωπος θεωρεί ότι είναι ένα μορφοποιημένο αρχείο μη αυτόματης σελίδας (σελίδα γάτας). Διαφορετικά, ο άνθρωπος υποθέτει ότι δεν είναι μορφοποιημένος. Σε κάθε περίπτωση, αν το όνομα αρχείου έχει γνωστό συμπλήρωμα συμπίεσης (όπως .gz ), ο άνθρωπος υποθέτει ότι είναι gzipped.
Αν θέλετε να δείτε πού (ή αν) ο άντρας θα βρει τη σελίδα χειροκίνητου για ένα συγκεκριμένο θέμα, χρησιμοποιήστε την επιλογή -path ( -w ).
Σημαντικό: Χρησιμοποιήστε την εντολή man ( % man ) για να δείτε πώς χρησιμοποιείται μια εντολή στον υπολογιστή σας.