Product SiteDocumentation Site

Hoofdstuk 7. Problemen Oplossen en Relevante Informatie Vinden

7.1. Documentatie Bronnen
7.1.1. Handleiding Pagina's
7.1.2. info Documenten
7.1.3. Specifieke Documentatie
7.1.4. Websites
7.1.5. Tutorials HOWTO
7.2. Algemene Procedures
7.2.1. een Programma Configureren
7.2.2. In De Gaten Houden Wat Daemons Doen
7.2.3. Hulp Vragen op een Mail Lijst
7.2.4. Ee, Fout Rapporteren wanneer een Probleem te Moeilijk is
Voor een Beheerder, is de belangrijkste bekwaamheid het kunnen omgaan met iedere situatie, bekend of onbekend. Dit hoofdstuk geeft een aantal methoden die je — hopelijk — in staat stellen om de oorzaak van ieder probleem dat je tegenkomt te isoleren, zodat je de mogelijkheid hebt om het op te lossen.

7.1. Documentatie Bronnen

Voor je kunt begrijpen wat er echt gebeurt wanneer er een probleem is, moet je de theoretische rol gespeeld door ieder programma betrokken bij het probleem begrijpen. Om dit te doen, de beste reflex is het raadplegen van hun documentatie; maar omdat er veel van deze documentaties zijn en ver verspreid, zou je al de plaatsen waar ze gevonden kunnen worden kennen.

7.1.1. Handleiding Pagina's

Handleiding pagina's, hoewel ze relatief kort zijn, bevatten een groot aantal essentiële informatie. We zullen snel over het commando om ze te lezen gaan. Simpelweg man handleiding-pagina — de handleiding pagina heeft dezelfde naam als het commando wiens documentatie je zoekt. Bij voorbeeld, om meer te weten over de mogelijke opties voor het cp commando, zal je het man cp commando in de shell prompt weergeven (zie marge TERUG NAAR DE BASIS De shell, een commando regel vertolker).
Handleiding pagina's beschrijven niet enkel programma's beschikbaar via de commando-regel, maar ook configuratiebestanden, systeem aanroepen, C bibliotheek functies enz. Soms kunnen namen conflicteren. Bij voorbeeld het read commando van de shell heeft dezelfde naam als de read systeem aanroep. Dit is waarom handleiding pagina's zijn georganiseerd is genummerde secties:
  1. commando's die uitgevoerd kunnen worden vanaf de commando-regel;
  2. systeem aanroepen (functies aangeboden door de kernel);
  3. bibliotheek functies (aangeboden door systeem bibliotheken);
  4. apparaten (op Unix-achtige systemen, zijn dit speciale bestanden, meestal geplaatst in de /dev/ directory);
  5. Configuratie bestanden (opmaak en conventies);
  6. spelletjes;
  7. sets van macro's en standaarden;
  8. systeembeheer commando's;
  9. kernel routines.
Het is mogelijk om de sectie van de handleiding pagina's waar je naar zoekt te specificeren: om de documentatie voor de read systeem aanroep te zien, zou je man 2 read typen. Wanneer er geen sectie expliciet wordt aangegeven, zal de eerste sectie van de gekozen handleiding pagina weergegeven worden. Dus man shadow geeft shadow(5) weer want er zijn geen handleiding pagina's voor shadow in secties 1 t.e.m. 4.
Natuurlijk, als je de namen van de commando's niet weet, zal de handleiding niet veel nut hebben voor je. Dit is het doel van het apropos commando, welke helpt zoeken in de handleiding pagina's, of meer specifiek in hun korte beschrijving. Ieder handleiding pagina begint essentieel met een enkele regel samenvatting. apropos geeft een lijst van handleiding pagina's waarvan de samenvatting een gevraagd sleutelwoord(en) bevat weer. Als je ze goed kiest, zul je het naam van het commando dat je zoekt vinden.

Voorbeeld 7.1. cp vinden met apropos

$ apropos "copy file"
cp (1)               - copy files and directories
cpio (1)             - copy files to and from archives
gvfs-copy (1)        - Copy files
gvfs-move (1)        - Copy files
hcopy (1)            - copy files from or to an HFS volume
install (1)          - copy files and set attributes
ntfscp (8)           - copy file to an NTFS volume.
Het man commando is niet de enige manier om de handleiding pagina's te consulteren, omdat konqueror in (KDE) en yelp (onder GNOME) ook deze mogelijkheid bieden. Er is ook een web interface, geleverd door het man2html pakket, welke je toelaat om de handleiding pagina's te tonen in een internet browser. Op een computer waarop dit pakket geïnstalleerd is gebruik je dit URL:
Deze toepassing vereist een web server. Dit is waarom je ervoor zou moeten kiezen om dit pakket op een van jouw servers te installeren: alle gebruikers op het lokale netwerk kunnen genieten van deze service (inclusief niet-Linux machines), en dit zal zorgen dat je geen HTTP server moet installeren op ieder werkstation.

7.1.2. info Documenten

