## Mitwirken

Beiträge aller Art sind willkommen, einschließlich Korrekturen, Klarstellungen, neuer Beispiele, Übersetzungen und Reviews von FreeBSD-Entwicklern und -Lernenden gleichermaßen.

### Möglichkeiten zur Mitarbeit

- **Inhalt:** neue Kapitel hinzufügen, vorhandenes Material verfeinern
- **Technische Überprüfung:** Kapitel auf Richtigkeit für FreeBSD 14.x überprüfen
- **Übersetzungsüberprüfung:** Hilfe bei der Überprüfung und Verbesserung der KI-übersetzten **pt_BR**- und **es_ES**-Ausgaben; Muttersprachler mit FreeBSD-/Kernel-Erfahrung sind besonders willkommen
- **Neue Übersetzungen:** Hilfe bei der Übersetzung des Buches in eine andere Sprache
- **Code:** Beispiele, Build-Skripte und Werkzeuge verbessern
- **Issues:** Fehler, sachliche Fehler, unklare Passagen oder Formatierungsprobleme melden

### Ein Problem melden

Wenn Sie ein Issue einreichen, geben Sie bitte Folgendes an:

- Die Sprachversion, die Sie gelesen haben (`en_US`, `pt_BR`, `es_ES`)
- Das verwendete Format (PDF, EPUB, HTML oder Markdown)
- Das Kapitel oder der Abschnitt, in dem das Problem auftritt
- Eine kurze Erklärung des Problems und ggf. einen Korrekturvorschlag

### Arbeitsablauf

1. Repository forken
2. Einen Branch erstellen: `git checkout -b feature/your-change`
3. Änderungen vornehmen und den Build mit `scripts/build-book.sh` testen
4. Mit einer klaren Nachricht committen: `git commit -m "Chapter 18: clarify BAR mapping"`
5. Pushen und einen Pull Request öffnen

Wenn Sie beim Lesen des Buches nicht weiterkommen, **hilft das Einreichen eines Issues**. Wenn eine Passage falsch erscheint oder ein Labor unerwartet fehlschlägt, macht jeder Bericht den Weg für den nächsten Leser einfacher.

## Häufig gestellte Fragen

### Warum existiert dieses Buch?

Die ehrliche Antwort ist, dass das FreeBSD-Projekt neue Mitwirkende braucht und der Einstieg in die Kernel- und Treiberarbeit schon immer steiler war, als er sein sollte. Die meisten vorhandenen Materialien setzen voraus, dass Sie bereits UNIX, C gut, wissen, was ein Bus ist, und wissen, wie man einen Kernel-Quellbaum liest. Das funktioniert für diejenigen, die schon fast da sind. Für den neugierigen Entwickler, der anfangen möchte, tut es sehr wenig.

Das Ziel dieses Buches ist es, diese Einstiegshürde zu senken. Wenn auch nur eine kleine Anzahl von Lesern es beendet und dann Patches einreicht, Code überprüft, neue Treiber schreibt oder schließlich FreeBSD-Committer wird, hat das Buch seine Aufgabe erfüllt. **Die Ausbildung der nächsten Generation von FreeBSD-Mitwirkenden ist der Grund, warum dieses Werk geschrieben wurde.**

### Muss ich vorher C können?

Nein. Die Kapitel 4 und 5 lehren C von Grund auf und konzentrieren sich auf die Teile der Sprache, die für die Kernel-Arbeit wichtig sind (Zeiger, Strukturen, Speicherlayout, Präprozessor und Aufrufkonventionen). Wenn Sie C bereits gut beherrschen, zeigen Ihnen Randnotizen in diesen Kapiteln, was Sie überfliegen und was Sie genau lesen sollten.

### Muss ich UNIX oder FreeBSD kennen?

Nein. Kapitel 2 führt Sie durch die Installation von FreeBSD in einer VM oder auf einem physischen Rechner, und Kapitel 3 stellt die UNIX-Kommandozeile, das Dateisystem, Prozesse, Berechtigungen und Editoren vor. Am Ende von Teil 1 werden Sie ein funktionierendes Labor und das Vokabular haben, um es zu nutzen.

### Brauche ich echte Hardware?

Für den größten Teil des Buches: nein. Eine virtuelle Maschine mit FreeBSD 14.x reicht aus für die Grundlagen, die ersten Treiberkapitel, Parallelität und Synchronisation sowie einen großen Teil des Debugging-Materials. Echte Hardware wird nützlich (ist aber immer noch nicht zwingend erforderlich), wenn Sie die PCI-, Interrupt- und DMA-Kapitel in Teil 4 erreichen. Diese Kapitel sind so geschrieben, dass die Konzepte auch dann Sinn ergeben, wenn Sie sie nur in einer VM ausführen.

