NÉV
man-formátumban és megjeleníti az on-line man oldalakat
manpath - határozza meg a felhasználó keresési útvonalát a man oldalakon
SZINOPSZIS
ember [ -acdfFhkKtwW ] [ --path ] [ -m rendszer ] [ -p karakter ] [ -C config_file ] [ -M útvonallista ] [ -P pager ] [ -S szakasz_lista ] [ szakasz ] név ...
LEÍRÁS
man formátumokat és megjeleníti az on-line man oldalakat. Ha megadja a szakaszt , az ember csak a kézikönyvnek a részét látja. A név általában a manuális oldal neve, amely jellemzően egy parancs, függvény vagy fájl neve. Ha azonban a név egy perjelet ( / ) tartalmaz, akkor az ember fájlmeghatározásként értelmezi, így az ember ./foo.5 vagy akár az ember /cd/foo/bar.1.gz .
Lásd alább egy leírást, ahol az ember a kézi oldalfájlokat keresi.
LEHETŐSÉGEK
-C config_file
Adja meg a használni kívánt konfigurációs fájlt; az alapértelmezés az /etc/man.config . (Lásd man.conf (5).)
-M útvonal
Adja meg a könyvtárak listáját az ember oldalainak kereséséhez. Különítse el a könyvtárakat kettőspontokkal. Egy üres lista megegyezik azzal, hogy nem írja le a -M egyáltalán. Lásd KERESÉSI ÚTMUTATÓ MANUÁLIS OLDALAKHOZ .
-P pager
Adja meg, hogy melyik pager használja. Ez az opció felülbírálja a MANPAGER környezeti változót, amely felülírja a PAGER változót. Alapértelmezés szerint az ember az / usr / bin / less -isr parancsot használja .
-S szakasz_lista
A lista a kézi szakaszok kettősponttal elválasztott listája. Ez az opció felülbírálja a MANSECT környezeti változót.
-a
Alapértelmezés szerint az ember kilép, miután megjelenítette az általa talált első manuális oldalt. Ezzel az opcióval az ember kéri az összes olyan manuális oldalt, amely a nevet illeti, nem csak az első.
-c
Formázza újra a forrás man oldalát, még akkor is, ha létezik egy up-to-date macska oldal . Ez akkor lehet hasznos, ha a macska oldal formázott egy külön oszlopszámú képernyővel, vagy ha az előformázott oldal sérült.
-d
Ne jelenítse meg a man oldalakat, hanem nyomtasson hibaelhárítási információkat.
-D
Mind a megjelenítési, mind a nyomtatási hibakeresési információ.
-f
Az egyenértékű.
-F vagy --preformat
Csak formázás - nem jelenik meg.
-h
Egysoros súgóüzenetek nyomtatása és kilépés.
-k
Az egyenértékű.
-K
Keresse meg a megadott karakterláncot a * all * man oldalakon. Figyelmeztetés: ez valószínűleg nagyon lassú! Segítséget nyújt egy rész meghatározásához. (Csak azért, hogy durva ötletet adjak, a gépemen ez kb. Egy percet vesz 500 munkanaponként.)
-m rendszer
Adjon meg alternatív man oldalakat a megadott rendszernév alapján.
-p karakterlánc
Adja meg az előfeldolgozók sorrendjét, hogy a nroff vagy troff előtt fusson. Nem minden telepítés lesz teljes előfeldolgozó készlet. A preprocesszorok egy része és a kijelölésre használt betűk: eqn (e), grap (g), pic (p), tbl (t), vgrind (v), refer (r). Ez az opció felülírja a MANROFFSEQ környezeti változót.
-t
Használja a / usr / bin / groff -Tps -mandoc parancsot a manuális oldal formázásához, a kimenetnek a stdouthoz való továbbításával . A / usr / bin / groff -Tps -mandoc kimenetét át kell adni néhány szűrőn vagy másikon a nyomtatás előtt.
-w vagy --path
Ne jelenítse meg a man oldalakat, hanem nyomtassa ki a formázott vagy megjelenített fájlok helyét. Ha nincs argumentum megadva: megjeleníti (a stdouton) a könyvtárak listáját, amelyeket az ember az ember oldalakra keres. Ha az emberútvonal az emberhez kapcsolódik, akkor az "emberút" egyenértékű az "ember" útvonalon.
-W
Mint a -w, de nyomtat fájlneveket egy soronként, további információk nélkül. Ez hasznos a shell parancsokban, mint az ember -W man | xargs ls -l
CAT PAGES
Az ember megpróbálja menteni a formázott man oldalakat, hogy a formázási időt a következő alkalommal kelljen megmenteni. A DIR / manX lapok formázott változatai hagyományosan a DIR / catX mappába kerülnek mentésre, de az ember-dir-cat-könyvtárban található más leképezések az /etc/man.config címen találhatók . Nincs olyan macska oldal, amely a kívánt macskakönyvtár nem létezik. A macskák oldalainak mentése nem történik meg, ha a 80-tól eltérő vonalhosszúságú formátumot formázzák. A macska oldalak nem kerülnek mentésre, ha az man.conf tartalmazza a NOCACHE sort.
Lehetőség van arra, hogy az embert engedjük a felhasználónak. Ezután, ha a macskák könyvtárának tulajdonosa az embernek és a 0755-es módnak (csak az ember által írható), és a macska fájlok tulajdonosa az embernek és a 0644 vagy 0444 módnak (csak ember írható vagy nem írható), a szokásos felhasználó nem változtathatja meg macska oldalakat vagy más fájlokat a macska könyvtárba. Ha az ember nem lesz engedéllyel, akkor a macskák könyvtárának 0777-es módban kell lennie, ha minden felhasználónak képesnek kell lennie arra, hogy ott hagyja a macskák oldalát.
Az -c erő a -formázza az oldal újratervezését , még akkor is, ha egy újabb macskapont létezik.
KERESÉSI ÚTMUTATÓ MANUÁLIS OLDALAKHOZ
Az ember kifinomult módszert használ a kézi lapfájlok megtalálásához, az invokációs opciók és a környezeti változók, az /etc/man.config konfigurációs fájl, valamint néhány beépített konvenció és heurisztika alapján.
Először is, amikor az emberhez tartozó név- argumentum egy perjel ( / ) -et tartalmaz, az ember azt feltételezi, hogy maga a fájl specifikáció, és nincs keresés.
De abban az esetben, ha a név nem tartalmaz slash-et, az ember különböző könyvtárakat keres egy olyan fájlhoz, amely kézi lap lehet a megadott téma számára.
Ha megadja a -M pathlist opciót, akkor az elérési lista az ember által keresett könyvtárak kettősponttal elválasztott listája.
Ha nem adja meg a -M értéket, hanem a MANPATH környezeti változót állítja be, akkor az adott változó értéke azoknak a könyvtáraknak a listája, amelyeket az ember keres.
Ha nem ad meg explicit útvonal-listát a -M vagy a MANPATH paranccsal , az ember saját ütemtervet készít az /etc/man.config konfigurációs fájl tartalma alapján. A MANPATH utasítások a konfigurációs fájlban azonosítanak bizonyos könyvtárakat a keresési útvonalba.
Ezenkívül a MANPATH_MAP utasítások a keresési útvonalhoz hozzáadódnak (pl. A PATH környezeti változójától függően). A parancskeresési útvonalon található minden könyvtár esetében a MANPATH_MAP utasítás egy olyan könyvtárat határoz meg, amelyet a kézi oldalfájlok keresési útvonalához kell adni. az ember a PATH változót nézve hozzáadja a megfelelő könyvtárakat a kézi oldalfájl keresési útvonalához. Így a MANPATH_MAP megfelelő használatával, amikor kiadja az xyz parancsot, kap egy manuális oldalt a programhoz, amely akkor futna, ha kiadta az xyz parancsot.
Ezenkívül a parancskeresési útvonal minden egyes könyvtárához (amit "parancskönyvtárnak" nevezünk), amelyhez nincs MANPATH_MAP utasítás, az ember automatikusan keresi a "közeli" manuális oldaltárat , vagyis egy alkönyvtárat a a parancskönyvtárban vagy a parancskönyvtár szülő könyvtárában.
Letilthatja az automatikus "közeli" kereséseket azáltal, hogy az /etc/man.config fájlba bejelöli a NOAUTOPATH utasítást.
A keresési útvonal minden egyes könyvtárában a fent leírtak szerint az ember keres egy témát tartalmazó fájlt . szakasz , opcionális utótag a szekció számán és esetleg tömörítő utótag. Ha nem talál ilyen fájlt, akkor az N névvel vagy N típusban található N alkönyvtárakban jelenik meg, ahol N a kézi rész száma. Ha a fájl egy macska N alkönyvtárban található, akkor az ember azt feltételezi, hogy egy formázott manuális lapfájl (macska oldal). Egyébként az ember feltételezi, hogy nem formázott. Mindkét esetben, ha a fájlnévnek van egy ismert tömörítő utótagja (például .gz ), az ember azt feltételezi, hogy gzipped.
Ha meg szeretné tudni, hogy hol találja meg az ember az adott témakör kézi oldalát, akkor használja a --path ( -w ) beállítást.
Fontos: Az ember paranccsal ( % man ) tekintse meg, hogyan használják a parancsot az adott számítógépen.