add docstrings, return osnodes for searchrole