[FAQ Index] [Naar Sectie 1 - Inleiding tot OpenBSD] [Naar Sectie 3 - Verkrijgen van OpenBSD]

2 - Andere Bronnen van OpenBSD Informatie

Inhoudsopgave

• 2.1 - Webpagina's
• 2.2 - Mailinglijsten
• 2.3 - Manual Pagina's
• 2.4 - Bugs Rapporteren

2.1 - Interessante Webpagina's

De officiële website voor het OpenBSD project is te vinden op: http://www.OpenBSD.org.

Veel waardevolle informatie is hier te vinden omtrent alle aspecten van het OpenBSD project.

Het OpenBSD Journal is een OpenBSD-gerichte nieuws- en opiniesite.

OpenBSDsupport.org is een site die "door gebruikers onderhouden" documentatie van variabele kwaliteit verzamelt, maar die vaak onderwerpen behandelt die niet in deze FAQ of andere officiële documentatie staan.

Veel gebruikers hebben sites en pagina's met OpenBSD-specifieke informatie opgezet. Zoals met alles op het Internet, zal een goede zoekrobot u het leven gemakkelijker maken, net als een gezonde dosis scepsis. Zoals altijd, voer niet blindelings commando's in uw computer die u niet begrijpt.

2.2 - Mailinglijsten

Het OpenBSD project onderhoudt verscheidene populaire mailinglijsten waar gebruikers zich op inschrijven en die ze volgen. Om u in te schrijven op een mailinglijst, stuurt u een e-mail naar majordomo@openbsd.org. Dat adres is een automatische inschrijvingsdienst. In het tekstgedeelte van uw bericht moet u op één enkele lijn een inschrijvingscommando invoeren voor de lijst waarop u zich wil inschrijven. Bijvoorbeeld:

subscribe announce

De lijstverwerker zal u antwoorden, met de vraag om bevestiging van uw voornemen om de lijst te vervoegen, zodat anderen u niet kunnen inschrijven op een overvloed van ongewenste e-mail. Het bericht zal instructies bevatten voor verschillende manieren om te bevestigen, zoals een list server webpagina link, het bevestigingsbericht beantwoorden of antwoorden naar majordomo@openbsd.org. Gebruik gelijk welke methode die u het best uitkomt. U zal merken dat alle drie de technieken een uniek en in de tijd beperkt identificatienummer met zich meebrengen, zoals A56D-70D4-52C3, opnieuw om er zeker van te zijn dat werkelijk u de persoon bent die deze inschrijving op de mailinglijst heeft aangevraagd (dit is echt "opt-in").

Zodra u uw bedoeling om in te schrijven heeft bevestigd, zal u onmiddellijk toegevoegd worden aan de lijst, en de lijstverwerker zal u laten weten dat u goed en wel toegevoegd bent.

Om u uit te schrijven van een lijst, stuurt u opnieuw een e-mail bericht naar majordomo@openbsd.org. Dit zou er zo kunnen uitzien:

unsubscribe announce

Als u moeilijkheden ondervindt met het mailinglijstsysteem, leest u dan alstublieft eerst het hulpbestand dat kan bekomen worden door een e-mail bericht te sturen naar majordomo@openbsd.org met "help" in het tekstgedeelte van het bericht.

Uw inschrijving op de OpenBSD mailinglijsten kan ook beheerd worden via de web interface op http://lists.openbsd.org

Enkele van de populaire OpenBSD mailinglijsten zijn:

• announce - Belangrijke aankondigingen. Dit is een lijst met kleine omvang.
• security-announce - Aankondigingen van beveiligingsproblemen. Dit is een lijst met kleine omvang.
• misc - Algemene vragen en antwoorden van gebruikers. Dit is de meest actieve lijst, en zou de standaard lijst moeten zijn voor de meeste vragen.
• bugs - Bugs ontvangen via sendbug(1) en discussies erover.
• source-changes - Geautomatiseerde mailing van wijzigingen aan de CVS broncode. Telkens wanneer een ontwikkelaar een wijziging commit in de OpenBSD source tree, stuurt CVS een kopie van het (gewoonlijk korte) commit bericht via deze lijst.
• ports - Discussie van de OpenBSD Ports Tree.
• ports-changes - Geautomatiseerde mailing van ports-specifieke CVS source tree wijzigingen.
• advocacy - Discussie over OpenBSD aanbeveling, en onderwerpen die gewoon te off-topic zijn voor misc.

