[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Netconf operation definitions





Hector Trevino wrote:


Hi, following up on the previous discussions and the suggestion to identify areas where there may be discrepancies between the text and the XSD.



1) The current get-config definition for source says:

"source:

        Name of the configuration datastore being queried, such as
        <running/>.  If this element is unspecified, the <running/>
        configuration is used."

The definition for get-config the XSD includes element source which is of type rpcOperationSourceType. One of the choices is "config" which is config-inlineType

Forgot to include the url element here



    <xs:complexType name="rpcOperationSourceType">
      <xs:choice>
        <xs:element ref="config"/>
        <xs:element ref="config-name"/>
        <xs:element ref="url"/>
      </xs:choice>
    </xs:complexType>

My suggestion would be for the XSD definition to be modified to not allow this since a definition change can be made to enforce what the text says.


2) rpc element description. I think this was already brought up but just to make sure it's captured


"If additional attributes are present in an <rpc> element, a NETCONF
  peer must return them unmodified in the <rpc-reply> element."

The XSD does not include definitions for additional attributes


Slightly out of subject but related to XSDs

3) Naming conventions
There seems to be two different naming conventions followed in the XSD (for first word first letter is lower case then use upper case for first letter of sub-sequent words - rpcOperationSourceType) and also dash "-" separated words (config-inlineType and get-config)


For consistency purposes it may be good if one of the naming conventions was followed instead of inter-mixing. The former?



--
Hector Trevino
Network Management Technology Group (NMTG)
Cisco Systems Inc. Voice: 720-875-1369
Suite 400 9155 E. Nichols Ave Fax: 720-875-3014
Englewood, CO E-mail: htrevino@cisco.com
80112




--
to unsubscribe send a message to netconf-request@ops.ietf.org with
the word 'unsubscribe' in a single line as the message text body.
archive: <http://ops.ietf.org/lists/netconf/>