123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142 |
- /* This file is part of the program psim.
- Copyright (C) 1994-1996, Andrew Cagney <cagney@highland.com.au>
- This program is free software; you can redistribute it and/or modify
- it under the terms of the GNU General Public License as published by
- the Free Software Foundation; either version 3 of the License, or
- (at your option) any later version.
- This program is distributed in the hope that it will be useful,
- but WITHOUT ANY WARRANTY; without even the implied warranty of
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- GNU General Public License for more details.
-
- You should have received a copy of the GNU General Public License
- along with this program; if not, see <http://www.gnu.org/licenses/>.
-
- */
- #ifndef _TREE_H_
- #define _TREE_H_
- #ifndef INLINE_TREE
- #define INLINE_TREE
- #endif
- /* Constructing the device tree:
- The initial device tree populated with devices and basic properties
- is created using the function <<device_tree_add_parsed()>>. This
- function parses a PSIM device specification and uses it to populate
- the tree accordingly.
- This function accepts a printf style formatted string as the
- argument that describes the entry. Any properties or interrupt
- connections added to a device tree using this function are marked
- as having a permenant disposition. When the tree is (re)
- initialized they will be restored to their initial value.
- */
- EXTERN_TREE\
- (char*) tree_quote_property
- (const char *property_value);
- EXTERN_TREE\
- (device *) tree_parse
- (device *root,
- const char *fmt,
- ...) ATTRIBUTE_PRINTF_2;
- INLINE_TREE\
- (void) tree_usage
- (int verbose);
- INLINE_TREE\
- (void) tree_print
- (device *root);
- INLINE_TREE\
- (device_instance*) tree_instance
- (device *root,
- const char *device_specifier);
- /* Tree traversal::
- The entire device tree can be traversed using the
- <<device_tree_traverse()>> function. The traversal can be in
- either pre- or postfix order.
- */
- typedef void (tree_traverse_function)
- (device *device,
- void *data);
- INLINE_DEVICE\
- (void) tree_traverse
- (device *root,
- tree_traverse_function *prefix,
- tree_traverse_function *postfix,
- void *data);
- /* Tree lookup::
- The function <<tree_find_device()>> will attempt to locate
- the specified device within the tree. If the device is not found a
- NULL device is returned.
- */
- INLINE_TREE\
- (device *) tree_find_device
- (device *root,
- const char *path);
- INLINE_TREE\
- (const device_property *) tree_find_property
- (device *root,
- const char *path_to_property);
- INLINE_TREE\
- (int) tree_find_boolean_property
- (device *root,
- const char *path_to_property);
- INLINE_TREE\
- (signed_cell) tree_find_integer_property
- (device *root,
- const char *path_to_property);
- INLINE_TREE\
- (device_instance *) tree_find_ihandle_property
- (device *root,
- const char *path_to_property);
- INLINE_TREE\
- (const char *) tree_find_string_property
- (device *root,
- const char *path_to_property);
- /* Initializing the created tree:
- Once a device tree has been created the <<device_tree_init()>>
- function is used to initialize it. The exact sequence of events
- that occure during initialization are described separatly.
- */
- INLINE_TREE\
- (void) tree_init
- (device *root,
- psim *system);
- #endif /* _TREE_H_ */
|