### Hilft mir dieses Buch, Linux-Treiber zu schreiben?

Indirekt ja. Die Disziplin der Kernelprogrammierung lässt sich sehr gut übertragen: Locking-Strategie, Speicherverwaltung, Interrupt-Kontext, DMA-Mapping, Unterschied zwischen schlafenden und nicht schlafenden Codepfaden, defensive Bereinigungsreihenfolge. Die spezifischen APIs unterscheiden sich. Nach der Lektüre dieses Buches werden Sie das Linux-Gerätemodell nicht kennen, aber Sie werden seine Probleme und die Form seiner Lösungen erkennen und Sie werden Linux Device Drivers (LDD) viel leichter lesen können.

### Warum speziell FreeBSD 14.x?

Jede API, jedes Beispiel und jedes Labor wurde für die Ausführung unter dem FreeBSD 14.3-Quellbaum und den entsprechenden `man 9`-Seiten konzipiert. Die Ausrichtung auf eine bestimmte Version ermöglicht es dem Buch, bei Funktionssignaturen, Header-Pfaden und Verhalten präzise zu sein. Die Konzepte werden 14.x um viele Jahre überdauern; die genauen Zeilennummern und kleinen API-Details werden das nicht, und das Buch ist ehrlich darin.

### Ist dies eine offizielle Veröffentlichung des FreeBSD-Projekts?

Nein. Dies ist ein unabhängiges Bildungsbuch über die Entwicklung von FreeBSD-Gerätetreibern. Es ist keine offizielle Veröffentlichung des FreeBSD-Projekts. Der Autor ist ein FreeBSD-Committer und Mitglied des Documentation Engineering Teams (DocEng), aber das Buch spiegelt seine Arbeit und Ansichten wider, nicht eine offizielle Position des Projekts.

### Wie lange wird mich das tatsächlich kosten?

Wenn Sie sorgfältig lesen und die Labore machen, rechnen Sie mit etwa 200 Stunden Gesamtarbeit. Das sind in etwa 100 Stunden Lesen und 100 Stunden praktischer Laborarbeit. Bei fünf Stunden pro Woche ist das ein etwa sechsmonatiges Abendprojekt; bei zehn Stunden pro Woche ein fokussierter zweimonatiger Sprint. Lesen ohne die Labore halbiert die Zeit ungefähr, halbiert aber auch den Wert: Kernelprogrammierung belohnt Muskelgedächtnis auf eine Weise, wie es nur wenige Disziplinen tun.

### Kann ich die Labore überspringen?

Sie können, aber wahrscheinlich sollten Sie nicht. Die Labore sind der Ort, an dem Prosa zum Reflex wird. Muster wie Attach-Reihenfolge, Bereinigungs-Rückwicklung und Lock-Erwerb tauchen in jedem Kapitel wieder auf, und der einzige zuverlässige Weg, sie zu verinnerlichen, ist, sie zu tippen, zu kompilieren, in einen laufenden Kernel zu laden und sie absichtlich scheitern zu sehen. Leser, die die Labore überspringen, berichten von Fortschritten, die sich anfangs glatt anfühlen und dann um Teil 3 oder Teil 4 herum leise ins Stocken geraten.

### Wie kann ich nach der Lektüre zu FreeBSD beitragen?

Kapitel 37 behandelt den vollständigen Einreichungsworkflow: wie man einen Patch vorbereitet, wie man Phabricator (das FreeBSD-Code-Review-System) verwendet, wie man einen Committer findet, der die Arbeit sponsert, wie man auf Review-Feedback reagiert und wie man einen Treiber in den Baum bringt. Die früheren Kapitel bauen die technischen Fähigkeiten auf; Kapitel 37 baut den sozialen Workflow auf. Beides ist wichtig.

### Das Buch ist riesig. Wo soll ich anfangen?

Beginnen Sie mit Kapitel 1, es sei denn, Sie haben einen Grund, es nicht zu tun. Das Buch ist kumulativ; spätere Kapitel stützen sich auf Vokabular und Gewohnheiten, die früher etabliert wurden. Wenn Sie bereits C, UNIX und die allgemeine Form eines OS-Kernels kennen, sagen Ihnen die Schnellpfad-Notizen in Teil 1, was Sie überfliegen können. Wenn ein bestimmtes Subsystem Sie hierher geführt hat (USB, Netzwerk, Speicher, PCI), ist es in Ordnung, die Teile 1 und 2 sorgfältig zu lesen und dann vorzuspringen, aber erwarten Sie, zurückzukehren, wenn Begriffe aus früheren Kapiteln wieder auftauchen.

