The --convert-subtree-filter parameter specifies whether subtree filters will be converted to XPath filters for internal processing. If set to 'true' then subtree filters for retrieval operations might be converted to XPath expressions for processing.


The subtree filtering algorithm has a minor flaw which can cause subtree containment nodes to be printed in the output even though a nested selection filter does not match. A containment node should be completely pruned from the result no selection filters within it produce a match. This only affects data that needs to be retrieved by the server with a GET2 callback.


This issue has been fixed by converting a subtree filter to XPath and processing as if it were an XPath filter. If this parameter is set to 'true' then the conversion will be attempted. The conversion will be skipped if any of the following conditions are true:

  • output format is not XML

  • input format is not XML

  • subtree filter contains any attribute match expressions


This bug fix is not enabled by default because it might change filter output which was previously incorrect, but a client might be relying on the incorrect output anyway.



The --convert-subtree-filter parameter can be set via the command line when starting netconfd-pro:


user@system> netconfd-pro --convert-subtree-filter=true


or configured in the /etc/yumapro/netconfd-pro.conf file:


#### leaf convert-subtree-filter
# If set to 'true' then subtree filters for retrieval
# operations might be converted to XPath expressions
# for processing. See manual for more details.
#
convert-subtree-filter true