Martin,

Thanks for this feedback.  A run-time crash of the NETCONF server is a bad
"outcome" of a typo like this...
I checked the W3C pages and there is grammar defined for an XPATH expression
so ultimately the string could be parsed as an XPATH (I guess it is
currently not done).

Any other programming language ensures to eliminate typing errors during the
compilation phase allowing early detection of issues like this.  It is
becoming a problem when the NETCONF server internally stores values (e.g.
identityref) in a format different from what is specified in the string of
the when statement resulting in unexpected options when trying to use the
CLI generated from the model.  In this specific case we were advised to
prefix the leaf (as the leaf was stored in this way...) even though the leaf
was in the local module itself.  This makes development even less
transparent...  When we flagged this we received the following feedback:

Quote:
For YANG 1.1 that is underway it will be defined in the following way:
" The string value of a node of type identityref in a "must" or "when" XPath

expression is the referred identity's qualified name with the prefix
present.  
If the referred identity is defined in an imported module, the prefix in the

string value is the prefix defined in the corresponding "import" statement.

Otherwise, the prefix in the string value is the prefix for the current 
module.""

But as this is within a string that is not parsed (depending on the
compiler) this is something that people need to do and if not done will
still result in run-time problems.

Best regards - Vriendelijke groeten,
Bart Bogaert
System Architect Data-Centric SW Architectures 
Fixed Networks - Broadband Access BU,  Nokia
Contact number +32 3 2408310 (+32 477 673952)

-----Original Message-----
From: EXT Martin Bjorklund [mailto:[email protected]] 
Sent: 29 March 2016 09:23
To: Bogaert, Bart (Nokia - BE)
Cc: [email protected]
Subject: Re: [netmod] string in when and must statement in YANG ABNF Grammar

"Bogaert, Bart (Nokia - BE)" <[email protected]> wrote:
> Is there a reason why the ABNF for example the when and must statement 
> has been "restricted" to when-keyword sep string optsep
> 
> As "string"  can't be tokenized no errors are generated by YANG 
> compilers if this string contains an error, e.g. referred leaf does 
> not exit due to a typo.  This problem only exposes itself at run-time.  
> I was wondering why this string was not broken down into a number of 
> specific parts that define the when statement so that these kind of errors
can be trapped early in the
> development process?   I am rather new in this so I did not follow all
> discussions that led to the definition of YANG and hence have no idea 
> whether this was discussed and what were the reasons not to do it this
way.

The arguments to the "when" and "must" statements are XPath 1.0 expressions.
The syntax of XPath 1.0 is not defined by YANG, but by the XPath 1.0 spec.
This is the reason that the YANG grammar isn't more specific.

YANG compilers differ in their ability to detect errors in these XPath
expressions.  Some perform more checks than others (unfortunately, pyang is
pretty bad in this regard... (patches are always welcome:)).

[For your particular example, referencing a leaf that doesn't exist is not
an error per se; it is perfectly valid XPath.  But it probably warrants a
warning by the compiler.]


/martin

Attachment: smime.p7s
Description: S/MIME cryptographic signature

_______________________________________________
netmod mailing list
[email protected]
https://www.ietf.org/mailman/listinfo/netmod

Reply via email to