Alvorens een vraag te stellen op misc of gelijk welke andere mailinglijst, kijk alstublieft eerst in de archieven, omdat de meeste van de gewoonlijke vragen reeds verscheidene malen gesteld zijn. Terwijl het misschien de eerste keer is dat u een probleem of vraag tegenkomt, hebben anderen op de mailinglijst dezelfde vraag misschien al verscheidene keren gezien de voorbije week, en vinden zij het misschien niet leuk ze nog eens te zien. Als u een vraag stelt die mogelijk verband houdt met hardware, voeg er dan steeds een dmesg(8) bij!

Voor verschillende archieven, richtlijnen van andere mailinglijsten en meer informatie kan u terecht op de mailinglijst pagina.

Een niet-officiële mailinglijst die misschien interessant is voor nieuwe gebruikers van OpenBSD en Unix is de OpenBSD Newbies lijst.

2.3 - Manual Pagina's

OpenBSD komt met uitgebreide documentatie in de vorm van manual pagina's, maar ook met langere documenten die specifieke applicaties behandelen. Er wordt aanzienlijke moeite gedaan om ervoor te zorgen dat man pagina's up-to-date en nauwkeurig zijn. In elk geval worden de man pagina's beschouwd als de gezaghebbende bron van informatie voor OpenBSD.

Om de manual pagina's en andere documentatie te benaderen, zorgt u ervoor dat u de man42.tgz en misc42.tgz bestandensets geïnstalleerd hebt.

Hieronder volgt een lijst van enkele van de nuttigste manual pagina's voor nieuwe gebruikers:

Van start gaan

• afterboot(8) - dingen om na te kijken na de eerste volledige boot.
• help(1) - hulp voor nieuwe gebruikers en beheerders.
• hier(7) - layout van bestandssystemen.
• man(1) - toon de on-line manual pagina's.
• intro(1) - inleiding tot algemene commando's, zie ook de inleiding tot andere delen van de manual: intro(2), intro(3), intro(4) (note: intro(4) is platform-specifiek), intro(5), intro(6), intro(7), intro(8), and intro(9).
• adduser(8) - commando om nieuwe gebruikers toe te voegen.
• vipw(8) - bewerk het master password bestand.
• disklabel(8) - lees en schrijf disk pack label.
• reboot, halt(8) - herstart of stop het systeem.
• shutdown(8) - sluit het systeem af op een gegeven ogenblik.
• dmesg(8) - toon de kernel boot boodschappen nog eens
• sudo(8) - log niet in als root, maar voer commando's uit als root.
• mg(1) - emacs-achtige tekstverwerker.

• boot(8) - system bootstrapping procedures.
• boot_config(8) - hoe de kernel configuratie bij het booten veranderen.
• gcc_local(1) - OpenBSD-specifieke wijzigingen aan gcc(1)
• ifconfig(8) - configureer netwerkinterface-parameters.
• login.conf(5) - formaat van de login class configuratiebestanden.
• netstat(1) - toon de netwerkstatus.
• release(8) - bouw een OpenBSD release.
• sendbug(1) - stuur een probleemrapport (PR) over OpenBSD naar een centrale ondersteuningssite.
• style(9) - OpenBSD kernel broncode stijlgids.
• sysctl(8) - kernel status weergeven of instellen.

U kan alle OpenBSD man pagina's op het web vinden op http://www.openbsd.org/cgi-bin/man.cgi maar ook op uw computer als u de man42.tgz bestandenset installeert.

In het algemeen, als u de naam van een commando of een manual pagina kent, kan u ze lezen door "man commando" uit te voeren. Bijvoorbeeld: "man vi" om over de vi editor te lezen. Als u de naam van het commando niet kent, of als "man commando" de manual pagina niet vindt, kan u de manual pagina databank doorzoeken door "apropos iets" of "man -k iets" uit te voeren, waarbij "iets" een woord is dat waarschijnlijk in de titel van de manual pagina die u zoekt, zou kunnen voorkomen. Bijvoorbeeld:

# apropos "time zone" tzfile (5) - time zone information zdump (8) - time zone dumper zic (8) - time zone compiler

De cijfers tussen haakjes geven de sectie van de manual aan waarin die pagina kan gevonden worden. In sommige gevallen kan u manual pagina's met identieke namen terugvinden die in afzonderelijke secties van de manual voorkomen. Stel bijvoorbeeld dat u het formaat van de configuratiebestanden voor de cron daemon wil kennen. Zodra u de sectie van de manual weet voor de pagina die u wenst, kan u "man n commando" uitvoeren, waarin n het sectienummer van de manual is.

# man -k cron cron (8) - clock daemon crontab (1) - maintain crontab files for individual users crontab (5) - tables for driving cron # man 5 crontab

