YANG Grouping for UDP Clients and UDP Servers

This documents defines two YANG 1.1 modules to support the configuration of UDP clients and UDP servers, either as standalone or in conjunction with configuration of other protocol layers.

The "ietf-udp-client" YANG module defines the "udp-client-grouping" grouping for configuring UDP clients.

The following tree diagram illustrates the "udp-client-grouping" grouping:

The "ietf-udp-client" YANG module defines the "udp-client-grouping" grouping.

file "ietf-udp-client@2024-01-22.yang" module ietf-udp-client { yang-version 1.1; namespace "urn:ietf:params:xml:ns:yang:ietf-udp-client"; prefix udpc; import ietf-inet-types { prefix inet; reference "RFC 6991: Common YANG Data Types"; } organization "IETF NETCONF (Network Configuration) Working Group"; contact "WG Web: WG List: Authors: Alex Huang Feng Pierre Francois "; description "Defines a generic grouping for UDP-based client applications. Copyright (c) 2023 IETF Trust and the persons identified as authors of the code. All rights reserved. Redistribution and use in source and binary forms, with or without modification, is permitted pursuant to, and subject to the license terms contained in, the Revised BSD License set forth in Section 4.c of the IETF Trust's Legal Provisions Relating to IETF Documents (https://trustee.ietf.org/license-info). This version of this YANG module is part of RFC-to-be; see the RFC itself for full legal notices."; revision 2024-01-22 { description "Initial revision"; reference "RFC-to-be: YANG Grouping for UDP Clients and UDP Servers"; } grouping udp-client-grouping { description "Provides a reusable grouping for configuring a UDP client."; leaf remote-address { type inet:ip-address-no-zone; mandatory true; description "IP address of the UDP client, which can be an IPv4 address or an IPV6 address."; } leaf remote-port { type inet:port-number; mandatory true; description "Port number of the UDP client."; } } } ]]>



    
      The "ietf-udp-server" YANG module defines the "udp-server-grouping" grouping for
      configuring UDP servers.

      
        The following tree diagram  illustrates the 
        "udp-server-grouping" grouping:
        
          
              
            
        
      

      
        The "ietf-udp-server" YANG module defines the "udp-server-grouping" grouping.

                  
               file "ietf-udp-server@2024-01-22.yang"
module ietf-udp-server {
  yang-version 1.1;
  namespace
    "urn:ietf:params:xml:ns:yang:ietf-udp-server";
  prefix udps;
  import ietf-inet-types {
    prefix inet;
    reference
      "RFC 6991: Common YANG Data Types";
  }

  organization "IETF NETCONF (Network Configuration) Working Group";
  contact
    "WG Web:   
     WG List:  

     Authors:  Alex Huang Feng
               
               Pierre Francois
               ";

  description
    "Defines a generic grouping for UDP-based server applications.

    Copyright (c) 2023 IETF Trust and the persons identified as
    authors of the code.  All rights reserved.

    Redistribution and use in source and binary forms, with or without
    modification, is permitted pursuant to, and subject to the license
    terms contained in, the Revised BSD License set forth in Section
    4.c of the IETF Trust's Legal Provisions Relating to IETF Documents
    (https://trustee.ietf.org/license-info).

    This version of this YANG module is part of RFC-to-be; see the RFC
    itself for full legal notices.";

  revision 2024-01-22 {
    description
      "Initial revision";
    reference
      "RFC-to-be: YANG Grouping for UDP Clients and UDP Servers";
  }

  grouping udp-server-grouping {
    description
      "Provides a reusable grouping for configuring a UDP servers.";

    leaf local-address {
      type inet:ip-address-no-zone;
      mandatory true;
      description
        "IP address of the UDP server, which can be an
        IPv4 address or an IPV6 address.";
    }

    leaf local-port {
      type inet:port-number;
      mandatory true;
      description
        "Port number of the UDP server.";
    }
  }
}
]]>
            

          
      

    


    
      Following the guidelines for UDP applications defined in 
      , "applications that need to protect their
      communications against eavesdropping, tampering, or message forgery
      SHOULD employ end-to-end security services provided by other IETF protocols".
      A UDP client and server can use DTLS 
       to encrypt the payloads.

      For configuring a UDP application with DTLS encryption, the groupings
      "tls-client-grouping" and "tls-server-grouping" defined in "ietf-tls-client"
      and "ietf-tls-server" modules can be used 
      .
    

    
      This document describes the URIs from IETF
      XML Registry and the registration of a two new YANG module names
      
        IANA is requested to assign two new URI from the IETF XML Registry. The following two URIs are
        suggested:

        
            
          

        
            
          
      

      
        This document also requests two new YANG module names in the
        YANG Module Names registry with the
        following suggestions:

        
            
          

        
            
          
      
    

    
      The authors would like to thank xxx for their review and valuable
      comments.