Warum GPLv3 in Embedded-Produkten zum Problem wird
Open Source ist in Embedded Linux allgegenwärtig - Kernel, U-Boot, BusyBox, Bibliotheken, Werkzeuge. Die meisten Komponenten stehen unter GPLv2 oder permissiven Lizenzen (MIT, BSD), die gut handhabbar sind: Quelltext anbieten, Lizenztext beilegen, Änderungen dokumentieren. GPLv3 geht weiter und kann mit Produktanforderungen kollidieren, die im Embedded-Bereich üblich sind.
Der kritische Punkt ist Anti-Tivoization: GPLv3 verlangt für „User Products", dass zusammen mit dem Objektcode auch die „Installation Information" geliefert wird - also alles, was nötig ist, um modifizierte Versionen auf dem Gerät zu installieren und auszuführen. Wer ein Gerät mit signiertem Bootloader ausliefert, der nur eigene Images akzeptiert, kann diese Anforderung unter Umständen nicht erfüllen, ohne die Sicherheitsarchitektur aufzugeben. Genau hier reiben sich Secure Boot und GPLv3.
Dazu kommen Beschaffungs- und Compliance-Seiten: Viele Kunden und Ausschreibungen verlangen eine vollständige Lizenzliste, Quelltext-Angebote und den Nachweis, dass keine problematischen Lizenzen im Image sind. „Wir haben das nicht gewusst" ist keine Strategie - GPLv3-Komponenten schleichen sich über Abhängigkeiten ein, oft in Werkzeugen, die niemand bewusst installiert hat. Dieser Artikel zeigt einen Workflow, der sie sichtbar macht, bevor das Produkt ausgeliefert wird.
GPLv2 vs GPLv3: die praktischen Unterschiede
Beide Lizenzen sind Copyleft: Wer eine abgeleitete Version verbreitet, muss sie unter derselben Lizenz lizenzieren und den Corresponding Source mitliefern. Für Embedded-Produkte heißt das konkret: Quelltext der GPL-Komponenten (inklusive eigener Änderungen) anbieten, Lizenztext beilegen, Build-Skripte und Rezepte zugänglich machen. Das ist mit Yocto gut machbar - der Aufwand liegt in der Disziplin, nicht in der Technik.
GPLv3 fügt drei wesentliche Verschärfungen hinzu: Erstens die Anti-Tivoization-Klausel (Installation Information für User Products), die signierte Bootloader direkt betrifft. Zweitens eine explizite Patentlizenz - wer GPLv3-Code verbreitet, gewährt downstream eine Patentlizenz auf seine wesentlichen Patentansprüche, die den Code betreffen; das kann für patenthaltige Produkte relevant sein. Drittens strengere Kündigungs- und Kompatibilitätsregeln: GPLv3 ist mit mehr Lizenzen kompatibel (etwa Apache-2.0), aber Verstöße führen schneller zum Erlöschen der Rechte.
Für die Praxis folgt daraus: GPLv2-Komponenten sind meist unproblematisch, solange Quelltext und Lizenztext sauber mitgeliefert werden. GPLv3-Komponenten brauchen eine zusätzliche Bewertung - nicht, weil sie „schlechter" wären, sondern weil ihre Anforderungen mit Produktentscheidungen (signierte Updates, gesperrte Bootloader, Patentstrategie) kollidieren können. Diese Bewertung ist eine Architektur- und Rechtsfrage, keine reine Build-Frage. Eine Faustregel für die Praxis: GPLv2-Komponenten mitliefern und sauber dokumentieren; GPLv3-Komponenten zuerst gegen die Produktarchitektur bewerten und erst dann einbauen. Wer die Reihenfolge umdreht, baut erst Fakten und sucht danach die Rechtfertigung - das ist der teuerste Weg durch die Compliance.
Wo GPLv3 steckt
Die üblichen Verdächtigen sind Standard-Unix-Werkzeuge: bash, coreutils, grep, sed, gawk, tar, gzip, findutils, less, readline, parted, dosfstools, cpio, bc, ed, time. Dazu LGPLv3-Bibliotheken wie gmp, libunistring, libidn2 und libelf - LGPL ist weniger streng, wird aber von vielen Compliance-Regeln ebenfalls erfasst. Dual-lizenzierte Pakete (etwa „GPLv2+ | LGPLv3+") zählen je nach Auslegung ebenfalls.
Gut zu wissen: Der Linux-Kernel steht unter GPLv2 (nicht v3), U-Boot unter GPLv2+, BusyBox unter GPLv2. Ein minimalistisches Image aus Kernel, U-Boot und BusyBox ist daher oft GPLv3-frei - das Yocto-Projekt testet die GPLv3-freie Build-Konfiguration ausdrücklich nur für core-image-minimal. Wer darüber hinaus Pakete installiert, muss prüfen.
Das Einschleichen passiert über drei Mechanismen: IMAGE_INSTALL zieht ein Paket direkt; PACKAGECONFIG aktiviert optionale Features mit eigenen Abhängigkeiten (eine Bibliothek braucht plötzlich readline); und RDEPENDS eines harmlosen Pakets holt zur Laufzeit ein GPLv3-Werkzeug herein. Keiner dieser Mechanismen ist im Image-Rezept allein sichtbar - erst das erzeugte License-Manifest zeigt das vollständige transitive Bild. Deshalb ist das Audit des Manifests, nicht des Rezepts, die verlässliche Methode.
- Shell und Grundwerkzeuge: bash, coreutils, grep, sed, gawk, tar, gzip, findutils
- Editoren und Pager: less, ed, nano (GPLv3+)
- Bibliotheken: readline, gmp (LGPLv3), libunistring (LGPLv3), libidn2, libelf (LGPLv3)
- Dateisystem- und Partitionswerkzeuge: parted, dosfstools, cpio
- Bootloader: GRUB (GPLv3+) - U-Boot ist GPLv2+
- Entwicklerwerkzeuge im Image: gdb, binutils, GCC-Laufzeit (GPLv3 mit Runtime-Exception)
Der Anti-Tivoization-Konflikt im Detail
GPLv3 §6 definiert „Installation Information" als alle Methoden, Prozeduren, Autorisierungsschlüssel oder sonstigen Informationen, die nötig sind, um modifizierte Versionen eines covered work in einem User Product zu installieren und auszuführen. Die Information muss ausreichen, damit das weiter funktionierende modifizierte Objektcode nicht allein wegen der Modifikation behindert wird. Ein „User Product" ist dabei ein Verbraucherprodukt - unabhängig davon, ob es auch kommerziell oder industriell genutzt wird, es sei denn, solche Nutzungen sind die einzig signifikante Verwendungsform.
Für ein Gerät mit HAB-geschlossenem Bootloader bedeutet das: Wenn der Bootloader nur vom Hersteller signierte Images akzeptiert und der Hersteller die Signaturschlüssel nicht herausgibt, kann der Nutzer keine modifizierte GPLv3-Komponente installieren, die Teil der verifizierten Kette ist. Die FSF nennt genau diesen Zustand „Tivoization" - freie Software, die auf der Hardware faktisch unfrei wird. GPLv3 soll das verhindern; ein Secure-Boot-Design, das die gesamte Kette signiert, kann damit in Konflikt geraten.
Es gibt Auswege, die keine Rechtsberatung ersetzen, aber die Architektur entspannen: Erstens die ROM-Ausnahme - die Anforderung gilt nicht, wenn weder der Hersteller noch Dritte modifizierten Objektcode installieren können (etwa bei fest verdrahteter ROM). Zweitens die Trennung: GPLv3-Komponenten laufen außerhalb der signierten, verifizierten Kette (etwa als separate Anwendung auf einem beschreibbaren Bereich), sodass ihre Modifikation nicht die Boot-Kette berührt. Drittens die bewusste Compliance: Installation Information bereitstellen, wo das Produktmodell es erlaubt. Welche Option passt, hängt vom Gerät, vom Markt und von der Risikobereitschaft ab - eine technische Lizenzanalyse liefert die Fakten für diese Entscheidung.
Lizenz-Tracking in Yocto
Yocto trackt Lizenzen auf Rezept-Ebene: Jedes Rezept setzt LICENSE (etwa „MIT", „GPL-3.0-only") und LIC_FILES_CHECKSUM (Pfad plus Checksumme der Lizenzdatei im Quelltext). Letzteres stellt sicher, dass sich die Lizenz zwischen Builds nicht unbemerkt ändert. Die Standard-Lizenztexte liegen in meta/files/common-licenses; die Namen dort sind die kanonischen Lizenz-Strings.
Beim Image-Build erzeugt Yocto ein License-Manifest unter ${DEPLOY_DIR}/licenses/${SSTATE_PKGARCH}/<image>-<machine>.rootfs-<datestamp>/. Es listet pro Paket: Name, Version, Rezept und Lizenz - die verlässliche Grundlage für jedes Audit. Daneben liegen das Package-Manifest (welche Pakete tatsächlich im Image sind) und das License-Manifest auf Dateiebene. Wer nur die installierten Pakete betrachtet, übersieht Build-Abhängigkeiten - für die Auslieferung zählt aber das Image.
Ein oft übersehener Punkt: LIC_FILES_CHECKSUM ist ein Änderungsdetektor. Ändert ein Upstream-Update die Lizenzdatei (etwa von GPLv2 auf GPLv3, oder ein neues Copyright), schlägt der Build fehl, bis die Checksumme bewusst aktualisiert wird. Das ist kein Ärgernis, sondern eine Sicherheitsfunktion: Lizenzänderungen können nicht stillschweigend einfließen. Wer die Checksumme aktualisiert, sollte die Änderung im Rezept-Kommentar oder Commit dokumentieren - so bleibt nachvollziehbar, wann und warum sich die Lizenzlage eines Pakets verschoben hat.
# Example excerpt from a license manifest:
PACKAGE NAME: bash
PACKAGE VERSION: 5.0
RECIPE NAME: bash
LICENSE: GPLv3+
PACKAGE NAME: u-boot
VERSION: 2024.01
RECIPE NAME: u-boot
LICENSE: GPLv2+Lizenztexte und Quelltext ausliefern
GPLv2 und GPLv3 verlangen, dass Lizenztext und Corresponding Source mitgeliefert werden. Yocto macht das einfach: COPY_LIC_MANIFEST und COPY_LIC_DIRS legen die Lizenztexte ins Image (/usr/share/common-licenses bzw. /usr/share/license), LICENSE_CREATE_PACKAGE erzeugt ein separates Paket mit Upgrade-Pfad für später installierte Software. Achtung: Alle drei zusammen erzeugen zwei Kopien der Lizenzdateien - das ist erwartet, kein Fehler.
Für den Quelltext gibt es die Archiver-Klasse: Sie archiviert die Original-Quellen der erfassten Lizenzen (COPYLEFT_LICENSE_INCLUDE) samt Patches und Build-Skripten. Ein Source-Release sollte die geänderten Quellen, die Rezepte/Layer und die Build-Konfiguration umfassen - damit ist die Anforderung „Compilation Scripts und Source-Modifikationen" erfüllt. Das gesamte DL_DIR auszuliefern ist eine Alternative, aber grob und oft unvollständig gepatcht.
Beim Quelltext-Angebot selbst lohnt der Blick ins Detail: GPLv2 und GPLv3 erlauben alternativ zur direkten Mitlieferung ein schriftliches Angebot, den Quelltext auf Anfrage bereitzustellen (GPLv3 §6b: gültig für mindestens drei Jahre, solange das Produkt angeboten wird). Für Embedded-Produkte mit langen Support-Zeiträumen ist das oft die praktikablere Variante - das Image bleibt schlank, und das Angebot wird zusammen mit der Lizenzdokumentation ausgeliefert. Wichtig ist, dass das Angebot tatsächlich einlösbar bleibt: Wer den Quelltext archiviert, muss ihn über den gesamten Support-Zeitraum vorhalten können.
# local.conf or distro.conf - license texts into the image
COPY_LIC_MANIFEST = "1"
COPY_LIC_DIRS = "1"
LICENSE_CREATE_PACKAGE = "1"
# Archive copyleft sources for the source offer
INHERIT += "archiver"
COPYLEFT_LICENSE_INCLUDE = "GPL* LGPL*"
ARCHIVER_MODE[src] = "patched"GPLv3 gezielt ausschließen
Wer GPLv3 vermeiden will, setzt INCOMPATIBLE_LICENSE in der Distro- oder Local-Konfiguration - nicht im Image-Rezept (dort wirkt es nur lokal). Die Einstellung beeinflusst den gesamten Abhängigkeitsbaum: Pakete mit blacklisted Lizenz werden nicht gebaut, und das Image schlägt fehl, wenn eine Abhängigkeit sie doch braucht. Genau das ist der gewünschte Effekt - der Build-Fehler listet die problematischen Pakete samt Lizenz auf und wird zur To-do-Liste.
Die Praxis: Ein GPLv3-freies core-image-minimal ist getestet; darüber hinaus braucht es Ersatz. BusyBox ersetzt viele GNU-Utilities (grep, sed, tar, gzip, coreutils) in einer GPLv2-Variante; für bash gibt es Alternativen wie ash/dash. Manche Pakete lassen sich entfernen, andere sind harte Abhängigkeiten - dann bleibt nur Compliance statt Vermeidung. Wichtig: INCOMPATIBLE_LICENSE ist ein Build-Filter, kein rechtlicher Freifahrtschein; die Lizenzliste des finalen Images bleibt die Wahrheit.
Verwandt, aber anders herum, ist LICENSE_FLAGS_ACCEPTED (früher LICENSE_FLAGS_WHITELIST): Damit werden Pakete mit kommerziellen oder speziellen Lizenz-Flags erst erlaubt, die sonst standardmäßig ausgeschlossen sind. Beide Mechanismen gehören in die Distro-Konfiguration unter Versionskontrolle, nicht in eine lokale Spielwiese - reproduzierbare Builds sind die Voraussetzung für jedes belastbare Lizenz-Audit. Wer die Flags nur lokal setzt, bekommt ein Image, dessen Lizenzlage sich mit dem nächsten Build still ändert.
# Distro/local.conf - exclude GPLv3 family build-wide
INCOMPATIBLE_LICENSE = "GPL-3.0* LGPL-3.0* AGPL-3.0*"
# Per-image variant:
INCOMPATIBLE_LICENSE:pn-my-image = "GPL-3.0* LGPL-3.0*"
# The build error becomes the audit list, e.g.:
# ERROR: my-image-1.0-r0 do_rootfs: Packages have blacklisted licenses:
# bash (GPLv3+), coreutils (GPLv3+), grep (GPLv3), tar (GPLv3), ...SPDX und Software Bill of Materials
Moderne Yocto-Releases erzeugen auf Wunsch SPDX-Dokumente (create-spdx-Klasse): eine maschinenlesbare SBoM mit Komponenten, Versionen, Lizenzen und Patches. Das erfüllt einen Teil der Compliance-Anforderungen (Lizenztexte und Quelltext-Angebot bleiben separat) und liefert nebenbei die Grundlage für Vulnerability-Assessments - CVE-Abgleich braucht Komponente plus Version, und genau das steht in der SBoM.
Für Produkte mit langen Lebenszyklen (Energiemonitoring, Medizintechnik, Industrie) ist die SBoM doppelt wertvoll: Sie dokumentiert den Auslieferungszustand lückenlos und macht spätere Sicherheitsupdates planbar. Wer CRA-Konformität anstrebt, kommt an einer gepflegten SBoM ohnehin nicht vorbei.
Die SPDX-Ausgabe kommt in zwei Ebenen: ein Dokument auf Image-Ebene (die vollständige SBoM des Auslieferungsstands) und Pakete auf Rezept-Ebene. Für die Lizenzprüfung ist die Image-SBoM maßgeblich, weil sie den transitiven Abschluss zeigt; die Rezept-SBoM hilft beim Tracen einzelner Komponenten. Beide Formate sind maschinenlesbar (SPDX JSON oder Tag-Value) und lassen sich in CI-Pipelines diffen - ein neuer Eintrag mit GPL-3.0-Lizenz fällt so sofort auf, statt erst im Kunden-Audit.
# Generate SPDX SBoM alongside the image
INHERIT += "create-spdx"Ein Risk-Scan-Workflow für die Praxis
Zusammengefasst ergibt sich ein wiederholbarer Ablauf, der sich in CI verankern lässt:
Der richtige Zeitpunkt ist vor jedem Release - und einmal tief vor der ersten Auslieferung eines neuen Produkts. Ein Release-Scan vergleicht den aktuellen Lizenzstand mit dem vorigen und markiert Änderungen; der Tiefen-Scan bewertet jede GPLv3/LGPLv3-Komponente gegen die Produktarchitektur. Beides zusammen deckt die zwei Fehlertypen ab: unbemerkte neue Abhängigkeiten und übersehene Architekturkonflikte. Wer nur den Release-Scan fährt, übersieht den Konflikt, der schon immer da war; wer nur den Tiefen-Scan fährt, übersieht die Änderung, die gestern hinzukam.
- Build mit License-Manifest und SPDX-Erzeugung - der Ist-Zustand wird dokumentiert.
- Klassifizieren: Manifest nach Lizenzfamilien gruppieren (GPLv2, GPLv3, LGPLv3, permissiv, kommerziell).
- Tracen: Für jede GPLv3/LGPLv3-Komponente das Rezept und die Abhängigkeitskette prüfen - wer hat sie hineingezogen?
- Bewerten: Kollidiert die Lizenz mit der Produktarchitektur (Anti-Tivoization, signierte Updates)? Ist das Gerät ein „User Product"?
- Entscheiden: Ersetzen (BusyBox/Alternativen), isolieren (getrennte Prozesse, klare Grenzen) oder compliant ausliefern (Installation Information, Quelltext-Angebot).
- Berichten: Schriftlicher Risk-Report mit Go/No-Go-Empfehlung - die Grundlage für Legal- und Beschaffungsentscheidungen.
Der Workflow ist bewusst konservativ: Er ersetzt keine Rechtsberatung, aber er macht die technischen Fakten sichtbar, auf denen jede rechtliche Bewertung aufsetzt. Die meisten Überraschungen entstehen nicht durch böse Absicht, sondern durch unbemerkte Abhängigkeiten - ein Build, der GPLv3 hart ausschließt, und ein Manifest, das jeder lesen kann, nehmen ihnen die Bühne.
Wer den Scan einmal extern durchführen lassen will - etwa vor einer Ausschreibung oder einem Kunden-Audit - findet im Yocto Risk Scan ein fest umrissenes Angebot: Build- und Lizenz-Scan, schriftlicher Risk-Report und Go/No-Go-Zusammenfassung.
In CI lohnt sich der günstige Teil zur Automatisierung: Manifest und SPDX bei jedem Release-Build erzeugen, die Lizenzfamilien gegen das vorige Release diffen und jeden neuen GPLv3/LGPLv3-Eintrag zur Prüfung markieren. Das macht Compliance aus einem einmaligen Audit eine kontinuierliche Wache - eine neue Abhängigkeit kann nicht unbemerkt ins Auslieferungs-Image rutschen. Die tiefere Bewertung (Anti-Tivoization, Produktklassifikation) bleibt eine menschliche Entscheidung, startet aber von einem sauberen, aktuellen Manifest statt von Archäologie.
