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; |
1dd5474e | 41 | extern raw_spinlock_t devtree_lock; |
ced4eec9 | 42 | extern struct list_head aliases_lookup; |
8a2b22a2 GL |
43 | extern struct kset *of_kset; |
44 | ||
6afc0dc3 GL |
45 | #if defined(CONFIG_OF_DYNAMIC) |
46 | extern int of_property_notify(int action, struct device_node *np, | |
259092a3 | 47 | struct property *prop, struct property *old_prop); |
6afc0dc3 | 48 | extern void of_node_release(struct kobject *kobj); |
24789c5c FR |
49 | extern int __of_changeset_apply_entries(struct of_changeset *ocs, |
50 | int *ret_revert); | |
51 | extern int __of_changeset_apply_notify(struct of_changeset *ocs); | |
52 | extern int __of_changeset_revert_entries(struct of_changeset *ocs, | |
53 | int *ret_apply); | |
54 | extern int __of_changeset_revert_notify(struct of_changeset *ocs); | |
6afc0dc3 GL |
55 | #else /* CONFIG_OF_DYNAMIC */ |
56 | static inline int of_property_notify(int action, struct device_node *np, | |
259092a3 | 57 | struct property *prop, struct property *old_prop) |
6afc0dc3 GL |
58 | { |
59 | return 0; | |
60 | } | |
61 | #endif /* CONFIG_OF_DYNAMIC */ | |
62 | ||
73aca58b RH |
63 | #if defined(CONFIG_OF_DYNAMIC) && defined(CONFIG_OF_ADDRESS) |
64 | void of_platform_register_reconfig_notifier(void); | |
65 | #else | |
66 | static inline void of_platform_register_reconfig_notifier(void) { } | |
67 | #endif | |
68 | ||
b56b5528 | 69 | #if defined(CONFIG_OF_KOBJ) |
6effc885 | 70 | int of_node_is_attached(const struct device_node *node); |
b56b5528 RH |
71 | int __of_add_property_sysfs(struct device_node *np, struct property *pp); |
72 | void __of_remove_property_sysfs(struct device_node *np, struct property *prop); | |
73 | void __of_update_property_sysfs(struct device_node *np, struct property *newprop, | |
74 | struct property *oldprop); | |
75 | int __of_attach_node_sysfs(struct device_node *np); | |
76 | void __of_detach_node_sysfs(struct device_node *np); | |
77 | #else | |
78 | static inline int __of_add_property_sysfs(struct device_node *np, struct property *pp) | |
79 | { | |
80 | return 0; | |
81 | } | |
82 | static inline void __of_remove_property_sysfs(struct device_node *np, struct property *prop) {} | |
83 | static inline void __of_update_property_sysfs(struct device_node *np, | |
84 | struct property *newprop, struct property *oldprop) {} | |
85 | static inline int __of_attach_node_sysfs(struct device_node *np) | |
86 | { | |
87 | return 0; | |
88 | } | |
89 | static inline void __of_detach_node_sysfs(struct device_node *np) {} | |
90 | #endif | |
91 | ||
f948d6d8 FR |
92 | #if defined(CONFIG_OF_RESOLVE) |
93 | int of_resolve_phandles(struct device_node *tree); | |
94 | #endif | |
95 | ||
90dc0d1c | 96 | void __of_phandle_cache_inv_entry(phandle handle); |
5801169a | 97 | |
f948d6d8 FR |
98 | #if defined(CONFIG_OF_OVERLAY) |
99 | void of_overlay_mutex_lock(void); | |
100 | void of_overlay_mutex_unlock(void); | |
101 | #else | |
102 | static inline void of_overlay_mutex_lock(void) {}; | |
103 | static inline void of_overlay_mutex_unlock(void) {}; | |
104 | #endif | |
105 | ||
5d4dd65b | 106 | #if defined(CONFIG_OF_UNITTEST) && defined(CONFIG_OF_OVERLAY) |
81d0848f FR |
107 | extern void __init unittest_unflatten_overlay_base(void); |
108 | #else | |
109 | static inline void unittest_unflatten_overlay_base(void) {}; | |
110 | #endif | |
111 | ||
112 | extern void *__unflatten_device_tree(const void *blob, | |
113 | struct device_node *dad, | |
114 | struct device_node **mynodes, | |
115 | void *(*dt_alloc)(u64 size, u64 align), | |
116 | bool detached); | |
117 | ||
69843396 PA |
118 | /** |
119 | * General utilities for working with live trees. | |
120 | * | |
121 | * All functions with two leading underscores operate | |
122 | * without taking node references, so you either have to | |
123 | * own the devtree lock or work on detached trees only. | |
124 | */ | |
125 | struct property *__of_prop_dup(const struct property *prop, gfp_t allocflags); | |
b89dae18 FR |
126 | struct device_node *__of_node_dup(const struct device_node *np, |
127 | const char *full_name); | |
69843396 | 128 | |
e0a58f3e FR |
129 | struct device_node *__of_find_node_by_path(struct device_node *parent, |
130 | const char *path); | |
27497e11 RH |
131 | struct device_node *__of_find_node_by_full_path(struct device_node *node, |
132 | const char *path); | |
133 | ||
a25095d4 GL |
134 | extern const void *__of_get_property(const struct device_node *np, |
135 | const char *name, int *lenp); | |
d8c50088 PA |
136 | extern int __of_add_property(struct device_node *np, struct property *prop); |
137 | extern int __of_remove_property(struct device_node *np, struct property *prop); | |
138 | extern int __of_update_property(struct device_node *np, | |
139 | struct property *newprop, struct property **oldprop); | |
140 | ||
d8c50088 PA |
141 | extern void __of_detach_node(struct device_node *np); |
142 | ||
d9fc8807 FR |
143 | extern void __of_sysfs_remove_bin_file(struct device_node *np, |
144 | struct property *prop); | |
145 | ||
0b3ce78e FR |
146 | /* illegal phandle value (set when unresolved) */ |
147 | #define OF_PHANDLE_ILLEGAL 0xdeadbeef | |
148 | ||
201c910b PA |
149 | /* iterators for transactions, used for overlays */ |
150 | /* forward iterator */ | |
151 | #define for_each_transaction_entry(_oft, _te) \ | |
152 | list_for_each_entry(_te, &(_oft)->te_list, node) | |
153 | ||
154 | /* reverse iterator */ | |
155 | #define for_each_transaction_entry_reverse(_oft, _te) \ | |
156 | list_for_each_entry_reverse(_te, &(_oft)->te_list, node) | |
157 | ||
b68ac8dc RM |
158 | extern int of_bus_n_addr_cells(struct device_node *np); |
159 | extern int of_bus_n_size_cells(struct device_node *np); | |
160 | ||
e0d07278 JQ |
161 | struct bus_dma_region; |
162 | #if defined(CONFIG_OF_ADDRESS) && defined(CONFIG_HAS_DMA) | |
163 | int of_dma_get_range(struct device_node *np, | |
164 | const struct bus_dma_region **map); | |
f1ad5338 | 165 | struct device_node *__of_get_dma_parent(const struct device_node *np); |
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 | } | |
f1ad5338 RM |
172 | static inline struct device_node *__of_get_dma_parent(const struct device_node *np) |
173 | { | |
174 | return of_get_parent(np); | |
175 | } | |
6e6faf63 RH |
176 | #endif |
177 | ||
12d55d3b RH |
178 | void fdt_init_reserved_mem(void); |
179 | void fdt_reserved_mem_save_node(unsigned long node, const char *uname, | |
180 | phys_addr_t base, phys_addr_t size); | |
181 | ||
ced4eec9 | 182 | #endif /* _LINUX_OF_PRIVATE_H */ |