identify_tree


Description:

[ Version ( since = "1.6.0" ) ]
public bool identify_tree (Tree tree)

Try to match a newly created tree with a tree description from this.

If found, tree will be filled with the corresponding information stored in this. In particular, after a call to identify_tree, if the tree could be identified, its OsinfoEntify:OsinfoDb:id and OsinfoMedia:OsinfoDb:oss properties will be set.

The match for tree in this is not guaranteed to be unique and this method will only return the first match found. The order in which matches are identified is not guaranteed, so when there are multiple matches, the returned match may vary over time. Applications are recommended to use the osinfo_db_identify_all_tree method instead to receive all matched tree.

Parameters:

this

an Db database

tree

the installation tree data

Returns:

TRUE if tree was found in this, FALSE otherwise