Commit | Line | Data |
---|---|---|
af6074fc | 1 | /* SPDX-License-Identifier: GPL-2.0+ */ |
ced4eec9 SM |
2 | #ifndef _LINUX_OF_PRIVATE_H |
3 | #define _LINUX_OF_PRIVATE_H | |
4 | /* | |
5 | * Private symbols used by OF support code | |
6 | * | |
7 | * Paul Mackerras August 1996. | |
8 | * Copyright (C) 1996-2005 Paul Mackerras. | |
ced4eec9 SM |
9 | */ |
10 | ||
48d499bd FR |
11 | #define FDT_ALIGN_SIZE 8 |
12 | ||
ced4eec9 SM |
13 | /** |
14 | * struct alias_prop - Alias property in 'aliases' node | |
15 | * @link: List node to link the structure in aliases_lookup list | |
16 | * @alias: Alias property name | |
17 | * @np: Pointer to device_node that the alias stands for | |
18 | * @id: Index value from end of alias name | |
19 | * @stem: Alias string without the index | |
20 | * | |
21 | * The structure represents one alias property of 'aliases' node as | |
22 | * an entry in aliases_lookup list. | |
23 | */ | |
24 | struct alias_prop { | |
25 | struct list_head link; | |
26 | const char *alias; | |
27 | struct device_node *np; | |
28 | int id; | |
f4377562 | 29 | char stem[]; |
ced4eec9 SM |
30 | }; |
31 | ||
00b7d1cf RH |
32 | #if defined(CONFIG_SPARC) |
33 | #define OF_ROOT_NODE_ADDR_CELLS_DEFAULT 2 | |
34 | #else | |
35 | #define OF_ROOT_NODE_ADDR_CELLS_DEFAULT 1 | |
36 | #endif | |
37 | ||
38 | #define OF_ROOT_NODE_SIZE_CELLS_DEFAULT 1 | |
39 | ||
c05aba2b | 40 | extern struct mutex of_mutex; |
ced4eec9 | 41 | extern struct list_head aliases_lookup; |
8a2b22a2 GL |
42 | extern struct kset *of_kset; |
43 | ||
6afc0dc3 GL |
44 | #if defined(CONFIG_OF_DYNAMIC) |
45 | extern int of_property_notify(int action, struct device_node *np, | |
259092a3 | 46 | struct property *prop, struct property *old_prop); |
6afc0dc3 | 47 | extern void of_node_release(struct kobject *kobj); |
24789c5c FR |
48 | extern int __of_changeset_apply_entries(struct of_changeset *ocs, |
49 | int *ret_revert); | |
50 | extern int __of_changeset_apply_notify(struct of_changeset *ocs); | |
51 | extern int __of_changeset_revert_entries(struct of_changeset *ocs, | |
52 | int *ret_apply); | |
53 | extern int __of_changeset_revert_notify(struct of_changeset *ocs); | |
6afc0dc3 GL |
54 | #else /* CONFIG_OF_DYNAMIC */ |
55 | static inline int of_property_notify(int action, struct device_node *np, | |
259092a3 | 56 | struct property *prop, struct property *old_prop) |
6afc0dc3 GL |
57 | { |
58 | return 0; | |
59 | } | |
60 | #endif /* CONFIG_OF_DYNAMIC */ | |
61 | ||
b56b5528 RH |
62 | #if defined(CONFIG_OF_KOBJ) |
63 | int of_node_is_attached(struct device_node *node); | |
64 | int __of_add_property_sysfs(struct device_node *np, struct property *pp); | |
65 | void __of_remove_property_sysfs(struct device_node *np, struct property *prop); | |
66 | void __of_update_property_sysfs(struct device_node *np, struct property *newprop, | |
67 | struct property *oldprop); | |
68 | int __of_attach_node_sysfs(struct device_node *np); | |
69 | void __of_detach_node_sysfs(struct device_node *np); | |
70 | #else | |
71 | static inline int __of_add_property_sysfs(struct device_node *np, struct property *pp) | |
72 | { | |
73 | return 0; | |
74 | } | |
75 | static inline void __of_remove_property_sysfs(struct device_node *np, struct property *prop) {} | |
76 | static inline void __of_update_property_sysfs(struct device_node *np, | |
77 | struct property *newprop, struct property *oldprop) {} | |
78 | static inline int __of_attach_node_sysfs(struct device_node *np) | |
79 | { | |
80 | return 0; | |
81 | } | |
82 | static inline void __of_detach_node_sysfs(struct device_node *np) {} | |
83 | #endif | |
84 | ||
f948d6d8 FR |
85 | #if defined(CONFIG_OF_RESOLVE) |
86 | int of_resolve_phandles(struct device_node *tree); | |
87 | #endif | |
88 | ||
90dc0d1c | 89 | void __of_phandle_cache_inv_entry(phandle handle); |
5801169a | 90 | |
f948d6d8 FR |
91 | #if defined(CONFIG_OF_OVERLAY) |
92 | void of_overlay_mutex_lock(void); | |
93 | void of_overlay_mutex_unlock(void); | |
94 | #else | |
95 | static inline void of_overlay_mutex_lock(void) {}; | |
96 | static inline void of_overlay_mutex_unlock(void) {}; | |
97 | #endif | |
98 | ||
5d4dd65b | 99 | #if defined(CONFIG_OF_UNITTEST) && defined(CONFIG_OF_OVERLAY) |
81d0848f FR |
100 | extern void __init unittest_unflatten_overlay_base(void); |
101 | #else | |
102 | static inline void unittest_unflatten_overlay_base(void) {}; | |
103 | #endif | |
104 | ||
105 | extern void *__unflatten_device_tree(const void *blob, | |
106 | struct device_node *dad, | |
107 | struct device_node **mynodes, | |
108 | void *(*dt_alloc)(u64 size, u64 align), | |
109 | bool detached); | |
110 | ||
69843396 PA |
111 | /** |
112 | * General utilities for working with live trees. | |
113 | * | |
114 | * All functions with two leading underscores operate | |
115 | * without taking node references, so you either have to | |
116 | * own the devtree lock or work on detached trees only. | |
117 | */ | |
118 | struct property *__of_prop_dup(const struct property *prop, gfp_t allocflags); | |
b89dae18 FR |
119 | struct device_node *__of_node_dup(const struct device_node *np, |
120 | const char *full_name); | |
69843396 | 121 | |
e0a58f3e FR |
122 | struct device_node *__of_find_node_by_path(struct device_node *parent, |
123 | const char *path); | |
27497e11 RH |
124 | struct device_node *__of_find_node_by_full_path(struct device_node *node, |
125 | const char *path); | |
126 | ||
a25095d4 GL |
127 | extern const void *__of_get_property(const struct device_node *np, |
128 | const char *name, int *lenp); | |
d8c50088 | 129 | extern int __of_add_property(struct device_node *np, struct property *prop); |
8a2b22a2 GL |
130 | extern int __of_add_property_sysfs(struct device_node *np, |
131 | struct property *prop); | |
d8c50088 | 132 | extern int __of_remove_property(struct device_node *np, struct property *prop); |
8a2b22a2 GL |
133 | extern void __of_remove_property_sysfs(struct device_node *np, |
134 | struct property *prop); | |
d8c50088 PA |
135 | extern int __of_update_property(struct device_node *np, |
136 | struct property *newprop, struct property **oldprop); | |
8a2b22a2 GL |
137 | extern void __of_update_property_sysfs(struct device_node *np, |
138 | struct property *newprop, struct property *oldprop); | |
d8c50088 | 139 | |
8a2b22a2 | 140 | extern int __of_attach_node_sysfs(struct device_node *np); |
d8c50088 | 141 | extern void __of_detach_node(struct device_node *np); |
8a2b22a2 | 142 | extern void __of_detach_node_sysfs(struct device_node *np); |
d8c50088 | 143 | |
d9fc8807 FR |
144 | extern void __of_sysfs_remove_bin_file(struct device_node *np, |
145 | struct property *prop); | |
146 | ||
0b3ce78e FR |
147 | /* illegal phandle value (set when unresolved) */ |
148 | #define OF_PHANDLE_ILLEGAL 0xdeadbeef | |
149 | ||
201c910b PA |
150 | /* iterators for transactions, used for overlays */ |
151 | /* forward iterator */ | |
152 | #define for_each_transaction_entry(_oft, _te) \ | |
153 | list_for_each_entry(_te, &(_oft)->te_list, node) | |
154 | ||
155 | /* reverse iterator */ | |
156 | #define for_each_transaction_entry_reverse(_oft, _te) \ | |
157 | list_for_each_entry_reverse(_te, &(_oft)->te_list, node) | |
158 | ||
b68ac8dc RM |
159 | extern int of_bus_n_addr_cells(struct device_node *np); |
160 | extern int of_bus_n_size_cells(struct device_node *np); | |
161 | ||
e0d07278 JQ |
162 | struct bus_dma_region; |
163 | #if defined(CONFIG_OF_ADDRESS) && defined(CONFIG_HAS_DMA) | |
164 | int of_dma_get_range(struct device_node *np, | |
165 | const struct bus_dma_region **map); | |
6e6faf63 | 166 | #else |
e0d07278 JQ |
167 | static inline int of_dma_get_range(struct device_node *np, |
168 | const struct bus_dma_region **map) | |
6e6faf63 RH |
169 | { |
170 | return -ENODEV; | |
171 | } | |
172 | #endif | |
173 | ||
ced4eec9 | 174 | #endif /* _LINUX_OF_PRIVATE_H */ |