vnfs/TestVNF/netconftemplates/netconftemplates/ietf-system@2014-08-06.yin

   1 <rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="m-1">
   2   <data xmlns="urn:ietf:params:xml:ns:yang:ietf-netconf-monitoring">&lt;?xml version="1.0" encoding="UTF-8"?&gt;
   3 &lt;module name="ietf-system"
   4         xmlns="urn:ietf:params:xml:ns:yang:yin:1"
   5         xmlns:sys="urn:ietf:params:xml:ns:yang:ietf-system"
   6         xmlns:yang="urn:ietf:params:xml:ns:yang:ietf-yang-types"
   7         xmlns:inet="urn:ietf:params:xml:ns:yang:ietf-inet-types"
   8         xmlns:nacm="urn:ietf:params:xml:ns:yang:ietf-netconf-acm"
   9         xmlns:ianach="urn:ietf:params:xml:ns:yang:iana-crypt-hash"&gt;
  10   &lt;namespace uri="urn:ietf:params:xml:ns:yang:ietf-system"/&gt;
  11   &lt;prefix value="sys"/&gt;
  12   &lt;import module="ietf-yang-types"&gt;
  13     &lt;prefix value="yang"/&gt;
  14   &lt;/import&gt;
  15   &lt;import module="ietf-inet-types"&gt;
  16     &lt;prefix value="inet"/&gt;
  17   &lt;/import&gt;
  18   &lt;import module="ietf-netconf-acm"&gt;
  19     &lt;prefix value="nacm"/&gt;
  20   &lt;/import&gt;
  21   &lt;import module="iana-crypt-hash"&gt;
  22     &lt;prefix value="ianach"/&gt;
  23   &lt;/import&gt;
  24   &lt;organization&gt;
  25     &lt;text&gt;IETF NETMOD (NETCONF Data Modeling Language) Working Group&lt;/text&gt;
  26   &lt;/organization&gt;
  27   &lt;contact&gt;
  28     &lt;text&gt;WG Web:   &amp;lt;http://tools.ietf.org/wg/netmod/&amp;gt;
  29 WG List:  &amp;lt;mailto:netmod@ietf.org&amp;gt;
  30
  31 WG Chair: Thomas Nadeau
  32           &amp;lt;mailto:tnadeau@lucidvision.com&amp;gt;
  33
  34 WG Chair: Juergen Schoenwaelder
  35           &amp;lt;mailto:j.schoenwaelder@jacobs-university.de&amp;gt;
  36
  37 Editor:   Andy Bierman
  38           &amp;lt;mailto:andy@yumaworks.com&amp;gt;
  39
  40 Editor:   Martin Bjorklund
  41           &amp;lt;mailto:mbj@tail-f.com&amp;gt;&lt;/text&gt;
  42   &lt;/contact&gt;
  43   &lt;description&gt;
  44     &lt;text&gt;This module contains a collection of YANG definitions for the
  45 configuration and identification of some common system
  46 properties within a device containing a NETCONF server.  This
  47 includes data node definitions for system identification,
  48 time-of-day management, user management, DNS resolver
  49 configuration, and some protocol operations for system
  50 management.
  51
  52 Copyright (c) 2014 IETF Trust and the persons identified as
  53 authors of the code.  All rights reserved.
  54
  55 Redistribution and use in source and binary forms, with or
  56 without modification, is permitted pursuant to, and subject
  57 to the license terms contained in, the Simplified BSD License
  58 set forth in Section 4.c of the IETF Trust's Legal Provisions
  59 Relating to IETF Documents
  60 (http://trustee.ietf.org/license-info).
  61
  62 This version of this YANG module is part of RFC 7317; see
  63 the RFC itself for full legal notices.&lt;/text&gt;
  64   &lt;/description&gt;
  65   &lt;revision date="2014-08-06"&gt;
  66     &lt;description&gt;
  67       &lt;text&gt;Initial revision.&lt;/text&gt;
  68     &lt;/description&gt;
  69     &lt;reference&gt;
  70       &lt;text&gt;RFC 7317: A YANG Data Model for System Management&lt;/text&gt;
  71     &lt;/reference&gt;
  72   &lt;/revision&gt;
  73   &lt;feature name="radius"&gt;
  74     &lt;description&gt;
  75       &lt;text&gt;Indicates that the device can be configured as a RADIUS
  76 client.&lt;/text&gt;
  77     &lt;/description&gt;
  78     &lt;reference&gt;
  79       &lt;text&gt;RFC 2865: Remote Authentication Dial In User Service (RADIUS)&lt;/text&gt;
  80     &lt;/reference&gt;
  81   &lt;/feature&gt;
  82   &lt;feature name="authentication"&gt;
  83     &lt;description&gt;
  84       &lt;text&gt;Indicates that the device supports configuration of
  85 user authentication.&lt;/text&gt;
  86     &lt;/description&gt;
  87   &lt;/feature&gt;
  88   &lt;feature name="local-users"&gt;
  89     &lt;if-feature name="authentication"/&gt;
  90     &lt;description&gt;
  91       &lt;text&gt;Indicates that the device supports configuration of
  92 local user authentication.&lt;/text&gt;
  93     &lt;/description&gt;
  94   &lt;/feature&gt;
  95   &lt;feature name="radius-authentication"&gt;
  96     &lt;if-feature name="radius"/&gt;
  97     &lt;if-feature name="authentication"/&gt;
  98     &lt;description&gt;
  99       &lt;text&gt;Indicates that the device supports configuration of user
 100 authentication over RADIUS.&lt;/text&gt;
 101     &lt;/description&gt;
 102     &lt;reference&gt;
 103       &lt;text&gt;RFC 2865: Remote Authentication Dial In User Service (RADIUS)
 104 RFC 5607: Remote Authentication Dial-In User Service (RADIUS)
 105           Authorization for Network Access Server (NAS)
 106           Management&lt;/text&gt;
 107     &lt;/reference&gt;
 108   &lt;/feature&gt;
 109   &lt;feature name="ntp"&gt;
 110     &lt;description&gt;
 111       &lt;text&gt;Indicates that the device can be configured to use one or
 112 more NTP servers to set the system date and time.&lt;/text&gt;
 113     &lt;/description&gt;
 114   &lt;/feature&gt;
 115   &lt;feature name="ntp-udp-port"&gt;
 116     &lt;if-feature name="ntp"/&gt;
 117     &lt;description&gt;
 118       &lt;text&gt;Indicates that the device supports the configuration of
 119 the UDP port for NTP servers.
 120
 121 This is a 'feature', since many implementations do not support
 122 any port other than the default port.&lt;/text&gt;
 123     &lt;/description&gt;
 124   &lt;/feature&gt;
 125   &lt;feature name="timezone-name"&gt;
 126     &lt;description&gt;
 127       &lt;text&gt;Indicates that the local time zone on the device
 128 can be configured to use the TZ database
 129 to set the time zone and manage daylight saving time.&lt;/text&gt;
 130     &lt;/description&gt;
 131     &lt;reference&gt;
 132       &lt;text&gt;RFC 6557: Procedures for Maintaining the Time Zone Database&lt;/text&gt;
 133     &lt;/reference&gt;
 134   &lt;/feature&gt;
 135   &lt;feature name="dns-udp-tcp-port"&gt;
 136     &lt;description&gt;
 137       &lt;text&gt;Indicates that the device supports the configuration of
 138 the UDP and TCP port for DNS servers.
 139
 140 This is a 'feature', since many implementations do not support
 141 any port other than the default port.&lt;/text&gt;
 142     &lt;/description&gt;
 143   &lt;/feature&gt;
 144   &lt;identity name="authentication-method"&gt;
 145     &lt;description&gt;
 146       &lt;text&gt;Base identity for user authentication methods.&lt;/text&gt;
 147     &lt;/description&gt;
 148   &lt;/identity&gt;
 149   &lt;identity name="radius"&gt;
 150     &lt;base name="authentication-method"/&gt;
 151     &lt;description&gt;
 152       &lt;text&gt;Indicates user authentication using RADIUS.&lt;/text&gt;
 153     &lt;/description&gt;
 154     &lt;reference&gt;
 155       &lt;text&gt;RFC 2865: Remote Authentication Dial In User Service (RADIUS)
 156 RFC 5607: Remote Authentication Dial-In User Service (RADIUS)
 157           Authorization for Network Access Server (NAS)
 158           Management&lt;/text&gt;
 159     &lt;/reference&gt;
 160   &lt;/identity&gt;
 161   &lt;identity name="local-users"&gt;
 162     &lt;base name="authentication-method"/&gt;
 163     &lt;description&gt;
 164       &lt;text&gt;Indicates password-based authentication of locally
 165 configured users.&lt;/text&gt;
 166     &lt;/description&gt;
 167   &lt;/identity&gt;
 168   &lt;identity name="radius-authentication-type"&gt;
 169     &lt;description&gt;
 170       &lt;text&gt;Base identity for RADIUS authentication types.&lt;/text&gt;
 171     &lt;/description&gt;
 172   &lt;/identity&gt;
 173   &lt;identity name="radius-pap"&gt;
 174     &lt;base name="radius-authentication-type"/&gt;
 175     &lt;description&gt;
 176       &lt;text&gt;The device requests Password Authentication Protocol (PAP)
 177 authentication from the RADIUS server.&lt;/text&gt;
 178     &lt;/description&gt;
 179     &lt;reference&gt;
 180       &lt;text&gt;RFC 2865: Remote Authentication Dial In User Service (RADIUS)&lt;/text&gt;
 181     &lt;/reference&gt;
 182   &lt;/identity&gt;
 183   &lt;identity name="radius-chap"&gt;
 184     &lt;base name="radius-authentication-type"/&gt;
 185     &lt;description&gt;
 186       &lt;text&gt;The device requests Challenge Handshake Authentication
 187 Protocol (CHAP) authentication from the RADIUS server.&lt;/text&gt;
 188     &lt;/description&gt;
 189     &lt;reference&gt;
 190       &lt;text&gt;RFC 2865: Remote Authentication Dial In User Service (RADIUS)&lt;/text&gt;
 191     &lt;/reference&gt;
 192   &lt;/identity&gt;
 193   &lt;typedef name="timezone-name"&gt;
 194     &lt;type name="string"/&gt;
 195     &lt;description&gt;
 196       &lt;text&gt;A time zone name as used by the Time Zone Database,
 197 sometimes referred to as the 'Olson Database'.
 198
 199 The exact set of valid values is an implementation-specific
 200 matter.  Client discovery of the exact set of time zone names
 201 for a particular server is out of scope.&lt;/text&gt;
 202     &lt;/description&gt;
 203     &lt;reference&gt;
 204       &lt;text&gt;RFC 6557: Procedures for Maintaining the Time Zone Database&lt;/text&gt;
 205     &lt;/reference&gt;
 206   &lt;/typedef&gt;
 207   &lt;container name="system"&gt;
 208     &lt;description&gt;
 209       &lt;text&gt;System group configuration.&lt;/text&gt;
 210     &lt;/description&gt;
 211     &lt;leaf name="contact"&gt;
 212       &lt;type name="string"/&gt;
 213       &lt;description&gt;
 214         &lt;text&gt;The administrator contact information for the system.
 215
 216 A server implementation MAY map this leaf to the sysContact
 217 MIB object.  Such an implementation needs to use some
 218 mechanism to handle the differences in size and characters
 219 allowed between this leaf and sysContact.  The definition of
 220 such a mechanism is outside the scope of this document.&lt;/text&gt;
 221       &lt;/description&gt;
 222       &lt;reference&gt;
 223         &lt;text&gt;RFC 3418: Management Information Base (MIB) for the
 224           Simple Network Management Protocol (SNMP)
 225           SNMPv2-MIB.sysContact&lt;/text&gt;
 226       &lt;/reference&gt;
 227     &lt;/leaf&gt;
 228     &lt;leaf name="hostname"&gt;
 229       &lt;type name="inet:domain-name"/&gt;
 230       &lt;description&gt;
 231         &lt;text&gt;The name of the host.  This name can be a single domain
 232 label or the fully qualified domain name of the host.&lt;/text&gt;
 233       &lt;/description&gt;
 234     &lt;/leaf&gt;
 235     &lt;leaf name="location"&gt;
 236       &lt;type name="string"/&gt;
 237       &lt;description&gt;
 238         &lt;text&gt;The system location.
 239
 240 A server implementation MAY map this leaf to the sysLocation
 241 MIB object.  Such an implementation needs to use some
 242 mechanism to handle the differences in size and characters
 243 allowed between this leaf and sysLocation.  The definition
 244 of such a mechanism is outside the scope of this document.&lt;/text&gt;
 245       &lt;/description&gt;
 246       &lt;reference&gt;
 247         &lt;text&gt;RFC 3418: Management Information Base (MIB) for the
 248           Simple Network Management Protocol (SNMP)
 249           SNMPv2-MIB.sysLocation&lt;/text&gt;
 250       &lt;/reference&gt;
 251     &lt;/leaf&gt;
 252     &lt;container name="clock"&gt;
 253       &lt;description&gt;
 254         &lt;text&gt;Configuration of the system date and time properties.&lt;/text&gt;
 255       &lt;/description&gt;
 256       &lt;choice name="timezone"&gt;
 257         &lt;description&gt;
 258           &lt;text&gt;The system time zone information.&lt;/text&gt;
 259         &lt;/description&gt;
 260         &lt;case name="timezone-name"&gt;
 261           &lt;if-feature name="timezone-name"/&gt;
 262           &lt;leaf name="timezone-name"&gt;
 263             &lt;type name="timezone-name"/&gt;
 264             &lt;description&gt;
 265               &lt;text&gt;The TZ database name to use for the system, such
 266 as 'Europe/Stockholm'.&lt;/text&gt;
 267             &lt;/description&gt;
 268           &lt;/leaf&gt;
 269         &lt;/case&gt;
 270         &lt;case name="timezone-utc-offset"&gt;
 271           &lt;leaf name="timezone-utc-offset"&gt;
 272             &lt;type name="int16"&gt;
 273               &lt;range value="-1500 .. 1500"/&gt;
 274             &lt;/type&gt;
 275             &lt;units name="minutes"/&gt;
 276             &lt;description&gt;
 277               &lt;text&gt;The number of minutes to add to UTC time to
 278 identify the time zone for this system.  For example,
 279 'UTC - 8:00 hours' would be represented as '-480'.
 280 Note that automatic daylight saving time adjustment
 281 is not provided if this object is used.&lt;/text&gt;
 282             &lt;/description&gt;
 283           &lt;/leaf&gt;
 284         &lt;/case&gt;
 285       &lt;/choice&gt;
 286     &lt;/container&gt;
 287     &lt;container name="ntp"&gt;
 288       &lt;if-feature name="ntp"/&gt;
 289       &lt;presence value="Enables the NTP client unless the 'enabled' leaf
 290 (which defaults to 'true') is set to 'false'"/&gt;
 291       &lt;description&gt;
 292         &lt;text&gt;Configuration of the NTP client.&lt;/text&gt;
 293       &lt;/description&gt;
 294       &lt;leaf name="enabled"&gt;
 295         &lt;type name="boolean"/&gt;
 296         &lt;default value="true"/&gt;
 297         &lt;description&gt;
 298           &lt;text&gt;Indicates that the system should attempt to
 299 synchronize the system clock with an NTP server
 300 from the 'ntp/server' list.&lt;/text&gt;
 301         &lt;/description&gt;
 302       &lt;/leaf&gt;
 303       &lt;list name="server"&gt;
 304         &lt;key value="name"/&gt;
 305         &lt;description&gt;
 306           &lt;text&gt;List of NTP servers to use for system clock
 307 synchronization.  If '/system/ntp/enabled'
 308 is 'true', then the system will attempt to
 309 contact and utilize the specified NTP servers.&lt;/text&gt;
 310         &lt;/description&gt;
 311         &lt;leaf name="name"&gt;
 312           &lt;type name="string"/&gt;
 313           &lt;description&gt;
 314             &lt;text&gt;An arbitrary name for the NTP server.&lt;/text&gt;
 315           &lt;/description&gt;
 316         &lt;/leaf&gt;
 317         &lt;choice name="transport"&gt;
 318           &lt;mandatory value="true"/&gt;
 319           &lt;description&gt;
 320             &lt;text&gt;The transport-protocol-specific parameters for this
 321 server.&lt;/text&gt;
 322           &lt;/description&gt;
 323           &lt;case name="udp"&gt;
 324             &lt;container name="udp"&gt;
 325               &lt;description&gt;
 326                 &lt;text&gt;Contains UDP-specific configuration parameters
 327 for NTP.&lt;/text&gt;
 328               &lt;/description&gt;
 329               &lt;leaf name="address"&gt;
 330                 &lt;type name="inet:host"/&gt;
 331                 &lt;mandatory value="true"/&gt;
 332                 &lt;description&gt;
 333                   &lt;text&gt;The address of the NTP server.&lt;/text&gt;
 334                 &lt;/description&gt;
 335               &lt;/leaf&gt;
 336               &lt;leaf name="port"&gt;
 337                 &lt;if-feature name="ntp-udp-port"/&gt;
 338                 &lt;type name="inet:port-number"/&gt;
 339                 &lt;default value="123"/&gt;
 340                 &lt;description&gt;
 341                   &lt;text&gt;The port number of the NTP server.&lt;/text&gt;
 342                 &lt;/description&gt;
 343               &lt;/leaf&gt;
 344             &lt;/container&gt;
 345           &lt;/case&gt;
 346         &lt;/choice&gt;
 347         &lt;leaf name="association-type"&gt;
 348           &lt;type name="enumeration"&gt;
 349             &lt;enum name="server"&gt;
 350               &lt;description&gt;
 351                 &lt;text&gt;Use client association mode.  This device
 352 will not provide synchronization to the
 353 configured NTP server.&lt;/text&gt;
 354               &lt;/description&gt;
 355             &lt;/enum&gt;
 356             &lt;enum name="peer"&gt;
 357               &lt;description&gt;
 358                 &lt;text&gt;Use symmetric active association mode.
 359 This device may provide synchronization
 360 to the configured NTP server.&lt;/text&gt;
 361               &lt;/description&gt;
 362             &lt;/enum&gt;
 363             &lt;enum name="pool"&gt;
 364               &lt;description&gt;
 365                 &lt;text&gt;Use client association mode with one or
 366 more of the NTP servers found by DNS
 367 resolution of the domain name given by
 368 the 'address' leaf.  This device will not
 369 provide synchronization to the servers.&lt;/text&gt;
 370               &lt;/description&gt;
 371             &lt;/enum&gt;
 372           &lt;/type&gt;
 373           &lt;default value="server"/&gt;
 374           &lt;description&gt;
 375             &lt;text&gt;The desired association type for this NTP server.&lt;/text&gt;
 376           &lt;/description&gt;
 377         &lt;/leaf&gt;
 378         &lt;leaf name="iburst"&gt;
 379           &lt;type name="boolean"/&gt;
 380           &lt;default value="false"/&gt;
 381           &lt;description&gt;
 382             &lt;text&gt;Indicates whether this server should enable burst
 383 synchronization or not.&lt;/text&gt;
 384           &lt;/description&gt;
 385         &lt;/leaf&gt;
 386         &lt;leaf name="prefer"&gt;
 387           &lt;type name="boolean"/&gt;
 388           &lt;default value="false"/&gt;
 389           &lt;description&gt;
 390             &lt;text&gt;Indicates whether this server should be preferred
 391 or not.&lt;/text&gt;
 392           &lt;/description&gt;
 393         &lt;/leaf&gt;
 394       &lt;/list&gt;
 395     &lt;/container&gt;
 396     &lt;container name="dns-resolver"&gt;
 397       &lt;description&gt;
 398         &lt;text&gt;Configuration of the DNS resolver.&lt;/text&gt;
 399       &lt;/description&gt;
 400       &lt;leaf-list name="search"&gt;
 401         &lt;type name="inet:domain-name"/&gt;
 402         &lt;ordered-by value="user"/&gt;
 403         &lt;description&gt;
 404           &lt;text&gt;An ordered list of domains to search when resolving
 405 a host name.&lt;/text&gt;
 406         &lt;/description&gt;
 407       &lt;/leaf-list&gt;
 408       &lt;list name="server"&gt;
 409         &lt;key value="name"/&gt;
 410         &lt;ordered-by value="user"/&gt;
 411         &lt;description&gt;
 412           &lt;text&gt;List of the DNS servers that the resolver should query.
 413
 414 When the resolver is invoked by a calling application, it
 415 sends the query to the first name server in this list.  If
 416 no response has been received within 'timeout' seconds,
 417 the resolver continues with the next server in the list.
 418 If no response is received from any server, the resolver
 419 continues with the first server again.  When the resolver
 420 has traversed the list 'attempts' times without receiving
 421 any response, it gives up and returns an error to the
 422 calling application.
 423
 424 Implementations MAY limit the number of entries in this
 425 list.&lt;/text&gt;
 426         &lt;/description&gt;
 427         &lt;leaf name="name"&gt;
 428           &lt;type name="string"/&gt;
 429           &lt;description&gt;
 430             &lt;text&gt;An arbitrary name for the DNS server.&lt;/text&gt;
 431           &lt;/description&gt;
 432         &lt;/leaf&gt;
 433         &lt;choice name="transport"&gt;
 434           &lt;mandatory value="true"/&gt;
 435           &lt;description&gt;
 436             &lt;text&gt;The transport-protocol-specific parameters for this
 437 server.&lt;/text&gt;
 438           &lt;/description&gt;
 439           &lt;case name="udp-and-tcp"&gt;
 440             &lt;container name="udp-and-tcp"&gt;
 441               &lt;description&gt;
 442                 &lt;text&gt;Contains UDP- and TCP-specific configuration
 443 parameters for DNS.&lt;/text&gt;
 444               &lt;/description&gt;
 445               &lt;reference&gt;
 446                 &lt;text&gt;RFC 1035: Domain Names - Implementation and
 447           Specification
 448 RFC 5966: DNS Transport over TCP - Implementation
 449           Requirements&lt;/text&gt;
 450               &lt;/reference&gt;
 451               &lt;leaf name="address"&gt;
 452                 &lt;type name="inet:ip-address"/&gt;
 453                 &lt;mandatory value="true"/&gt;
 454                 &lt;description&gt;
 455                   &lt;text&gt;The address of the DNS server.&lt;/text&gt;
 456                 &lt;/description&gt;
 457               &lt;/leaf&gt;
 458               &lt;leaf name="port"&gt;
 459                 &lt;if-feature name="dns-udp-tcp-port"/&gt;
 460                 &lt;type name="inet:port-number"/&gt;
 461                 &lt;default value="53"/&gt;
 462                 &lt;description&gt;
 463                   &lt;text&gt;The UDP and TCP port number of the DNS server.&lt;/text&gt;
 464                 &lt;/description&gt;
 465               &lt;/leaf&gt;
 466             &lt;/container&gt;
 467           &lt;/case&gt;
 468         &lt;/choice&gt;
 469       &lt;/list&gt;
 470       &lt;container name="options"&gt;
 471         &lt;description&gt;
 472           &lt;text&gt;Resolver options.  The set of available options has been
 473 limited to those that are generally available across
 474 different resolver implementations and generally useful.&lt;/text&gt;
 475         &lt;/description&gt;
 476         &lt;leaf name="timeout"&gt;
 477           &lt;type name="uint8"&gt;
 478             &lt;range value="1..max"/&gt;
 479           &lt;/type&gt;
 480           &lt;units name="seconds"/&gt;
 481           &lt;default value="5"/&gt;
 482           &lt;description&gt;
 483             &lt;text&gt;The amount of time the resolver will wait for a
 484 response from each remote name server before
 485 retrying the query via a different name server.&lt;/text&gt;
 486           &lt;/description&gt;
 487         &lt;/leaf&gt;
 488         &lt;leaf name="attempts"&gt;
 489           &lt;type name="uint8"&gt;
 490             &lt;range value="1..max"/&gt;
 491           &lt;/type&gt;
 492           &lt;default value="2"/&gt;
 493           &lt;description&gt;
 494             &lt;text&gt;The number of times the resolver will send a query to
 495 all of its name servers before giving up and returning
 496 an error to the calling application.&lt;/text&gt;
 497           &lt;/description&gt;
 498         &lt;/leaf&gt;
 499       &lt;/container&gt;
 500     &lt;/container&gt;
 501     &lt;container name="radius"&gt;
 502       &lt;if-feature name="radius"/&gt;
 503       &lt;description&gt;
 504         &lt;text&gt;Configuration of the RADIUS client.&lt;/text&gt;
 505       &lt;/description&gt;
 506       &lt;list name="server"&gt;
 507         &lt;key value="name"/&gt;
 508         &lt;ordered-by value="user"/&gt;
 509         &lt;description&gt;
 510           &lt;text&gt;List of RADIUS servers used by the device.
 511
 512 When the RADIUS client is invoked by a calling
 513 application, it sends the query to the first server in
 514 this list.  If no response has been received within
 515 'timeout' seconds, the client continues with the next
 516 server in the list.  If no response is received from any
 517 server, the client continues with the first server again.
 518 When the client has traversed the list 'attempts' times
 519 without receiving any response, it gives up and returns an
 520 error to the calling application.&lt;/text&gt;
 521         &lt;/description&gt;
 522         &lt;leaf name="name"&gt;
 523           &lt;type name="string"/&gt;
 524           &lt;description&gt;
 525             &lt;text&gt;An arbitrary name for the RADIUS server.&lt;/text&gt;
 526           &lt;/description&gt;
 527         &lt;/leaf&gt;
 528         &lt;choice name="transport"&gt;
 529           &lt;mandatory value="true"/&gt;
 530           &lt;description&gt;
 531             &lt;text&gt;The transport-protocol-specific parameters for this
 532 server.&lt;/text&gt;
 533           &lt;/description&gt;
 534           &lt;case name="udp"&gt;
 535             &lt;container name="udp"&gt;
 536               &lt;description&gt;
 537                 &lt;text&gt;Contains UDP-specific configuration parameters
 538 for RADIUS.&lt;/text&gt;
 539               &lt;/description&gt;
 540               &lt;leaf name="address"&gt;
 541                 &lt;type name="inet:host"/&gt;
 542                 &lt;mandatory value="true"/&gt;
 543                 &lt;description&gt;
 544                   &lt;text&gt;The address of the RADIUS server.&lt;/text&gt;
 545                 &lt;/description&gt;
 546               &lt;/leaf&gt;
 547               &lt;leaf name="authentication-port"&gt;
 548                 &lt;type name="inet:port-number"/&gt;
 549                 &lt;default value="1812"/&gt;
 550                 &lt;description&gt;
 551                   &lt;text&gt;The port number of the RADIUS server.&lt;/text&gt;
 552                 &lt;/description&gt;
 553               &lt;/leaf&gt;
 554               &lt;leaf name="shared-secret"&gt;
 555                 &lt;nacm:default-deny-all/&gt;
 556                 &lt;type name="string"/&gt;
 557                 &lt;mandatory value="true"/&gt;
 558                 &lt;description&gt;
 559                   &lt;text&gt;The shared secret, which is known to both the
 560 RADIUS client and server.&lt;/text&gt;
 561                 &lt;/description&gt;
 562                 &lt;reference&gt;
 563                   &lt;text&gt;RFC 2865: Remote Authentication Dial In User
 564           Service (RADIUS)&lt;/text&gt;
 565                 &lt;/reference&gt;
 566               &lt;/leaf&gt;
 567             &lt;/container&gt;
 568           &lt;/case&gt;
 569         &lt;/choice&gt;
 570         &lt;leaf name="authentication-type"&gt;
 571           &lt;type name="identityref"&gt;
 572             &lt;base name="radius-authentication-type"/&gt;
 573           &lt;/type&gt;
 574           &lt;default value="radius-pap"/&gt;
 575           &lt;description&gt;
 576             &lt;text&gt;The authentication type requested from the RADIUS
 577 server.&lt;/text&gt;
 578           &lt;/description&gt;
 579         &lt;/leaf&gt;
 580       &lt;/list&gt;
 581       &lt;container name="options"&gt;
 582         &lt;description&gt;
 583           &lt;text&gt;RADIUS client options.&lt;/text&gt;
 584         &lt;/description&gt;
 585         &lt;leaf name="timeout"&gt;
 586           &lt;type name="uint8"&gt;
 587             &lt;range value="1..max"/&gt;
 588           &lt;/type&gt;
 589           &lt;units name="seconds"/&gt;
 590           &lt;default value="5"/&gt;
 591           &lt;description&gt;
 592             &lt;text&gt;The number of seconds the device will wait for a
 593 response from each RADIUS server before trying with a
 594 different server.&lt;/text&gt;
 595           &lt;/description&gt;
 596         &lt;/leaf&gt;
 597         &lt;leaf name="attempts"&gt;
 598           &lt;type name="uint8"&gt;
 599             &lt;range value="1..max"/&gt;
 600           &lt;/type&gt;
 601           &lt;default value="2"/&gt;
 602           &lt;description&gt;
 603             &lt;text&gt;The number of times the device will send a query to
 604 all of its RADIUS servers before giving up.&lt;/text&gt;
 605           &lt;/description&gt;
 606         &lt;/leaf&gt;
 607       &lt;/container&gt;
 608     &lt;/container&gt;
 609     &lt;container name="authentication"&gt;
 610       &lt;nacm:default-deny-write/&gt;
 611       &lt;if-feature name="authentication"/&gt;
 612       &lt;description&gt;
 613         &lt;text&gt;The authentication configuration subtree.&lt;/text&gt;
 614       &lt;/description&gt;
 615       &lt;leaf-list name="user-authentication-order"&gt;
 616         &lt;type name="identityref"&gt;
 617           &lt;base name="authentication-method"/&gt;
 618         &lt;/type&gt;
 619         &lt;must condition="(. != &amp;quot;sys:radius&amp;quot; or ../../radius/server)"&gt;
 620           &lt;error-message&gt;
 621             &lt;value&gt;When 'radius' is used, a RADIUS server must be configured.&lt;/value&gt;
 622           &lt;/error-message&gt;
 623           &lt;description&gt;
 624             &lt;text&gt;When 'radius' is used as an authentication method,
 625 a RADIUS server must be configured.&lt;/text&gt;
 626           &lt;/description&gt;
 627         &lt;/must&gt;
 628         &lt;ordered-by value="user"/&gt;
 629         &lt;description&gt;
 630           &lt;text&gt;When the device authenticates a user with a password,
 631 it tries the authentication methods in this leaf-list in
 632 order.  If authentication with one method fails, the next
 633 method is used.  If no method succeeds, the user is
 634 denied access.
 635
 636 An empty user-authentication-order leaf-list still allows
 637 authentication of users using mechanisms that do not
 638 involve a password.
 639
 640 If the 'radius-authentication' feature is advertised by
 641 the NETCONF server, the 'radius' identity can be added to
 642 this list.
 643
 644 If the 'local-users' feature is advertised by the
 645 NETCONF server, the 'local-users' identity can be
 646 added to this list.&lt;/text&gt;
 647         &lt;/description&gt;
 648       &lt;/leaf-list&gt;
 649       &lt;list name="user"&gt;
 650         &lt;if-feature name="local-users"/&gt;
 651         &lt;key value="name"/&gt;
 652         &lt;description&gt;
 653           &lt;text&gt;The list of local users configured on this device.&lt;/text&gt;
 654         &lt;/description&gt;
 655         &lt;leaf name="name"&gt;
 656           &lt;type name="string"/&gt;
 657           &lt;description&gt;
 658             &lt;text&gt;The user name string identifying this entry.&lt;/text&gt;
 659           &lt;/description&gt;
 660         &lt;/leaf&gt;
 661         &lt;leaf name="password"&gt;
 662           &lt;type name="ianach:crypt-hash"/&gt;
 663           &lt;description&gt;
 664             &lt;text&gt;The password for this entry.&lt;/text&gt;
 665           &lt;/description&gt;
 666         &lt;/leaf&gt;
 667         &lt;list name="authorized-key"&gt;
 668           &lt;key value="name"/&gt;
 669           &lt;description&gt;
 670             &lt;text&gt;A list of public SSH keys for this user.  These keys
 671 are allowed for SSH authentication, as described in
 672 RFC 4253.&lt;/text&gt;
 673           &lt;/description&gt;
 674           &lt;reference&gt;
 675             &lt;text&gt;RFC 4253: The Secure Shell (SSH) Transport Layer
 676           Protocol&lt;/text&gt;
 677           &lt;/reference&gt;
 678           &lt;leaf name="name"&gt;
 679             &lt;type name="string"/&gt;
 680             &lt;description&gt;
 681               &lt;text&gt;An arbitrary name for the SSH key.&lt;/text&gt;
 682             &lt;/description&gt;
 683           &lt;/leaf&gt;
 684           &lt;leaf name="algorithm"&gt;
 685             &lt;type name="string"/&gt;
 686             &lt;mandatory value="true"/&gt;
 687             &lt;description&gt;
 688               &lt;text&gt;The public key algorithm name for this SSH key.
 689
 690 Valid values are the values in the IANA 'Secure Shell
 691 (SSH) Protocol Parameters' registry, Public Key
 692 Algorithm Names.&lt;/text&gt;
 693             &lt;/description&gt;
 694             &lt;reference&gt;
 695               &lt;text&gt;IANA 'Secure Shell (SSH) Protocol Parameters'
 696 registry, Public Key Algorithm Names&lt;/text&gt;
 697             &lt;/reference&gt;
 698           &lt;/leaf&gt;
 699           &lt;leaf name="key-data"&gt;
 700             &lt;type name="binary"/&gt;
 701             &lt;mandatory value="true"/&gt;
 702             &lt;description&gt;
 703               &lt;text&gt;The binary public key data for this SSH key, as
 704 specified by RFC 4253, Section 6.6, i.e.:
 705
 706   string    certificate or public key format
 707             identifier
 708   byte[n]   key/certificate data.&lt;/text&gt;
 709             &lt;/description&gt;
 710             &lt;reference&gt;
 711               &lt;text&gt;RFC 4253: The Secure Shell (SSH) Transport Layer
 712           Protocol&lt;/text&gt;
 713             &lt;/reference&gt;
 714           &lt;/leaf&gt;
 715         &lt;/list&gt;
 716       &lt;/list&gt;
 717     &lt;/container&gt;
 718   &lt;/container&gt;
 719   &lt;container name="system-state"&gt;
 720     &lt;config value="false"/&gt;
 721     &lt;description&gt;
 722       &lt;text&gt;System group operational state.&lt;/text&gt;
 723     &lt;/description&gt;
 724     &lt;container name="platform"&gt;
 725       &lt;description&gt;
 726         &lt;text&gt;Contains vendor-specific information for
 727 identifying the system platform and operating system.&lt;/text&gt;
 728       &lt;/description&gt;
 729       &lt;reference&gt;
 730         &lt;text&gt;IEEE Std 1003.1-2008 - sys/utsname.h&lt;/text&gt;
 731       &lt;/reference&gt;
 732       &lt;leaf name="os-name"&gt;
 733         &lt;type name="string"/&gt;
 734         &lt;description&gt;
 735           &lt;text&gt;The name of the operating system in use -
 736 for example, 'Linux'.&lt;/text&gt;
 737         &lt;/description&gt;
 738         &lt;reference&gt;
 739           &lt;text&gt;IEEE Std 1003.1-2008 - utsname.sysname&lt;/text&gt;
 740         &lt;/reference&gt;
 741       &lt;/leaf&gt;
 742       &lt;leaf name="os-release"&gt;
 743         &lt;type name="string"/&gt;
 744         &lt;description&gt;
 745           &lt;text&gt;The current release level of the operating
 746 system in use.  This string MAY indicate
 747 the OS source code revision.&lt;/text&gt;
 748         &lt;/description&gt;
 749         &lt;reference&gt;
 750           &lt;text&gt;IEEE Std 1003.1-2008 - utsname.release&lt;/text&gt;
 751         &lt;/reference&gt;
 752       &lt;/leaf&gt;
 753       &lt;leaf name="os-version"&gt;
 754         &lt;type name="string"/&gt;
 755         &lt;description&gt;
 756           &lt;text&gt;The current version level of the operating
 757 system in use.  This string MAY indicate
 758 the specific OS build date and target variant
 759 information.&lt;/text&gt;
 760         &lt;/description&gt;
 761         &lt;reference&gt;
 762           &lt;text&gt;IEEE Std 1003.1-2008 - utsname.version&lt;/text&gt;
 763         &lt;/reference&gt;
 764       &lt;/leaf&gt;
 765       &lt;leaf name="machine"&gt;
 766         &lt;type name="string"/&gt;
 767         &lt;description&gt;
 768           &lt;text&gt;A vendor-specific identifier string representing
 769 the hardware in use.&lt;/text&gt;
 770         &lt;/description&gt;
 771         &lt;reference&gt;
 772           &lt;text&gt;IEEE Std 1003.1-2008 - utsname.machine&lt;/text&gt;
 773         &lt;/reference&gt;
 774       &lt;/leaf&gt;
 775     &lt;/container&gt;
 776     &lt;container name="clock"&gt;
 777       &lt;description&gt;
 778         &lt;text&gt;Monitoring of the system date and time properties.&lt;/text&gt;
 779       &lt;/description&gt;
 780       &lt;leaf name="current-datetime"&gt;
 781         &lt;type name="yang:date-and-time"/&gt;
 782         &lt;description&gt;
 783           &lt;text&gt;The current system date and time.&lt;/text&gt;
 784         &lt;/description&gt;
 785       &lt;/leaf&gt;
 786       &lt;leaf name="boot-datetime"&gt;
 787         &lt;type name="yang:date-and-time"/&gt;
 788         &lt;description&gt;
 789           &lt;text&gt;The system date and time when the system last restarted.&lt;/text&gt;
 790         &lt;/description&gt;
 791       &lt;/leaf&gt;
 792     &lt;/container&gt;
 793   &lt;/container&gt;
 794   &lt;rpc name="set-current-datetime"&gt;
 795     &lt;nacm:default-deny-all/&gt;
 796     &lt;description&gt;
 797       &lt;text&gt;Set the /system-state/clock/current-datetime leaf
 798 to the specified value.
 799
 800 If the system is using NTP (i.e., /system/ntp/enabled
 801 is set to 'true'), then this operation will fail with
 802 error-tag 'operation-failed' and error-app-tag value of
 803 'ntp-active'.&lt;/text&gt;
 804     &lt;/description&gt;
 805     &lt;input&gt;
 806       &lt;leaf name="current-datetime"&gt;
 807         &lt;type name="yang:date-and-time"/&gt;
 808         &lt;mandatory value="true"/&gt;
 809         &lt;description&gt;
 810           &lt;text&gt;The current system date and time.&lt;/text&gt;
 811         &lt;/description&gt;
 812       &lt;/leaf&gt;
 813     &lt;/input&gt;
 814   &lt;/rpc&gt;
 815   &lt;rpc name="system-restart"&gt;
 816     &lt;nacm:default-deny-all/&gt;
 817     &lt;description&gt;
 818       &lt;text&gt;Request that the entire system be restarted immediately.
 819 A server SHOULD send an rpc reply to the client before
 820 restarting the system.&lt;/text&gt;
 821     &lt;/description&gt;
 822   &lt;/rpc&gt;
 823   &lt;rpc name="system-shutdown"&gt;
 824     &lt;nacm:default-deny-all/&gt;
 825     &lt;description&gt;
 826       &lt;text&gt;Request that the entire system be shut down immediately.
 827 A server SHOULD send an rpc reply to the client before
 828 shutting down the system.&lt;/text&gt;
 829     &lt;/description&gt;
 830   &lt;/rpc&gt;
 831 &lt;/module&gt;
 832 </data>
 833 </rpc-reply>