Naast de UNIX manual pagina's, is er een typesettable documentenset (opgenomen in de misc42.tgz bestandenset). Deze is te vinden in de /usr/share/doc directory. U kan elk document formatteren met een "make" in de gepaste subdirectory. De psd subdirectory is de Programmer's Supplementary Documents distributie. De smm subdirectory is de System Manager's Manual. De usd subdirectory is de UNIX User's Supplementary Documents distributie. U kan uw "make" uitvoeren in de drie distributie subdirectories, of u kan een specifieke sectie van een distributie selecteren en een "make" uitvoeren in de subdirectory ervan.

Sommige van de subdirectories zijn leeg. Standaard zal het formatteren van de documenten leiden tot PostScript uitvoer, geschikt om af te drukken. De PostScript uitvoer kan tamelijk groot zijn -- u moet een 250-300% toename in grootte rekenen. Als u geen toegang hebt tot een PostScript printer of display, kan u de documenten ook formatteren om ze te lezen op een terminal display. Elke documentsubdirectory heeft een target om ASCII kopies van deze artikels (`paper.txt' genoemd) te maken, die kunnen gegenereerd worden met make(1). Bijvoorbeeld:

# cd /usr/share/doc/usd/04.csh # make paper.txt # more paper.txt

Merk op dat superuser privileges misschien nodig zijn om documenten in deze directories te bouwen, en dat make clean documenten verwijdert die gegenereerd werden door een vroegere make. Zie /usr/share/doc/README voor meer details over de documenten in /usr/share/doc/.

De UNIX manual pagina's zijn in het algemeen meer recent en betrouwbaar dan de typesettable documenten. De typesettable documenten leggen soms ingewikkelde toepassingen uit in meer detail dan de manual pagina's.

Voor velen kan het nuttig zijn een papieren kopie van de manual pagina te hebben. Hier zijn de richtlijnen om een afdrukbare kopie van een manual pagina te maken.

Hoe toon ik een man pagina bronbestand (i.e. een waarvan de bestandsnaam eindigt in een cijfer, zoals tcpdump.8)?

Deze worden doorheen de src tree gevonden. De man pagina's worden in de tree ongeformatteerd teruggevonden, en vaak worden zij, door gebruik van CVS, aangepast. Om deze pagina's te bekijken, doet u gewoon:

# nroff -Tascii -mandoc <file> | more

Hoe verkrijg ik een plain man pagina zonder formattering of controletekens?

Dit is nuttig om de man pagina meteen, zonder niet-afdrukbare tekens te bekomen.
Voorbeeld:

# man <command> | col -b

Hoe kan ik van een man pagina een PostScript kopie bekomen die klaar is om af te drukken?

Merk op dat <file> het man pagina bronbestand moet zijn (waarschijnlijk een bestand dat op een cijfer eindigt, bv. tcpdump.8). De PostScript versies van de man pagina's zien er erg goed uit. Ze kunnen afgedrukt worden of op het scherm bekeken worden met een programma als gv (GhostView). GhostView vindt u terug in onze packages verzameling. Gebruik de volgende nroff(1) commando-opties om een PostScript versie van een OpenBSD systeem man pagina te bekomen:

# nroff -Tps -mandoc <file> > outfile.ps

Hoe genereer ik gecomprimeerde kopieën van de man pagina's?

Voor mensen die hun systeem van broncode bouwen, zijn er een aantal opties die verband houden met de manier waarop man pagina's gebouwd worden. Deze opties kunnen in /etc/mk.conf geplaatst worden (het zou kunnen dat u dit bestand moet aanmaken) en worden in rekening gebracht tijdens systeem builds. Een heel nuttige optie is het genereren van gecomprimeerde man pagina's om schijfruimte te besparen. Deze kunnen op de normale manier bekeken worden, met het man commando. Om dit in te stellen, voegt u het volgende toe aan /etc/mk.conf:

MANZ=yes

Wat zijn info bestanden?

Sommige van de documentatie van OpenBSD komt in de vorm van info bestanden, typisch bewaard in /usr/share/info. Dit is een alternatieve vorm van documentatie voorzien door GNU. Veel van deze bestanden zijn meer up-to-date dan de manual pagina's voorzien door GNU, en kunnen bekeken worden met het info(1) commando. Om bijvoorbeeld informatie te bekijken over de GNU compiler, gcc(1), typt u:

# info gcc

Hoe krijg ik man pagina's in kleur op XTerm?

Het standaard configuratiebestand voor xterm(1) toont geen gekleurde man pagina's. Om gekleurde uitvoer te krijgen, kopieert u het bestand /etc/X11/app-defaults/XTerm-color naar uw home directory, en hernoemt u het naar ".Xdefaults". Wees voorzichtig en overschrijf uw huidige instellingen niet in ".Xdefaults". Dit bestand bevat alle instellingen die u nodig hebt om kleur in te schakelen in XTerm. Er moeten echter drie lijnen uit commentaar gehaald worden alvorens dit kan werken:

!*VT100*colorULMode: on !*VT100*underLine: off !*VT100*colorBDMode: on

*VT100*colorUL: yellow *VT100*colorBD: white

Hoe schrijf ik mijn eigen manual pagina?

Mocht u uw eigen man pagina willen schrijven voor een toepassing die u hebt geschreven, dan is er daarvoor een tutorial te vinden in mdoc.samples(7). Er is ook een handige referentiegids beschikbaar in mdoc(7).

2.4 - Bugs Rapporteren

Tenslotte, alvorens gelijk welk bug rapport op te sturen, leest u alstublieft eerst http://www.openbsd.org/report.html.

Juiste bug rapportering is een van de belangrijkste verantwoordelijkheden van eindgebruikers. Heel gedetaillerede informatie is vereist om een diagnose te stelen van de meest ernstige bugs. Ontwikkelaars krijgen geregeld bug-rapporten als dit via e-mail:

Hopelijk zien de meeste mensen in waarom zulke meldingen terstond verwijderd worden. Alle bug-rapporten zouden gedetailleerde informatie moeten bevatten. Als Gebruiker Joe echt verwacht had dat iemand zijn bug zou helpen vinden, zou hij of zij meer informatie verschaft hebben... iets als dit:

Zie report.html voor meer informatie over het maken en opsturen van bug reports. Gedetailleerde informatie over uw hardware is nodig als u denkt dat de bug op gelijk welke manier verband zou kunnen houden met uw hardware of hardware configuratie. Gewoonlijk volstaat een dmesg(8) uitvoer in dit verband. Een gedetailleerde omschrijving van uw probleem is nodig. U zal merken dat de dmesg de hardware beschreef, de tekst uitlegde waarom Smart User dacht dat het systeem niet gebroken was (3.2 draaide naar behoren), hoe zijn crash tot stand kwam (door X te starten), en de uitvoer van de "ps" en "trace" commando's van de debugger. In dit geval verschafte Smart User uitvoer, bekomen via een seriële console; als u dat niet kan doen, zal u pen en papier moeten gebruiken om de crash te registreren. (Dit was een echt probleem en de informatie in het bovenstaande rapport heeft helpen leiden tot een herstelling van dit probleem dat Sun4c systemen trof.)

Als Smart User een werkend OpenBSD systeem had vanaf welk hij een bug-rapport wou versturen, zou hij de sendbug(1) utility gebruikt hebben om zijn bug-rapport naar het GNATS problem tracking systeem te sturen. Vanzelfsprekend kan u sendbug(1) niet gebruiken als uw systeem niet wil starten, maar gebruik het wanneer het mogelijk is. U zal nog steeds gedetailleerde informatie moeten meegeven over wat er gebeurde, de precieze configuratie van uw systeem, en hoe het probleem gereproduceerd kan worden. Het sendbug(1) commando vereist dat uw systeem elektronische mail kan versturen op het Internet. Merk op dat de mail server spamd(8) gebaseerde greylisting gebruikt, dus het kan een half uur ofzo duren voor de mail server uw bug-rapport aanvaardt, wees alstublieft geduldig.

Na het doorsturen van een bug-rapport met sendbug(1), zal u via e-mail geïnformeerd worden over de status van het rapport. Het kan zijn dat u door de ontwikkelaars gecontacteerd wordt voor bijkomende informatie of dat ze u patches opsturen die getest moeten worden. U kan ook de archieven van de bugs@openbsd.org mailinglijst volgen, details op de mailinglijst pagina, of de status van de bug rapport databank opvragen via het on-line Bug Tracking System.

Meer over het vergaren van nuttige informatie voor ontwikkelaars

De "Panic message" kwijt?
In sommige omstandigheden kan u het allereerste bericht van een panic kwijt raken, die net de reden voor de panic geeft. Dit is een heel belangrijk bericht, dus u wil het zeker ook rapporteren. U kan dit terugkrijgen door het "show panic" commando in ddb> als volgt:

In dit geval was de panic string "Kernel: page fault trap, code=0"

Speciale nota voor SMP systemen:
U kunt best van elke processor een "trace" opvragen voor uw rapport:

Herhaal de "machine ddb x" gevolgd door "trace" voor elke processor in uw machine.

[FAQ Index] [Naar Sectie 1 - Inleiding tot OpenBSD] [Naar Sectie 3 - Verkrijgen van OpenBSD]