Zusammenfassung

  • RFC 9907 ist BCP 216 vom März 2026. Die Best Current Practice richtet sich an Autoren und Reviewer von Spezifikationen mit YANG-Datenmodellen, einschließlich IANA-gepflegter Module.
  • Der RFC ersetzt RFC 8407 und aktualisiert RFC 8126. Code-Grenzen, eindeutige Namen, Revisionsnachweise, NMDA-Semantik und Registry-Verfahren werden dadurch zu überprüfbaren Qualitätsmerkmalen.
  • Er ändert kein Drahtprotokoll und garantiert keine interoperablen Implementierungen. Seine Wirkung liegt in einem belastbaren Prozess vor der Veröffentlichung.

Ein YANG-Datenmodell ist die abstrakte Beschreibung von Daten, Beziehungen und Regeln. Ein Modul ist dagegen eine einzelne YANG-Datei, die einen Teil dieses Modells umsetzt. Diese Unterscheidung ist entscheidend: Ein Parser kann ein Modul akzeptieren, obwohl weiterhin unklar ist, wann ein Objekt entsteht oder verschwindet, welcher Datenspeicher zuständig ist und wer eine Registeränderung autorisiert.

Normative YANG-Module und Submodule in einem Internet-Draft oder RFC müssen mit CODE BEGINS und CODE ENDS abgegrenzt werden. Für Autoren markieren diese Tags die verlässliche Grenze des Code-Bestandteils; für Reviewer machen sie den zu prüfenden Gegenstand eindeutig. Veröffentlichte Modulnamen müssen eindeutig sein. Normative IETF-Module beginnen mit ietf-, Beispielmodule mit example-. Ein Beispiel bleibt eine Erläuterung und wird dadurch nicht normativ.

Der Modul-Header muss die aktuelle Copyright-Erklärung des IETF Trust enthalten und das YANG Parameters Registry benennen. Verweise, die nicht bereits durch importierte Module abgedeckt sind, gehören in reference-Statements. Für jede veröffentlichte Revision ist ein revision-Statement erforderlich, dessen Verweis das Dokument nennt, in dem das Modul enthalten ist. So bleibt extrahierter Code ein prüfbares Artefakt und wird nicht zu einem losgelösten Fragment.

Die inhaltliche Prüfung endet nicht bei Syntax und Namenskonventionen. Im Sinn von YANG 1.1 und der Network Management Datastore Architecture (NMDA) muss die Spezifikation erklären, wie Konfiguration und Betriebszustand zusammenhängen, welcher Datenspeicher welche Werte trägt und welche Operationen im Lebenszyklus eines Objekts zulässig sind. Dokumentation, Sprachgebrauch, Beispiele, Sicherheitsanalyse und IANA Considerations gehören ebenfalls in die Prüfung. Beispiele illustrieren; sie ersetzen keine normative Semantik.

Bei IANA-gepflegten YANG-Modulen ist das Registry-Verfahren die maßgebliche Autorität. Eine erzeugte Moduldatei darf nicht einfach nachträglich editiert werden, um eine politische oder verwaltungstechnische Entscheidung zu simulieren. RFC 9907 ergänzt die allgemeine Registry-Leitlinie aus RFC 8126: Zuständigkeit, Änderungsweg und Bedingungen müssen ausdrücklich festgelegt sein. Maßgeblich ist also der Eintragungsprozess, nicht eine zufällig erzeugte Textfassung.

Checkliste vor der Veröffentlichung

  1. Sind alle normativen Code-Bestandteile mit CODE BEGINS und CODE ENDS begrenzt?
  2. Ist jeder Modulname eindeutig und beginnt er als IETF-Modul mit ietf- beziehungsweise als Beispiel mit example-?
  3. Enthält der Header die Trust-Copyright-Erklärung und den Verweis auf das YANG Parameters Registry?
  4. Stehen externe Verweise in den passenden reference-Statements?
  5. Verweist jede veröffentlichte Revision auf das Dokument, das ihr Modul enthält?
  6. Sind Datenmodell, einzelnes Modul und nichtnormatives Beispiel sauber unterschieden?
  7. Beschreibt die Spezifikation NMDA-Datenspeicher, Konfiguration, Betriebszustand und Lebenszyklus?
  8. Wurden Sprache, Beispiele, Sicherheitsanalyse und IANA Considerations fachlich geprüft?
  9. Folgt eine Änderung an einem IANA-gepflegten Modul dem Registry-Verfahren statt einer direkten Bearbeitung des erzeugten Textes?

Annahmeentscheidung für Betreiber

Ein Betreiber kann die Annahme empfehlen, wenn die Prüfnachweise vollständig sind und sich jedes Modul, jede Revision und jede Datenspeichersemantik auf Spezifikation oder Registry-Verfahren zurückführen lässt. Bleibt die Autorität für Lebenszyklus, Datenspeicher oder Register offen, geht das Modell an den Autor zurück. Bei einem IANA-gepflegten Modul wird die Entscheidung ausgesetzt, bis das zuständige Verfahren geklärt ist. Das ist ein Annahmekriterium für Dokumentqualität, kein Versprechen über das Verhalten jeder späteren Implementierung.

Quellen