Skip to main content

Man - Linux Command

Mastering Linux Man Pages - A Definitive Guide (Juni- 2026)

Mastering Linux Man Pages - A Definitive Guide (Juni- 2026)
Anonim

Man formatteert en geeft de on-line handleidingpagina's weer. Als u opgeeft sectie , man ziet alleen in dat deel van de handleiding. Naam is normaal gesproken de naam van de handleidingpagina, meestal de naam van een opdracht, functie of bestand. Echter, als naam bevat een schuine streep (/) danmaninterpreteert het als een bestandsspecificatie zodat je het kunt doenman ./foo.5 of zelfsman /cd/foo/bar.1.gz. Zie hieronder voor een beschrijving van waarman zoekt naar de handmatige paginabestanden.

Naam

man - formatteer en toon de on line handleidingpagina'smanpath - bepaal het zoekpad van gebruikers voor man-pagina's

Korte inhoud

man-acdfFhkKtwW --pad -m systeem -p draad -C config_file -M pathlist -P pieper -S section_list sectie naam …

opties

-C config_file

Geef het configuratiebestand op dat moet worden gebruikt; de standaard is/etc/man.config. (Zienman.conf(5).)

-M pad

Geef de lijst met mappen op om naar manpagina's te zoeken. Scheid de mappen met dubbele punten. Een lege lijst is hetzelfde als niet opgeven-M helemaal niet. ZienZOEK PAD VOOR HANDMATIGE PAGINA'S.

-P pager

Geef op welke pager moet worden gebruikt. Deze optie overschrijft deMANPAGER omgevingsvariabele, die op zijn beurt dePAGER variabel. Standaard,man toepassingen/ usr / bin / less -isr.

-S section_list

Lijst is een door dubbele punt gescheiden lijst van handmatige secties om te zoeken. Deze optie overschrijft deMANSECTomgevingsvariabele.

-een

Standaard,man zal afsluiten na het weergeven van de eerste handmatige pagina die het vindt. Het gebruik van deze optie dwingtman om alle handmatige pagina's weer te geven die overeenkomennaam,niet alleen de eerste.

-C

Formatteer de bronpagina opnieuw, ook als er een actuele kattenpagina bestaat. Dit kan zinvol zijn als de kattenpagina is opgemaakt voor een scherm met een ander aantal kolommen of als de voorgeformatteerde pagina is beschadigd.

-d

Geef de man-pagina's niet daadwerkelijk weer, maar druk wel klodders met foutopsporingsinformatie af.

-D

Zowel foutopsporingsinformatie weergeven en afdrukken.

-f

Gelijk aanwat is.

-F of--preformat

Alleen formatteren - niet weergeven.

-h

Druk een helpbericht met één regel af en verlaat het.

-k

Gelijk aana propos.

-K

Zoek naar de opgegeven reeks in * alle * man-pagina's. Waarschuwing: dit is waarschijnlijk erg traag! Het helpt om een ​​sectie op te geven. (Gewoon om een ​​ruw idee te geven, op mijn machine duurt dit ongeveer een minuut per pagina van 500 man.)

-m systeem

Geef een alternatieve set manpagina's op om te zoeken op basis van de opgegeven systeemnaam.

-p-reeks

Geef de reeks preprocessors op die eerder moet worden uitgevoerdnroff oftroff. Niet alle installaties hebben een volledige set preprocessors. Sommige van de preprocessors en de letters die worden gebruikt om ze aan te duiden zijn: eqn (e), grap (g), pic (p), tbl (t), vgrind (v), refer (r). Deze optie overschrijft deMANROFFSEQ omgevingsvariabele.

-t

Gebruik/ usr / bin / groff -Tps -mandoc om de handmatige pagina op te maken, waarbij de uitvoer wordt doorgegevenstdout. De uitvoer van/ usr / bin / groff -Tps -mandoc moet mogelijk door een of ander filter worden gepasseerd voordat deze wordt afgedrukt.

-wof --path

Geef de man-pagina's niet daadwerkelijk weer, maar druk wel de locatie (s) af van de bestanden die zouden worden opgemaakt of weergegeven. Als er geen argument wordt gegeven: display (op stdout) de lijst met directory's waarop wordt gezochtman voor manpagina's. Alsmanpath is een link naar de mens, dan is "manpath" gelijk aan "man - path."

-W

Graag -w, maar druk bestandsnamen één per regel af, zonder aanvullende informatie. Dit is handig in shell-opdrachten zoalsman - een man | xargs ls -l

CAT-pagina's

