man-sivut

Manuaalisivut ovat Unix-käyttöjärjestelmien sähköisessä muodossa oleva manuaali. Unixin lisäksi Unixin kaltaiset käyttöjärjestelmät kuten BSD ja Linux käyttävät manuaalisivuja. Manuaalisivuja luetaan man-komennolla tekstipäätteessä komentoriviltä.

Manuaalisivut sisältävät paitsi käyttäjän komentojen dokumentoinnin, myös manuaalit järjestelmäkutsuista (sektio 2), aliohjelmakutsuista (sektio 3), konfiguraatiotiedostoista (sektio 5), standardeista (sektio 7) ja ylläpitokomennoista (sektio 8). Esimerkiksi /etc/resolv.conf-tiedostolla manuaalisivunsa, joka luetaan komennolla man resolv.conf.

Yleistä[muokkaa | muokkaa wikitekstiä]

Manuaalisivut on itse asiassa nroff-taitto-ohjelman dokumentteja, jotka man-komento muotoilee näytöllä esitettäväksi. Esim. Solariksessa on kuitenkin siirrytty käyttämään SGML-muotoa käyttöjärjestelmän dokumentaatiossa, vaikka man-ohjelma osaakin näyttää myös vanhanmalliset nroff-sivut.

Man-ohjelma käynnistää taitto-ohjelman, joka muotoilee sivun, ja man näyttää sen käyttäjälle jollain sivutusohjelmalla (kuten more tai less). Dokumentin muotoilun raskauden vuoksi valmiiksi muotoillut dokumentin tallennetaan yleensä välimuistiin.

Manuaalisivuja hyödyntävät myös komennot apropos ja whatis.

Haku[muokkaa | muokkaa wikitekstiä]

Man-ohjelma osaa näyttää oikean sivun vain jos käyttäjä tietää komennon nimen. Johonkin tiettyyn käyttötarkoitukseen oikean käskyn hakeminen ei voi olla ongelmallista. Jos käyttäjä ei tiedä, miltä man-sivulta aloittaisi halutun tiedon etsimisen, manuaalisivujen kuvauksista voi etsiä komennolla apropos:

$ apropos editor
ed              ed (1)          - text editor
edit            edit (1)        - text editor (variant of ex for casual users)
ex              ex (1)          - text editor
ld              ld (1)          - link-editor for object files
ld              ld (1b)         - link editor, dynamic link editor
ld_atexit       ld_support (3ext)   - link-editor support functions

...

Manuaalisivuja voi hyödyntää selvittämään eri komentojen ja ohjelmien tehtäviä. Näin voidaan tehdä komennolla whatis ohjelma.

$ whatis cupsd
cupsd (8)            - common unix printing system daemon

Manuaalisivujen rakenne[muokkaa | muokkaa wikitekstiä]

Manuaalisivut on muotoiltu kaikki samalla tavoin ja ne koostuvat kahdeksasta kappaleesta:

Name (Nimi ja tiedot)
Synopsis (Komennon käyttö)
Description (Kuvaus)
Options (Lisätietoa attribuuteista)
Files (Tiedostot)
See also (Sekalaista)
System administration commands and daemons (Järjestelmänhallinnan komennot ja taustaprosessit, eli daemonit)

Nämä voivat esiintyä eri nimillä ja osa niistä voi puuttuakin. Kuitenkin ym. rakenne on standardi.

Nimi ja tiedot[muokkaa | muokkaa wikitekstiä]

Sisältää yleiset komennot ja ohjelman lyhyen kuvauksen.

Komennon käyttö[muokkaa | muokkaa wikitekstiä]

Kertoo, mitä vipuja eli parametrejä (engl. argument) komennolle voi antaa. Hakasulkujen sisällä olevat osat ovat valinnaisia, kun taas kulmasuluissa olevat ollessa ja ilman sulkuja olevat osat ovat pakollisia. Pienillä ja isoilla kirjaimilla on merkitystä. Yleiset ohjeet ovat nämä:

[] viittaa kokonaisuuteen, joka voidaan jättää pois.
| viittaa siihen, ettei sen eri puolilla olevia attribuutteja voida käyttää vaihtoehtoisesti.

Attribuutit annetaan erityisellä syntaksilla, joka voi näyttää jotakuinkin tältä: '''man''' ['''-c'''|'''-w'''|'''-tZ'''] ['''-H'''[browser]] ['''-T'''[device]] ['''-adhu7V'''] ['''-i'''|'''-I'''] ['''-m''' system[,...]] ['''-L''' locale] ['''-p''' string] ['''-C''' file]

Syntaksin selitys
Rakenne	Selitys
`lihavoitu teksti`	Kirjoita kuten se ohjeessa näytetään.
`kursivoitu teksti`	Korvaa asiaankuuluvalla attribuutilla.
`[-abc]`	Kaikki hakasulkeiden sisällä olevat attribuutit eivät ole pakollisia.
`-a\|-b`	Putkella erotettuja `-a`:ta ja `-b`:tä ei voida käyttää yhtä aikaa. Voit käyttää vain toista.
`argumentti ...`	Attribuuttia voidaan käyttää uudestaan.
`[lauseke]`	Koko lauseke hakasulkeiden sisällä on käytettävissä uudestaan.

Jos ei muista komennon nimeä mutta tietää mitä se tekee, on useimmissa man versioissa valitsin -k, jonka avulla löytää asiasanoja komennoista: esimerkiksi man -k crypt antaa tuloksen kaikista komennoista yms., joilla on tekemistä kryptaamisen kanssa.

Kuvaus[muokkaa | muokkaa wikitekstiä]

Kertoo tarkennetun kuvauksen ohjelmasta syventyen sen toimintaan, ominaisuuksiin ja erityispiirteisiin.

Tiedostot[muokkaa | muokkaa wikitekstiä]

Unix-käyttöjärjestelmien konfiguraatiotiedostot ovat usein tekstimuodossa ja niitä pitää muokata tekstieditorilla.

Sekalaista[muokkaa | muokkaa wikitekstiä]

Näyttää muut man-sivut, joita voidaan hyödyntää komennon kanssa ja ovat samankaltaisia tai välttämättömiä komennon toiminnan kannalta sekä man-sivut, jotka ovat esiintyneet kyseisillä man-sivuilla.

Järjestelmänhallinnan komennot ja daemonit[muokkaa | muokkaa wikitekstiä]

Sisältää tietoa järjestelmänhallinnollisista komennoista ja taustalla toimivista prosesseista, daemoneista.

Lähteet[muokkaa | muokkaa wikitekstiä]

man.splitbrain.org (Arkistoitu – Internet Archive) (englanniksi)
linuxmanpages.com (englanniksi)

Aiheesta muualla[muokkaa | muokkaa wikitekstiä]

man.splitbrain.org (Arkistoitu – Internet Archive) (englanniksi)
linuxmanpages.com (englanniksi)
Online man pages, 30+ käyttöjärjestelmiä, kuten AIX, HP-UX, IRIX, Xenix, BSD, Linux... (englanniksi)