MAN(1) Rokasgramatu lapotaja riki MAN(1) NOSAUKUMS man - sistemas uzzinu rokasgramatu saskarne KOPSAVILKUMS man [man_opcijas] [[sadala] lapa ...] ... man -k [apropos_opcijas] regizt ... man -K [man_opcijas] [sadala] termins ... man -f [whatis opcijas] lapa ... man -l [man_opcijas] fails ... man -w|-W [man_opcijas] lapa ... APRAKSTS man ir sistemas rokasgramatu lapotajs. Katrs man padotais lapas arguments parasti ir programmas, utilitas vai funkcijas nosaukums. Pec tam tiek atrasta un paradita katram no siem argumentiem atbilstosa rokasgramatas lapa. Ja noradita sadala, man mekles tikai saja rokasgramatas sadala. Noklusejuma darbiba ir meklet visas pieejamajas sadalas ieprieks noteikta seciba (skatiet NOKLUSEJUMI) un radit tikai pirmo atrasto lapu, pat ja lapa eksiste vairakas sadalas. Zemak esosaja tabula paraditi rokasgramatas sadalu numuri un tajas ietverto lapu tipi. 1 Izpildamas programmas vai caulas komandas 2 Sistemas izsaukumi (kodola nodrosinatas funkcijas) 3 Biblioteku izsaukumi (programmu biblioteku funkcijas) 4 Ipasie faili (parasti atrodami /dev) 5 Failu formati un konvencijas, piem., /etc/passwd 6 Speles 7 Dazadi (ieskaitot makro pakotnes un konvencijas), piem., man(7), groff(7), man-pages(7) 8 Sistemas administresanas komandas (parasti tikai root) 9 Kodola rutinas [Nestandarta] Rokasgramatas lapa sastav no vairakam sadalam. Ierastie sadalu nosaukumi ir NAME, SYNOPSIS, CONFIGURATION, DESCRIPTION, OPTIONS, EXIT STATUS, RETURN VALUE, ERRORS, ENVIRONMENT, FILES, VERSIONS, STANDARDS, NOTES, BUGS, EXAMPLE, AUTHORS un SEE ALSO. Sis konvencijas attiecas uz sadalu KOPSAVILKUMS, un tas var izmantot ka vadlinijas ari citas sadalas. treknraksts rakstit tiesi ta, ka paradits. kursivs aizstat ar atbilstosu argumentu. [-abc] visi vai jebkuri argumenti [ ] iekspuse nav obligati. -a|-b ar | atdalitas opcijas nevar izmantot kopa. arguments ... argumentu var atkartot. [izteiksme] ... visu izteiksmi [ ] iekspuse var atkartot. Precizs attelojums var atskirties atkariba no izvades ierices. Piemeram, darbojoties terminali, man parasti nespes attelot kursivu un ta vieta parasti izmantos pasvitrotu vai krasainu tekstu. Komandas vai funkcijas ilustracija ir sablons, kam jaatbilst visiem iespejamiem izsaukumiem. Dazos gadijumos ieteicams ilustret vairakus savstarpeji izsledzosus izsaukumus, ka paradits sis rokasgramatas lapas sadala KOPSAVILKUMS. PIEMERI man ls Paradit rokasgramatas lapu vienumam (programmai) ls. man man.7 Paradit makro pakotnes man rokasgramatas lapu no sadalas 7. (Tas ir alternativs pieraksts komandai "man 7 man".) man 'man(7)' Paradit makro pakotnes man rokasgramatas lapu no sadalas 7. (Tas ir vel viens alternativs pieraksts komandai "man 7 man". Tas var but ertaks, kopejot un ielimejot atsauces uz rokasgramatas lapam. Nemiet vera, ka iekavas parasti jaliek pedinas, lai pasargatu tas no caulas.) man -a intro Paradit pec kartas visas rokasgramata esosas pieejamas intro rokasgramatas lapas. Starp secigam paradisanam var iziet vai izlaist jebkuru no tam. man -t bash | lpr -Pps Formatet bash rokasgramatas lapu noklusejuma troff vai groff formata un novadit to uz printeri ar nosaukumu ps. groff noklusejuma izvade parasti ir PostScript. man --help vajadzetu noradit, kurs procesors ir piesaistits opcijai -t. man -l -Tdvi ./foo.1x.gz > ./foo.1x.dvi Si komanda atspiedis un formates nroff avota rokasgramatas lapu ./foo.1x.gz no ierices neatkariga (dvi) faila. Novirzisana ir nepieciesama, jo karogs -T liek izvadi novirzit uz stdout bez lapotaja. Izvadi var skatit ar tadu programmu ka xdvi vai talak apstradat uz PostScript ar tadu programmu ka dvips. man -k printf Meklet isajos aprakstos un rokasgramatas lapu nosaukumos atslegvardu printf ka regularo izteiksmi. Izvadit visas atbilstibas. Lidzvertigs apropos printf. man -f smail Uzmeklet rokasgramatas lapas, uz kuram atsaucas smail, un izvadit visu atrasto isos aprakstus. Lidzvertigs whatis smail. PARSKATS man ir pieejamas daudzas opcijas, lai lietotajam nodrosinatu pec iespejas lielaku elastibu. Var mainit meklesanas celu, sadalu secibu, izvades procesoru un citas talak aprakstitas uzvedibas un darbibas. Ja iestatiti, tiek vaicati dazadi vides mainigie, lai noteiktu man darbibu. ,,Visaptveroso" mainigo $MANOPT var iestatit uz jebkuru virkni komandrindas formata, ar iznemumu, ka visam atstarpem, kas ir dala no opcijas argumenta, jaliek prieksa atpakalversta slipsvitra. man parses $MANOPT pirms savas komandrindas parsesanas. Opcijas, kuram nepieciesams arguments, tiks ignoretas par labu tam pasam komandrinda atrastajam opcijam. Lai atiestatitu visas $MANOPT iestatitas opcijas, ka pirmo komandrindas opciju var noradit -D. Tas laus man ,,aizmirst" par $MANOPT noraditajam opcijam, lai gan tam tomer jabut bijusam derigam. Rokasgramatas lapas parasti glaba nroff(1) formata tada direktorija ka /usr/share/man. Dazas instalacijas var but ari ieprieks formatetas cat lapas, lai uzlabotu veiktspeju. Kur sie faili tiek glabati, sikak skatiet manpath(5). Si pakotne atbalsta rokasgramatas lapas vairakas valodas, ko nosaka jusu lokale. Ja jusu sistema to neiestatija automatiski, jums var but jaiestata $LC_MESSAGES, $LANG vai cits no sistemas atkarigs vides mainigais, lai noraditu velamo lokali, parasti POSIX formata: [_[.[,]]] Ja velama lapa ir pieejama jusu lokale, ta tiks paradita standarta (parasti amerikanu anglu valodas) lapas vieta. Ja konstatejat, ka sis pakotnes tulkojumi nav pieejami jusu dzimtaja valoda, un velaties tos nodrosinat, ludzu, sazinieties ar uzturetaju, kas koordines sadu darbibu. Atseviskas rokasgramatas lapas parasti raksta un uztur to programmu, funkciju vai citu temu uzturetaji, kuras tas dokumente, un tas nav ieklautas saja pakotne. Ja konstatejat, ka kadas rokasgramatas lapas trukst vai ta ir nepietiekama, ludzu, zinojiet par to attiecigas pakotnes uzturetajiem. Informaciju par citam si rokasgramatu lapotaja funkcijam un paplasinajumiem ludzu lasiet pakotnei pievienotajos dokumentos. NOKLUSEJUMI Meklejamo sadalu secibu var mainit ar vides mainigo $MANSECT vai ar direktivu SECTION faila /etc/man_db.conf. Pec noklusejuma ta ir sada: 1 1p n l 8 3 3p 0 0p 2 3type 5 4 9 6 7 Formateta rokasgramatas lapa tiek paradita, izmantojot lapotaju. To var noradit vairakos veidos, preteja gadijuma tiek izmantots noklusejums (sikak skatiet opciju -P). Filtrus nosaka vairakos veidos. Vispirms tiek vaicata komandrindas opcija -p vai vides mainigais $MANROFFSEQ. Ja -p netika izmantota un vides mainigais nav iestatits, nroff faila pirmaja rinda tiek mekleta prieksapstradataju virkne. Lai saturetu derigu prieksapstradataju virkni, pirmajai rindai jaizskatas sadi '\" kur virkne var but jebkura talak pie opcijas -p aprakstito burtu kombinacija. Ja neviena no ieprieks minetajam metodem nesniedz informaciju par filtriem, tiek izmantota noklusejuma kopa. No filtriem un primara formatetaja (nroff vai [tg]roff ar -t) tiek izveidots un izpildits formatesanas konveijers. Alternativi, ja man koka sakne eksiste izpildama programma mandb_nfmt (vai mandb_tfmt ar -t), tiek izpildita ta. Tai ka argumenti tiek padots rokasgramatas avota fails, prieksapstradataju virkne un, pec izveles, ar -T vai -E noradita ierice. OPCIJAS Bez argumentu opcijas, kas dubletas komandrinda, $MANOPT vai abos, nekaite. Opcijam, kuram nepieciesams arguments, katrs dublikats ignore iepriekseja argumenta vertibu. Visparigas opcijas -C fails, --config-file=fails Izmantot so lietotaja konfiguracijas failu noklusejuma ~/.manpath vieta. -d, --debug Izvadit atkludosanas informaciju. -D, --default So opciju parasti norada ka pasu pirmo opciju, un ta atiestata man uzvedibu uz noklusejumu. Ta paredzeta, lai atiestatitu opcijas, kas, iespejams, iestatitas $MANOPT. Visam opcijam, kas seko -D, bus parasta ietekme. --warnings[=bridinajumi] Iespejot groff bridinajumus. To var izmantot rokasgramatas lapu avota teksta sapratiguma parbaudem. bridinajumi ir ar komatiem atdalits bridinajumu nosaukumu saraksts; ja tas nav noradits, noklusejums ir "mac". Lai atspejotu groff bridinajumu, pievienojiet tam priedekli "!": piemeram, --warnings=mac,!break iespejo bridinajumus kategorija "mac" un atspejo bridinajumus kategorija "break". Pieejamo bridinajumu nosaukumu sarakstu skatiet info groff mezgla "Warnings". Galvenie darbibas rezimi -f, --whatis Aptuveni lidzvertigs whatis. Paradit iso aprakstu no rokasgramatas lapas, ja pieejams. Sikak skatiet whatis(1). -k, --apropos Aptuveni lidzvertigs apropos. Meklet atslegvardus rokasgramatas lapu isajos aprakstos un paradit visas atbilstibas. Sikak skatiet apropos(1). -K, --global-apropos Meklet tekstu visas rokasgramatas lapas. Ta ir pilnas parlases meklesana, un ta, visticamak, aiznems kadu laiku; ja iespejams, noradiet sadalu, lai samazinatu parmeklejamo lapu skaitu. Meklesanas termini var but vienkarsas virknes (noklusejums) vai regularas izteiksmes, ja izmantota opcija --regex. Nemiet vera, ka tiek parmekleti rokasgramatas lapu avoti, nevis atveidotais teksts, tapec var but kludaini pozitivi rezultati, piemeram, avota failu komentaru del, vai kludaini negativi rezultati, piemeram, tapec, ka avota failos defises rakstitas ka "\-". Atveidota teksta parmeklesana butu daudz lenaka. -l, --local-file Aktivizet ,,lokalo" rezimu. Formatet un paradit lokalus rokasgramatas failus, nevis meklet sistemas rokasgramatu kolekcija. Katrs rokasgramatas lapas arguments tiks interpretets ka pareiza formata esoss nroff avota fails. Cat fails netiek veidots. Ja ka viens no argumentiem noradits '-', ievade tiks nemta no stdin. Ja si opcija netiek izmantota, man tapat interpretes rokasgramatas lapas argumentus ka lokalu failu nosaukumus, ja arguments satur rakstzimi "/", jo ta ir laba norade, ka arguments attiecas uz celu failu sistema. -w, --where, --path, --location Faktiski neparadit rokasgramatas lapu, bet izvadit ta nroff avota faila atrasanas vietu, kas tiktu formatets. Ja izmantota ari opcija -a, izvadit visu meklesanas kriterijiem atbilstoso avota failu atrasanas vietas. -W, --where-cat, --location-cat Faktiski neparadit rokasgramatas lapu, bet izvadit ta ieprieks formateta cat faila atrasanas vietu, kas tiktu paradits. Ja izmantota ari opcija -a, izvadit visu meklesanas kriterijiem atbilstoso ieprieks formateto cat failu atrasanas vietas. Ja izmantotas gan -w, gan -W, izvadit gan avota failu, gan cat failu, atdalitus ar atstarpi. Ja izmantotas visas -w, -W un -a, darit to katrai iespejamai atbilstibai. -c, --catman Si opcija nav paredzeta visparejai lietosanai, un to drikst izmantot tikai programma catman. -R kodejums, --recode=kodejums Ta vieta, lai formatetu rokasgramatas lapu parastaja veida, izvadit tas avotu, parveidotu noraditaja kodejuma. Ja jau zinat avota faila kodejumu, varat ari tiesi izmantot manconv(1). Tacu si opcija lauj parveidot vairakas rokasgramatas lapas viena kodejuma, nenoradot katras kodejumu, ja vien tas jau ir instaletas rokasgramatas lapu hierarhijai lidziga struktura. Vairaku rokasgramatas lapu parveidosanai apsveriet man-recode(1) izmantosanu, jo tas saskarne ir paredzeta masveida parveidei, tapec ta var but daudz atraka. Rokasgramatas lapu meklesana -L lokale, --locale=lokale man parasti nosaka jusu pasreizejo lokali, izsaucot C funkciju setlocale(3), kas vaica dazadus vides mainigos, iespejams, ari $LC_MESSAGES un $LANG. Lai uz laiku ignoretu noteikto vertibu, izmantojiet so opciju, lai man tiesi padotu lokales virkni. Nemiet vera, ka ta stasies speka tikai tad, kad faktiski saksies lapu meklesana. Tada izvade ka palidzibas zinojums vienmer tiks radita sakotneji noteiktaja lokale. -m sistema[,...], --systems=sistema[,...] Ja sai sistemai ir piekluve citu operetajsistemu rokasgramatas lapam, tam var pieklut ar so opciju. Lai mekletu rokasgramatas lapu NewOS rokasgramatas lapu kolekcija, izmantojiet opciju -m NewOS. Noradita sistema var but ar komatiem atdalitu operetajsistemu nosaukumu kombinacija. Lai ieklautu meklesanu vietejas operetajsistemas rokasgramatas lapas, ieklaujiet argumentu virkne sistemas nosaukumu man. Si opcija ignore vides mainigo $SYSTEM. -M cels, --manpath=cels Noradit alternativu izmantojamo manpath. Pec noklusejuma man izmanto no manpath atvasinatu kodu, lai noteiktu meklesanas celu. Si opcija ignore vides mainigo $MANPATH un liek ignoret opciju -m. Celam, kas noradits ka manpath, jabut sadalas strukturetas rokasgramatas lapu hierarhijas saknei, ka aprakstits man-db rokasgramata (nodala "The manual page system"). Lai skatitu rokasgramatas lapas arpus sadam hierarhijam, skatiet opciju -l. -S saraksts, -s saraksts, --sections=saraksts Noraditais saraksts ir ar koliem vai komatiem atdalits sadalu saraksts, ko izmanto, lai noteiktu, kuras rokasgramatas sadalas un kada seciba meklet. Si opcija ignore vides mainigo $MANSECT. (Pieraksts -s ir saderibai ar System V.) -e apakspaplasinajums, --extension=apakspaplasinajums Dazas sistemas galvenaja rokasgramatas lapu hierarhija ieklauj lielas rokasgramatas lapu pakotnes, piemeram, tas, kas pievienotas pakotnei Tcl. Lai apietu problemu, ka ir divas rokasgramatas lapas ar vienadu nosaukumu, piemeram, exit(3), Tcl lapas parasti visas tika iedalitas sadala l. Ta ka tas nav velams, tagad lapas ir iespejams ievietot pareizaja sadala un pieskirt tam noteiktu ,,paplasinajumu", saja gadijuma exit(3tcl). Parasta darbiba man prieksroku dos exit(3), nevis exit(3tcl). Lai tiktu gala ar so situaciju un nebutu jazina, kura sadala atrodas vajadziga lapa, tagad man ir iespejams padot apakspaplasinajuma virkni, kas norada, kurai pakotnei lapai japieder. Izmantojot ieprieksejo piemeru, opcija -e tcl ierobezos man meklesanu ar lapam, kuru paplasinajums ir *tcl. -i, --ignore-case Meklejot rokasgramatas lapas, ignoret registru. Tas ir noklusejums. -I, --match-case Meklet rokasgramatas lapas, skirojot registru. --regex Radit visas lapas, kuru nosaukuma vai apraksta jebkura dala atbilst katram lapas argumentam ka regularajai izteiksmei, ka apropos(1). Ta ka, meklejot regularo izteiksmi, parasti nav sapratiga veida izveleties ,,labako" lapu, si opcija ietver -a. --wildcard Radit visas lapas, kuru nosaukuma vai apraksta jebkura dala atbilst katram lapas argumentam, izmantojot caulas stila aizstajejzimes, ka apropos(1) --wildcard. Lapas argumentam jaatbilst visam nosaukumam vai aprakstam vai jaatbilst apraksta vardu robezas. Ta ka, meklejot ar aizstajejzimem, parasti nav sapratiga veida izveleties ,,labako" lapu, si opcija ietver -a. --names-only Ja izmantota opcija --regex vai --wildcard, salidzinat tikai ar lapu nosaukumiem, nevis lapu aprakstiem, ka whatis(1). Preteja gadijuma bez ietekmes. -a, --all Pec noklusejuma man iziet pec piemerotakas atrastas rokasgramatas lapas paradisanas. Si opcija liek man paradit visas rokasgramatas lapas, kuru nosaukumi atbilst meklesanas kriterijiem. -u, --update Si opcija liek man atjauninat instaleto rokasgramatas lapu datubazu kesatminas. Tas vajadzigs tikai retos gadijumos, un parasti labak ir palaist mandb(8). --no-subpages Pec noklusejuma man meginas interpretet komandrinda noraditus rokasgramatas lapu nosaukumu parus ka lidzvertigus vienam rokasgramatas lapas nosaukumam, kas satur defisi vai pasvitru. Tas atbalsta izplatito programmu modeli, kas realize vairakas apakskomandas, laujot tam nodrosinat rokasgramatas lapas katrai no tam, kuram var pieklut ar lidzigu sintaksi, kadu izmantotu pasu apakskomandu izsauksanai. Piemeram: $ man -aw git diff /usr/share/man/man1/git-diff.1.gz Lai atspejotu so uzvedibu, izmantojiet opciju --no-subpages. $ man -aw --no-subpages git diff /usr/share/man/man1/git.1.gz /usr/share/man/man3/Git.3pm.gz /usr/share/man/man1/diff.1.gz Formatetas izvades vadiba -P lapotajs, --pager=lapotajs Noradit, kuru izvades lapotaju izmantot. Pec noklusejuma man izmanto less, bet, ja less nav atrasts vai nav izpildams, izmanto cat. Si opcija ignore vides mainigo $MANPAGER, kas savukart ignore vides mainigo $PAGER. To neizmanto kopa ar -f vai -k. Vertiba var but vienkarss komandas nosaukums vai komanda ar argumentiem, un taja var izmantot caulas pedinas (atpakalverstas slipsvitras, vienpedinas vai dubultpedinas). Taja nevar izmantot caurulvadus vairaku komandu savienosanai; ja tas nepieciesams, izmantojiet ietinejskriptu, kas paradamo failu var sanemt ka argumentu vai standarta ievade. -r uzvedne, --prompt=uzvedne Ja ka lapotajs tiek izmantota jauna less versija, man meginas iestatit ta uzvedni un dazas sapratigas opcijas. Noklusejuma uzvedne izskatas sadi Rokasgramatas lapa nosaukums(sad) line x kur nosaukums apzime rokasgramatas lapas nosaukumu, sad -- sadalu, kura ta atrasta, un x -- pasreizejas rindas numuru. To panak, izmantojot vides mainigo $LESS. Noradot -r ar virkni, sis noklusejums tiks ignorets. Virkne var saturet tekstu $MAN_PN, kas tiks izversts par pasreizejas rokasgramatas lapas nosaukumu un tas sadalas nosaukumu, ieskautu "(" un ")". Noklusejuma vertibas iegusanai izmantoto virkni varetu izteikt sadi \ Rokasgramatas\ lapa\ \$MAN_PN\ ?ltline\ %lt?L/%L.: byte\ %bB?s/%s..?\ (END):?pB\ %pB\\%.. (press h for help or q to quit) Seit ta ir sadalita tris rindas tikai lasamibas labad. Tas nozimi skatiet less(1) rokasgramatas lapa. Uzvednes virkni vispirms izverte caula. Visam dubultpedinam, atpakalpedinam un atpakalverstajam slipsvitram uzvedne jaliek prieksa atpakalversta slipsvitra. Uzvednes virkne var beigties ar $, kam prieksa ir atpakalversta slipsvitra, un aiz ta var sekot citas less opcijas. Pec noklusejuma man iestata opcijas -ix8. Talak aprakstito vides mainigo $MANLESS var izmantot, lai iestatitu noklusejuma uzvednes virkni, ja komandrinda ta nav noradita. -7, --ascii Skatot tiru ascii(7) rokasgramatas lapu 7 bitu terminali vai terminala emulatora, dazas rakstzimes var netikt paraditas pareizi, izmantojot latin1(7) ierices aprakstu ar GNU nroff. Si opcija lauj tiras ascii rokasgramatas lapas ar latin1 ierici paradit ascii kodejuma. Ta neparveidos nekadu latin1 tekstu. Saja tabula paraditi veiktie parveidojumi: dazas tas dalas var tikt pareizi paraditas tikai, izmantojot GNU nroff latin1(7) ierici. Apraksts Astotnieku latin1 ascii -------------------------------------------------------- turpinajuma defise 255 - - aizzime (videjais punkts) 267 o o akuta akcents 264 ' ' reizinasanas zime 327 x x Ja latin1 kolonna tiek paradita pareizi, jusu terminalis, iespejams, ir iestatits latin1 rakstzimem, un si opcija nav nepieciesama. Ja latin1 un ascii kolonnas ir identiskas, jus lasat so lapu, izmantojot so opciju, vai ari man so lapu neformateja, izmantojot latin1 ierices aprakstu. Ja latin1 kolonnas trukst vai ta ir bojata, jums, iespejams, jaskata rokasgramatas lapas ar so opciju. Si opcija tiek ignoreta, izmantojot opcijas -t, -H, -T vai -Z, un var but nelietderiga citam nroff versijam, kas nav GNU. -E kodejums, --encoding=kodejums Generet izvadi rakstzimju kodejumam, kas atskiras no noklusejuma. Atpakalsaderibas del kodejums var but nroff ierice, piemeram, ascii, latin1 vai utf8, ka ari ists rakstzimju kodejums, piemeram, UTF-8. --no-hyphenation, --nh Parasti nroff rindu parnesumos automatiski dala vardus pat tad, ja tie nesatur defises, ja tas nepieciesams, lai izkartotu vardus rinda bez parmerigam atstarpem. Si opcija atspejo automatisko vardu dalisanu, tapec vardi tiks daliti tikai tad, ja tie jau satur defises. Ja rakstat rokasgramatas lapu un vienkarsi velaties nelaut nroff dalit vardu nepiemerota vieta, neizmantojiet so opciju, bet skatiet nroff dokumentaciju; piemeram, varat ievietot varda "\%", lai noraditu, ka taja vieta to drikst dalit, vai ievietot "\%" varda sakuma, lai to nedalitu vispar. --no-justification, --nj Parasti nroff automatiski izlidzina tekstu pie abam malam. Si opcija atspejo pilno izlidzinasanu, atstajot tekstu izlidzinatu tikai pie kreisas malas -- to dazreiz sauc par tekstu ar ,,robotu labo malu". Ja rakstat rokasgramatas lapu un vienkarsi velaties nelaut nroff izlidzinat noteiktas rindkopas, neizmantojiet so opciju, bet skatiet nroff dokumentaciju; piemeram, varat izmantot pieprasijumus ".na", ".nf", ".fi" un ".ad", lai uz laiku atspejotu izlidzinasanu un aizpildisanu. -p virkne, --preprocessor=virkne Noradit prieksapstradataju secibu, kas japalaiz pirms nroff vai troff/groff. Ne visas instalacijas bus pilna prieksapstradataju kopa. Dazi prieksapstradataji un burti, ar ko tos apzime: eqn (e), grap (g), pic (p), tbl (t), vgrind (v), refer (r). Si opcija ignore vides mainigo $MANROFFSEQ. zsoelim vienmer tiek palaists ka pats pirmais prieksapstradatajs. -t, --troff Izmantot groff -mandoc, lai formatetu rokasgramatas lapu uz stdout. Si opcija nav nepieciesama kopa ar -H, -T vai -Z. -T[ierice], --troff-device[=ierice] This option is used to change groff (or possibly troff's) output to be suitable for a device other than the default. It implies -t, unless the device is an nroff device such as ascii, latin1, or utf8. Examples (as of groff 1.23.0) include dvi, latin1, pdf, ps, utf8, X75 and X100. -H[parluks], --html[=parluks] Si opcija liks groff veidot HTML izvadi un paradis so izvadi timekla parluka. Parluku nosaka neobligatais arguments parluks, ja tas noradits, vides mainigais $BROWSER vai, ja tas nav iestatits, kompilesanas laika noteikts noklusejums (parasti lynx). Si opcija ietver -t un darbosies tikai ar GNU troff. -X[dpi], --gxditview[=dpi] Si opcija parada groff izvadi grafiska loga, izmantojot programmu gxditview. dpi (punkti colla) var but 75, 75-12, 100 vai 100-12, noklusejums ir 75; -12 varianti izmanto 12 punktu bazes fontu. Si opcija ietver -T ar attiecigi ierici X75, X75-12, X100 vai X100-12. -Z, --ditroff groff palaidis troff un pec tam izmantos atbilstosu pecapstradataju, lai veidotu izveletajai iericei piemerotu izvadi. Ja groff -mandoc ir groff, si opcija tiek nodota groff un noversis pecapstradataja izmantosanu. Ta ietver -t. Palidzibas sanemsana -?, --help Izvadit palidzibas zinojumu un iziet. --usage Izvadit isu lietosanas zinojumu un iziet. -V, --version Paradit versijas informaciju. IZPILDES STATUSS 0 Veiksmiga programmas izpilde. 1 Lietosanas, sintakses vai konfiguracijas faila kluda. 2 Darbibas kluda. 3 Bernprocess atgrieza izejas statusu, kas nav nulle. 16 Vismaz viena no lapam/failiem/atslegvardiem neeksisteja vai netika atrasta atbilstiba. VIDE MANPATH Ja $MANPATH ir iestatits, ta vertiba tiek izmantota ka rokasgramatas lapu meklesanas cels. Noklusejuma uzvedibu un sikaku informaciju par to, ka tiek apstradats sis vides mainigais, skatiet manpath(5) sadala MEKLESANAS CELS. MANROFFOPT Ikreiz, kad man izsauc formatetaju (nroff, troff vai groff), ta pievieno $MANROFFOPT saturu formatetaja komandrindai. Piemeram, MANROFFOPT=-P-i liek formatetajam izmantot kursivu (ko atbalsta tikai dazi terminali), nevis pasvitrotu tekstu. MANROFFSEQ Ja $MANROFFSEQ ir iestatits, ta vertiba tiek izmantota, lai noteiktu prieksapstradataju kopu, caur kuru izlaist katru rokasgramatas lapu. Noklusejuma prieksapstradataju saraksts ir atkarigs no sistemas. MANSECT Ja $MANSECT ir iestatits, ta vertiba ir ar koliem atdalits sadalu saraksts, ko izmanto, lai noteiktu, kuras rokasgramatas sadalas un kada seciba meklet. Noklusejums ir "1 1p n l 8 3 3p 0 0p 2 3type 5 4 9 6 7", ja vien to neignore direktiva SECTION faila /etc/man_db.conf. MANPAGER, PAGER Ja $MANPAGER vai $PAGER ir iestatits (prieksroka tiek dota $MANPAGER), ta vertiba tiek izmantota ka rokasgramatas lapas paradisanai izmantotas programmas nosaukums. Pec noklusejuma tiek izmantots less, bet, ja less nav atrasts vai nav izpildams, tiek izmantots cat. Vertiba var but vienkarss komandas nosaukums vai komanda ar argumentiem, un taja var izmantot caulas pedinas (atpakalverstas slipsvitras, vienpedinas vai dubultpedinas). Taja nevar izmantot caurulvadus vairaku komandu savienosanai; ja tas nepieciesams, izmantojiet ietinejskriptu, kas paradamo failu var sanemt ka argumentu vai standarta ievade. MANLESS Ja $MANLESS ir iestatits, ta vertiba tiks izmantota ka lapotaja less noklusejuma uzvednes virkne, it ka ta butu padota ar opciju -r (tatad visi teksta $MAN_PN gadijumi tiks izversti tapat). Piemeram, ja velaties beznosacijuma karta iestatit uzvednes virkni uz "mana uzvednes virkne", iestatiet $MANLESS uz `-Psmana uzvednes virkne'. Opcijas -r izmantosana ignore so vides mainigo. BROWSER Ja $BROWSER ir iestatits, ta vertiba ir ar koliem atdalits komandu saraksts, no kuram katru pec kartas izmanto, lai meginatu palaist timekla parluku komandai man --html. Katra komanda %s tiek aizstats ar faila nosaukumu, kas satur groff HTML izvadi, %% tiek aizstats ar vienu procentu zimi (%), un %c tiek aizstats ar kolu (:). SYSTEM Ja $SYSTEM ir iestatits, tam bus tada pati ietekme, it ka tas butu noradits ka opcijas -m arguments. MANOPT Ja $MANOPT ir iestatits, tas tiks parsets pirms man komandrindas, un tiek sagaidits, ka tam bus lidzigs formats. Ta ka visus parejos man specifiskos vides mainigos var izteikt ka komandrindas opcijas un tatad tie ir kandidati ieklausanai $MANOPT, sagaidams, ka tie klus novecojusi. N.B. Visam atstarpem, kas jainterprete ka dala no opcijas argumenta, jaliek prieksa atpakalversta slipsvitra. MANWIDTH Ja $MANWIDTH ir iestatits, ta vertiba tiek izmantota ka rindas garums, kadam jaformate rokasgramatas lapas. Ja tas nav iestatits, rokasgramatas lapas tiks formatetas ar pasreizejam terminalim atbilstosu rindas garumu (izmantojot $COLUMNS vertibu un ioctl(2), ja pieejams, vai 80 rakstzimes, ja neviens no tiem nav pieejams). Cat lapas tiks saglabatas tikai tad, ja var izmantot noklusejuma formatejumu, t. i., ja terminala rindas garums ir no 66 lidz 80 rakstzimem. MAN_KEEP_FORMATTING Parasti, ja izvade netiek novirzita uz terminali (piemeram, uz failu vai caurulvadu), formatesanas rakstzimes tiek atmestas, lai rezultatu butu vieglak lasit bez ipasiem rikiem. Tacu, ja $MAN_KEEP_FORMATTING ir iestatits uz jebkuru netuksu vertibu, sis formatesanas rakstzimes tiek saglabatas. Tas var noderet man ietinejiem, kas spej interpretet formatesanas rakstzimes. MAN_KEEP_STDERR Parasti, ja izvade tiek novirzita uz terminali (parasti uz lapotaju), visa kludu izvade no komandas, ko izmanto rokasgramatas lapu formateto versiju veidosanai, tiek atmesta, lai netraucetu lapotaja attelojumu. Tadas programmas ka groff biezi izvada salidzinosi nenozimigus kludu zinojumus par tipografiskam problemam, piemeram, sliktu izlidzinajumu, kas, paraditi kopa ar rokasgramatas lapu, izskatas nepievilcigi un parasti mulsina. Tacu dazi lietotaji tos tomer velas redzet, tapec, ja $MAN_KEEP_STDERR ir iestatits uz jebkuru netuksu vertibu, kludu izvade tiks radita ka parasti. MAN_DISABLE_SECCOMP Linux sistema man parasti ierobezo apaksprocesus, kas apstrada neuzticamus datus, izmantojot seccomp(2) smilskasti. Tas padara drosaku sarezgita parsesanas koda palaisanu patvaligam rokasgramatas lapam. Ja kada iemesla del, kas nav saistits ar paradamas lapas saturu, rodas problemas, varat iestatit $MAN_DISABLE_SECCOMP uz jebkuru netuksu vertibu, lai atspejotu smilskasti. PIPELINE_DEBUG Ja vides mainigais $PIPELINE_DEBUG ir iestatits uz "1", man standarta kludu izvade izvadis atkludosanas zinojumus, kas apraksta katru palaisto apaksprocesu. LANG, LC_MESSAGES Atkariba no sistemas un realizacijas, lai noteiktu pasreizejo zinojumu lokali, tiks vaicats $LANG vai $LC_MESSAGES, vai abi. man paradis savus zinojumus saja lokale (ja pieejami). Precizu informaciju skatiet setlocale(3). FAILI /etc/man_db.conf man-db konfiguracijas fails. /usr/share/man Globala rokasgramatas lapu hierarhija. STANDARTI POSIX.1-2001, POSIX.1-2008, POSIX.1-2017. SKATIT ARI apropos(1), groff(1), less(1), manpath(1), nroff(1), troff(1), whatis(1), zsoelim(1), manpath(5), man(7), catman(8), mandb(8) Dazu pakotnu dokumentacija var but pieejama citos formatos, piemeram, info(1) vai HTML. VESTURE 1990, 1991 - Sakotneji uzrakstija John W. Eaton (jwe@che.utexas.edu). 1992. gada 23. decembris: Rik Faith (faith@cs.unc.edu) piemeroja Willem Kasdorp (wkasdo@nikhefk.nikef.nl) sagatavotos kludu labojumus. 1994. gada 30. aprilis - 2000. gada 23. februaris: Wilf. (G.Wilford@ee.surrey.ac.uk) ar dazu uzticigu cilveku palidzibu izstradaja un uztureja so pakotni. 1996. gada 30. oktobris - 2001. gada 30. marts: Fabrizio Polacco ar visas kopienas palidzibu uztureja un uzlaboja so pakotni Debian projektam. 2001. gada 31. marts - musdienas: Colin Watson tagad izstrada un uztur man-db. KLUDAS https://gitlab.com/man-db/man-db/-/issues https://savannah.nongnu.org/bugs/?group=man-db 2.13.3 2026-11-16 MAN(1)