De mens zal proberen de opgemaakte manpagina's op te slaan, om opmaaktijd te besparen de volgende keer dat deze pagina's nodig zijn. Traditioneel worden geformatteerde versies van pagina's in DIR / manX opgeslagen in DIR / catX, maar andere toewijzingen van man naar kat kunnen worden gespecificeerd in/etc/man.config. Er worden geen kattenpagina's opgeslagen als de vereiste kattenmap niet bestaat. Er worden geen kattenpagina's opgeslagen als ze zijn opgemaakt voor een regellengte die verschilt van 80. Er worden geen kattenpagina's opgeslagen als man.conf de regel NOCACHE bevat.

Het is mogelijk om te makenman suid voor een gebruiker man. Als een cat directory eigenaar man en mode 0755 heeft (alleen beschrijfbaar door man), en de cat-bestanden eigenaar man en mode 0644 of 0444 hebben (alleen beschrijfbaar door de mens, of helemaal niet beschrijfbaar), kan geen enkele gewone gebruiker de kattenpagina's of plaats andere bestanden in de kattenmap. Alsman is niet suid gemaakt, dan zou een cat-directory modus 0777 moeten hebben als alle gebruikers daar cat-pagina's zouden moeten kunnen laten.

De optie-C forceert het opnieuw formatteren van een pagina, zelfs als er een recente kattenpagina bestaat.

Zoekpad voor handleidingen

man maakt gebruik van een geavanceerde methode voor het vinden van handmatige paginabestanden, gebaseerd op de aanroepopties en omgevingsvariabelen, de/etc/man.configconfiguratiebestand en enkele ingebouwde conventies en heuristieken.

Allereerst, wanneer het naam argument voorman bevat een schuine streep (/), man gaat ervan uit dat het een bestandsspecificatie zelf is en dat er niet wordt gezocht.

Maar in het normale geval waar naam bevat geen schuine streep,man doorzoekt verschillende mappen naar een bestand dat een handmatige pagina kan zijn voor het genoemde onderwerp.

Als u de. Opgeeft-M pathlist keuze, pathlist is een door dubbele punten gescheiden lijst van de mappen diemanzoekopdrachten.

Als u niet opgeeft-M maar stel deMANPATH omgevingsvariabele, de waarde van die variabele is de lijst met de mappen dieman zoekopdrachten.

Als u geen expliciete padlijst opgeeft met-M ofMANPATH, man ontwikkelt zijn eigen padlijst op basis van de inhoud van het configuratiebestand/etc/man.config. DeMANPATH instructies in het configuratiebestand identificeren bepaalde mappen die moeten worden opgenomen in het zoekpad.

Verder is deMANPATH_MAPinstructies toevoegen aan het zoekpad, afhankelijk van het zoekpad van uw opdracht (dat wil zeggen uwPADomgevingsvariabele). Voor elke map die zich in het opdrachtzoekpad bevindt, aMANPATH_MAP statement geeft een map aan die moet worden toegevoegd aan het zoekpad voor handmatige paginabestanden.man kijkt naar dePAD variabele en voegt de bijbehorende mappen toe aan het zoekpad van het handmatige paginabestand. Dus, met het juiste gebruik vanMANPATH_MAP, wanneer u de opdracht geeftman xyz, krijgt u een handmatige pagina voor het programma dat zou worden uitgevoerd als u de opdracht gafxyz.

Bovendien, voor elke directory in het zoekpad van de opdracht (we noemen het een "command-directory") waarvoor je het doet niet heb eenMANPATH_MAPuitspraak,man zoekt automatisch naar een handmatige paginadirectory "in de buurt" namelijk als submap in de commandomap zelf of in de bovenliggende directory van de commandomap.

U kunt de automatische "nabijgelegen" zoekopdrachten uitschakelen door eenNOAUTOPATH verklaring in/etc/man.config.

In elke directory in het zoekpad zoals hierboven beschreven,man zoekt naar een bestand met de naam onderwerp . sectie , met een optioneel achtervoegsel op het sectienummer en mogelijk een compressiesuffix. Als het zo'n bestand niet vindt, kijkt het in alle genoemde submappenman N ofkat N waar N is het nummer van de handleiding. Als het bestand een bestand iskat N subdirectory,man gaat ervan uit dat het een opgemaakt handmatig paginabestand is (kattenpagina). Anders,man gaat ervan uit dat het niet is geformatteerd. In beide gevallen, als de bestandsnaam een ​​bekend compressiesuffix heeft (zoals.gz), man neemt aan dat het is uitgezoomd.

Als je wilt zien waar (of als)man zou de handleiding voor een bepaald onderwerp vinden, gebruik de--pad(-w) keuze.

Belangrijk: Gebruik de man commando ( % man ) om te zien hoe een opdracht wordt gebruikt op uw specifieke computer.