netconfcentral logo

ietf-netconf-with-defaults@2011-06-01



  module ietf-netconf-with-defaults {

    yang-version 1;

    namespace
      "urn:ietf:params:xml:ns:yang:ietf-netconf-with-defaults";

    prefix ncwd;

    import ietf-netconf {
      prefix nc;
    }

    organization
      "IETF NETCONF (Network Configuration Protocol) Working Group";

    contact
      "WG Web:   <http://tools.ietf.org/wg/netconf/>

WG List:  <netconf@ietf.org>

WG Chair: Bert Wijnen
	  <bertietf@bwijnen.net>

WG Chair: Mehmet Ersue
	  <mehmet.ersue@nsn.com>

Editor: Andy Bierman
	<andy.bierman@brocade.com>

Editor: Balazs Lengyel
	<balazs.lengyel@ericsson.com>";

    description
      "This module defines an extension to the NETCONF protocol
that allows the NETCONF client to control how default
values are handled by the server in particular NETCONF
operations.

Copyright (c) 2011 IETF Trust and the persons identified as
the document authors.  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 Simplified BSD License
set forth in Section 4.c of the IETF Trust's Legal Provisions
Relating to IETF Documents
(http://trustee.ietf.org/license-info).

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

    revision "2011-06-01" {
      description "Initial version.";
      reference
        "RFC 6243: With-defaults Capability for NETCONF";

    }


    typedef with-defaults-mode {
      type enumeration {
        enum "report-all" {
          value 0;
          description
            "All default data is reported.";
          reference
            "RFC 6243; Section 3.1";

        }
        enum "report-all-tagged" {
          value 1;
          description
            "All default data is reported.
Any nodes considered to be default data
will contain a 'default' XML attribute,
set to 'true' or '1'.";
          reference
            "RFC 6243; Section 3.4";

        }
        enum "trim" {
          value 2;
          description
            "Values are not reported if they contain the default.";
          reference
            "RFC 6243; Section 3.2";

        }
        enum "explicit" {
          value 3;
          description
            "Report values that contain the definition of
explicitly set data.";
          reference
            "RFC 6243; Section 3.3";

        }
      }
      description
        "Possible modes to report default data.";
      reference
        "RFC 6243; Section 3.";

    }

    grouping with-defaults-parameters {
      description
        "Contains the <with-defaults> parameter for control
of defaults in NETCONF retrieval operations.";
      leaf with-defaults {
        type with-defaults-mode;
        description
          "The explicit defaults processing mode requested.";
        reference
          "RFC 6243; Section 4.5.1";

      }
    }  // grouping with-defaults-parameters

    augment /nc:get-config/nc:input {
      description
        "Adds the <with-defaults> parameter to the
input of the NETCONF <get-config> operation.";
      reference
        "RFC 6243; Section 4.5.1";

      uses with-defaults-parameters;
    }

    augment /nc:get/nc:input {
      description
        "Adds the <with-defaults> parameter to
the input of the NETCONF <get> operation.";
      reference
        "RFC 6243; Section 4.5.1";

      uses with-defaults-parameters;
    }

    augment /nc:copy-config/nc:input {
      description
        "Adds the <with-defaults> parameter to
the input of the NETCONF <copy-config> operation.";
      reference
        "RFC 6243; Section 4.5.1";

      uses with-defaults-parameters;
    }
  }  // module ietf-netconf-with-defaults