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 */
13struct 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
33extern void *prom_early_alloc(unsigned long size);
34
35/* for building the device tree */
36extern void of_pdt_build_devicetree(phandle root_node, struct of_pdt_ops *ops);
37
38#endif /* _LINUX_OF_PDT_H */
39