Resumo

  • A RFC 10035 inclui na YANG Library a lista somente de leitura augmented-by, pela qual o servidor informa quais módulos aumentam diretamente outro no mesmo module-set — dependências inversas que o módulo-base não encontra ao analisar apenas sua própria fonte.
  • A lista não é transitiva. Se B adiciona um nó sob A e C adiciona uma folha sob o nó definido por B, A lista B e B lista C; C não vira um augment direto de A só porque seu caminho começa em A.
  • O resultado é uma adjacência direta, versionada e específica de um servidor. Qualquer afirmação sobre o esquema efetivo ainda precisa de content-id, revisões, acesso, travessia do cliente, fontes analisadas e resultado observado.

Em uma dependência convencional, quem precisa fala. O import de YANG, definido na RFC 7950, nomeia o módulo cujas definições serão usadas. O include nomeia o submódulo incorporado. Um parser parte do arquivo e enxerga os vínculos que saem dele.

O augment externo fala em outro lugar. Um segundo módulo aponta para um alvo na árvore de esquema do primeiro e insere novos nós. O visitante conhece a casa; a casa não passa a conter uma lista de visitantes. Por isso, uma leitura impecável do módulo-base pode produzir uma visão incompleta do esquema efetivo.

Publicada na trilha de padrões do IETF em agosto de 2026, a RFC 10035, YANG Library: Addition of the augmented-by List, corrige esse ponto específico e atualiza a RFC 8525. Zhuoyao Lin, Benoît Claise e Ignacio Dominguez Martinez-Casanueva são seus autores. A nova leaf-list augmented-by permite que o servidor declare os módulos que aumentam diretamente cada entrada da biblioteca.

O histórico de Claise ajuda a entender o foco operacional sem transformar o documento em obra individual. Seu perfil do IETF, capturado em 31 de agosto de 2026, lista 45 RFCs, entre elas a RFC 10035, e funções públicas naquele momento em gestão e operações de rede, revisão de métricas, um workshop do IAB e apoio ao YangCatalog. Uma biografia do IETF 104 registra seu trabalho como codiretor da área Operations and Management entre 2012 e 2018 e a atuação em YANG, telemetria e automação. São credenciais datadas de contribuição coletiva, não controle sobre implementações.

A dependência mora no módulo que modifica

import e include aparecem no lado que consome. Um augment externo aparece no lado que altera. A RFC 10035 o trata, com deviation, como dependência inversa porque a forma ou o comportamento ligados à base podem mudar por uma declaração fora dela.

A YANG Library já conseguia identificar módulos de desvio. Faltava um caminho semelhante para os aumentos. Pesquisar um catálogo inteiro produz possibilidades; não revela quais módulos um servidor específico reúne. augmented-by responde no contexto do servidor: tanto o módulo-base quanto o módulo que aumenta precisam constar no mesmo module-set.

Assim, a aresta não descreve uma relação universal. Ela informa que, naquela instância de biblioteca, um módulo aumenta diretamente outro. É evidência de descoberta, não certificado de esquema completo, de correção do código ou de segurança da automação.

O pai imediato decide quem aumenta quem

O exemplo decisivo da RFC usa três módulos. A define foo-a. B acrescenta foo-b sob esse nó. C acrescenta uma folha sob foo-b.

O caminho de C está enraizado em A, mas o pai imediato da folha foi definido por B. A biblioteca lista B em A e C em B. Ela não lista C em A como relação direta.

Essa recusa em achatar o grafo conserva o significado da aresta. Copiar todo descendente para todo ancestral misturaria a declaração do servidor com o fechamento calculado pelo cliente, esconderia o ponto de conexão e multiplicaria entradas redundantes.

Se uma aplicação precisa do fechamento, percorre A→B→C. Se precisa saber a dependência de um nó, baixa as fontes e analisa a árvore. Versão do algoritmo, profundidade, ciclos, revisões e erros ficam sob responsabilidade do cliente. O servidor entrega o mínimo interoperável: vizinhança direta.

content-id dá idade ao mapa

A RFC 8525 vincula a informação atual da YANG Library de um servidor a um content-id, que deve mudar quando a biblioteca muda. O cliente pode usar o valor para cache e buscar uma nova instância depois de uma alteração. A RFC 10035 também orienta atualizar a biblioteca e augmented-by quando novos módulos são incorporados.

Uma captura A→B sem servidor, endpoint, horário, module-set e content-id não tem estado verificável. Uma ausência pode significar que não há augment direto, mas também biblioteca antiga, falta de suporte à RFC 10035, filtragem de acesso ou relatório incorreto.

O recibo precisa guardar principal autenticado, resultado de autorização, datastore, nomes, revisões, namespaces e arestas exatas. O fechamento derivado deve ficar em registro separado, com fontes, versão da travessia, limites e falhas. Só assim uma conclusão local não se passa por declaração do servidor.

Somente leitura ainda pode ser sensível

augmented-by não escreve configuração, mas pode revelar módulos opcionais, recursos ou componentes da implementação. A RFC 10035 alerta que isso pode favorecer ataques dirigidos e recomenda limitar a leitura a usuários autorizados por controles de acesso de gestão.

Sujeitos diferentes podem enxergar bibliotecas diferentes. “Não retornado” pode ser efeito de política, não prova de inexistência. O resultado de acesso deve acompanhar qualquer alegação de que uma relação está ausente.

A lista também aumenta a instância da YANG Library. Operadores precisam mantê-la; clientes precisam invalidar cache. A escolha econômica é fazer o servidor publicar uma unidade pequena e confiável, deixando a análise profunda para as aplicações que realmente precisam dela.

A topologia do modelo não é o comportamento do servidor

Uma aresta correta A→B não prova que o cliente entendeu o esquema efetivo. Ele ainda precisa obter a revisão certa, analisar B, seguir B→C quando necessário, tratar desvios, features, datastore e escopo de acesso.

O grafo também não prova que a implementação em execução corresponde ao modelo. A RFC 8342 organiza as visões de dados relevantes à gestão de rede. Configuração, estado, telemetria e resultado da automação fecham a prova sobre o sistema real.

O registro útil liga aresta, fonte, parser, decisão e resultado. Ele preserva a diferença entre expectativa e observação e nomeia o dono da exceção. Running-Code Primacy não dispensa o mapa; impede que o mapa declare sozinho o que aconteceu no território.

Fontes