### Ich habe einen Fehler gefunden. Was soll ich tun?

Öffnen Sie ein Issue auf GitHub. Geben Sie die Sprachversion, das Format, das Sie gelesen haben, das Kapitel oder den Abschnitt, eine kurze Beschreibung des Problems und einen Korrekturvorschlag an, falls Sie einen haben. Jeder Bericht macht die Erfahrung des nächsten Lesers besser. Übersetzungsprobleme in den pt_BR- und es_ES-Ausgaben sind besonders willkommen, da diese noch keine vollständige menschliche technische Überprüfung durchlaufen haben.

### Ist das Buch wirklich kostenlos?

Ja. Es ist unter der MIT-Lizenz veröffentlicht. Sie können es lesen, teilen, drucken, zitieren, darauf aufbauen und übersetzen. Eine Namensnennung wird geschätzt, ist aber für den persönlichen Gebrauch nicht erforderlich. Wenn Sie die Arbeit unterstützen möchten, sind die nützlichsten Dinge, die Sie tun können: anderen von dem Buch erzählen, Issues einreichen, wenn Sie Probleme finden, Reviews oder Übersetzungen beitragen und (wenn es Sie schließlich dorthin führt) Ihre eigene Arbeit beim FreeBSD-Projekt einreichen.

## Über den Autor

Ich bin Edson Brandi. Mein Weg in die Technologie war alles andere als konventionell. Ich begann 1995 als Chemiestudent an der Unicamp in Brasilien, ohne Plan, mit Computern zu arbeiten, aber mit einer beharrlichen Frage: *Wie funktioniert das eigentlich?* Diese Frage führte mich zu FreeBSD, und FreeBSD hat meine Karriere seitdem geprägt.

In den folgenden Jahren gründete ich die **Brazilian FreeBSD User Group (FUG-BR)**, war Mitbegründer des **FreeBSD LiveCD Tool Set** und gründete 2002 gemeinsam mit anderen **FreeBSD Brasil**, ein Unternehmen, das FreeBSD-Schulungen, -Beratung und -Support anbietet und noch heute tätig ist. Ich bin FreeBSD-Committer und derzeit Mitglied des **FreeBSD Documentation Engineering Teams (DocEng)**, das die Systeme wartet, die FreeBSDs Dokumentation weltweit am Leben und zugänglich halten.

Beruflich habe ich meine Karriere in der Infrastruktur- und Engineering-Leitung in mehreren Branchen verbracht und bin heute IT-Direktor bei einem Fintech-Unternehmen in London.

Ich habe dieses Buch geschrieben, weil ich möchte, dass andere neugierige Menschen den Einstieg haben, den ich nie hatte. Sie brauchen keinen Informatikabschluss, um Kernel-Code zu schreiben. Was Sie brauchen, ist Neugier, Ausdauer, Geduld und einen Leitfaden, der Sie dort abholt, wo Sie stehen.

Edson Brandi · [email protected]

## Lizenz

Dieses Buch und der dazugehörige Quellcode sind unter der **MIT-Lizenz** veröffentlicht. Siehe [LICENSE](https://github.com/ebrandi/fdd-book/blob/HEAD/LICENSE) für den vollständigen Text. Sie können dieses Werk frei lesen, teilen und darauf aufbauen; eine Namensnennung wird geschätzt.

## Danksagungen

- Die FreeBSD-Entwicklungsgemeinschaft
- Alle Mitwirkenden, Prüfer und Übersetzer
- Jeder, der jemals ein Issue eingereicht oder eine Frage gestellt hat, die ein Kapitel verbessert hat

## Links

- **Repository:** https://github.com/ebrandi/FDD-book
- **Issues:** https://github.com/ebrandi/FDD-book/issues
- **Diskussionen:** https://github.com/ebrandi/FDD-book/discussions
- **Autor:** Edson Brandi · [email protected]

---

<p align="center"><em>Wenn dieses Buch Ihnen hilft, geben Sie bitte einen Stern auf das Repository und teilen Sie es mit jemandem, der auch neugierig ist, wie Computer wirklich funktionieren.</em></p>