Het GNU project heeft voor de meeste van zijn programma's handleidingen geschreven in het info formaat; dit is waarom veen handleiding pagina's verwijzen naar de corresponderende info documentatie. Dit formaat biedt enkele voordelen, maar het standaard programma om deze documenten te bekijken (is heet info) is ook iets complexer. Je wordt geadviseerd om pinfo (van het pinfo pakket) in de plaats te gebruiken.
De info documentatie heeft een hiërarchische structuur, en als je pinfo aanroept zonder parameters, zal het een lijst van al de knooppunten in het eerste niveau weergeven. Meestal hebben de knooppunten de naam van het corresponderende commando.
Met pinfo is het navigeren tussen deze knooppunten gemakkelijk met de pijl toetsen. Alternatief kun je ook een grafische browser, welke veen gebruiksvriendelijker is, gebruiken. Opnieuw, konqueror en yelp werken; het info2www biedt ook een web interface.
Merk op dat het info systeem niet geschikt is voor vertaling, in tegenstelling tot het man pagina systeem. info zijn dus bijna altijd in het Engels. Hoewel, als je het pinfo programma vraagt om een niet bestaande info pagine weer te geven, zal het terugvallen op de man pagina met dezelfde naam (indien het bestaat), wat vertaald kan zijn.

7.1.3. Specifieke Documentatie

Ieder pakket bevat zijn eigen documentatie. Zelf het minst gedocumenteerde programma heeft in het algemeen een README bestand dat wat interessante en/of belangrijke informatie bevat. Deze documentatie wordt geïnstalleerd in de /usr/share/docpakket/ directory (waar pakket de naam van het pakket vertegenwoordigd). Als de documentatie groot is, zit het mogelijk niet bij de hoofd pakket van het programma, maar het kan afgeladen zijn naar een toegewijd pakket, wat meestal pakket-doc genoemd wordt. Het hoofd pakket beveelt in het algemeen het documentatie pakket aan zodat je het gemakkelijk kunt vinden.
De /usr/share/doc/pakket/ directory bevat ook enkele bestanden aangeboden door Debian welke de documentatie vervolledigen door de eigenaardigheden of verbeteringen in pakketten vergeleken met een traditionele installatie van de software te specificeren. Het README.Debian bestand geeft ook al de aanpassingen aan die gemaakt zijn om te voldoen aan het Debian Beleid. Het changelog.Debian.gz bestand laat de gebruiker toe om de gemaakte aanpassingen aan het programma gedurende de tijd te volgen: het is zeer handig bij het proberen begrijpen wat er veranderd is tussen twee geïnstalleerde versies die niet hetzelfde gedrag hebben. Tenslotte, is er soms een NEWS.Debian.gz bestand, welke documentatie over de grote aanpassingen in het programma bevat die de beheerders rechtstreeks aangaan.

7.1.4. Websites

In de meeste gevallen, hebben vrije software programma's websites die gebruikt worden om het te verdelen en om de gemeenschap van gebruikers en ontwikkelaars samen te brengen. Deze sites zijn vaak voorzien van relevante informatie in verschillende formaten: officiële documentatie, FAQ (Vaak Gestelde Vragen), e-mail lijst archieven, enz. Problemen die je kunt tegenkomen kunnen vaak al het onderwerk van vele vragen geweest zijn; de FAQ of e-mail lijst archieven kunnen er een oplossing voor hebben. Een goede beheersing van zoekmachines zal zeer handig blijken om relevante pagina's snel te vinden (door het zoeken te beperken tot het Internet domein of sub-domein toegewijd aan het programma). Indien het zoeken te veel pagina's weergeeft of de resultaten niet overeen komen met wat je zoekt, kun je het sleutelwoord debian toevoegen om de resultaten te beperken en te richten op relevante informatie.
Als je het adres van de website van de software niet kent, zijn er verschillende manieren om er aan te komen. Ten eerste, controleer of er een Homepage veld is in de meta-informatie van het pakket (apt-cache show pakket). Alternatief, kan de pakket beschrijving een link naar de officiële website van het pakket bevatten. Als er geen URL is weergegeven, kijk naar /usr/share/doc/pakket/copyright. De Debian onderhouder geeft in het algemeen in dit bestand aan waar ze de bron-code van de software hebben gevonden, en het is waarschijnlijk dat dit de website is die je zoekt. Als jouw zoektocht op dit punt nog steeds geen vruchten heeft afgeworpen, consulteer een vrije software adresboek, zoals de FSF's Free Software Directory of een rechtstreekse zoekopdracht met een zoekmachine, zoals Google, DuckDuckGo, Yahoo, enz.
Je wilt misschien ook kijken in de Debian wiki, een collaboratieve website waar iedereen, zelf simpele bezoekers, suggesties kunnen doen rechtstreeks vanuit hun browser. Het wordt zowel gebruikt door ontwikkelaars die hun projecten verduidelijken en door gebruikers die hun kennis delen door collaboratief documenten te schrijven.

7.1.5. Tutorials HOWTO

Een howto is een document dat concreet een stap voor stap uitleggen hoe (“how to”) je een bepaald doel kunt bereiken. De doelen zijn redelijk gevarieerd, maar vaak technisch van aard: bijvoorbeeld, IP Masquerading opzetten, software RAID configureren, een Samba server installeren, enz. Deze documenten proberen vaak al de mogelijke problemen te omvatten die waarschijnlijk voorkomen tijdens de implementatie van een gegeven technologie.
Veel van deze tutorials worden beheerd door het Linux Documentatie Project (LDP), wiens website al deze documenten herbergt:
Deze documenten zouden met een korreltje zout genomen moeten worden. Ze zijn vaak enkele jaren oud; de informatie die ze bevatten is soms verouderd. Dit fenomeen is zelfs frequenter voor hun vertalingen, omdat updates systematisch noch onmiddellijk na de publicatie van een nieuwe versie van het originele document zijn. Dit is onderdeel van de vreugden van het werken in een vrijwilliger omgeving zonder beperkingen…