1 /* SPDX-License-Identifier: GPL-2.0+ */
2 /*
3  * Definitions for building a device tree by calling into the
4  * Open Firmware PROM.
5  *
6  * Copyright (C) 2010  Andres Salomon <dilinger@queued.net>
7  */
8 
9 #ifndef _LINUX_OF_PDT_H
10 #define _LINUX_OF_PDT_H
11 
12 /* overridable operations for calling into the PROM */
13 struct of_pdt_ops {
14 	/*
15 	 * buf should be 32 bytes; return 0 on success.
16 	 * If prev is NULL, the first property will be returned.
17 	 */
18 	int (*nextprop)(phandle node, char *prev, char *buf);
19 
20 	/* for both functions, return proplen on success; -1 on error */
21 	int (*getproplen)(phandle node, const char *prop);
22 	int (*getproperty)(phandle node, const char *prop, char *buf,
23 			int bufsize);
24 
25 	/* phandles are 0 if no child or sibling exists */
26 	phandle (*getchild)(phandle parent);
27 	phandle (*getsibling)(phandle node);
28 
29 	/* return 0 on success; fill in 'len' with number of bytes in path */
30 	int (*pkg2path)(phandle node, char *buf, const int buflen, int *len);
31 };
32 
33 extern void *prom_early_alloc(unsigned long size);
34 
35 /* for building the device tree */
36 extern void of_pdt_build_devicetree(phandle root_node, struct of_pdt_ops *ops);
37 
38 #endif /* _LINUX_OF_PDT_H */
39