include/linux/of_graph.h

Source file repositories/reference/linux-study-clean/include/linux/of_graph.h

File Facts

System
Linux kernel
Corpus path
include/linux/of_graph.h
Extension
.h
Size
5528 bytes
Lines
177
Domain
Core OS
Bucket
Core Kernel Interface
Inferred role
Core OS: implementation source
Status
source implementation candidate

Why This File Exists

Core operating-system implementation surface: boot, tasks, memory, VFS, syscall-facing interfaces, synchronization, credentials, and isolation.

Dependency Surface

Detected Declarations

Annotated Snippet

struct of_endpoint {
	unsigned int port;
	unsigned int id;
	const struct device_node *local_node;
};

/**
 * for_each_endpoint_of_node - iterate over every endpoint in a device node
 * @parent: parent device node containing ports and endpoints
 * @child: loop variable pointing to the current endpoint node
 *
 * When breaking out of the loop, of_node_put(child) has to be called manually.
 */
#define for_each_endpoint_of_node(parent, child) \
	for (child = of_graph_get_next_endpoint(parent, NULL); child != NULL; \
	     child = of_graph_get_next_endpoint(parent, child))

/**
 * for_each_of_graph_port - iterate over every port in a device or ports node
 * @parent: parent device or ports node containing port
 * @child: loop variable pointing to the current port node
 *
 * When breaking out of the loop, and continue to use the @child, you need to
 * use return_ptr(@child) or no_free_ptr(@child) not to call __free() for it.
 */
#define for_each_of_graph_port(parent, child)			\
	for (struct device_node *child __free(device_node) = of_graph_get_next_port(parent, NULL);\
	     child != NULL; child = of_graph_get_next_port(parent, child))

/**
 * for_each_of_graph_port_endpoint - iterate over every endpoint in a port node
 * @parent: parent port node
 * @child: loop variable pointing to the current endpoint node
 *
 * When breaking out of the loop, and continue to use the @child, you need to
 * use return_ptr(@child) or no_free_ptr(@child) not to call __free() for it.
 */
#define for_each_of_graph_port_endpoint(parent, child)			\
	for (struct device_node *child __free(device_node) = of_graph_get_next_port_endpoint(parent, NULL);\
	     child != NULL; child = of_graph_get_next_port_endpoint(parent, child))

#ifdef CONFIG_OF
bool of_graph_is_present(const struct device_node *node);
int of_graph_parse_endpoint(const struct device_node *node,
				struct of_endpoint *endpoint);
unsigned int of_graph_get_endpoint_count(const struct device_node *np);
unsigned int of_graph_get_port_count(struct device_node *np);
struct device_node *of_graph_get_port_by_id(struct device_node *node, u32 id);
struct device_node *of_graph_get_next_endpoint(const struct device_node *parent,
					struct device_node *previous);
struct device_node *of_graph_get_next_port(const struct device_node *parent,
					   struct device_node *port);
struct device_node *of_graph_get_next_port_endpoint(const struct device_node *port,
						    struct device_node *prev);
struct device_node *of_graph_get_endpoint_by_regs(
		const struct device_node *parent, int port_reg, int reg);
struct device_node *of_graph_get_remote_endpoint(
					const struct device_node *node);
struct device_node *of_graph_get_port_parent(struct device_node *node);
struct device_node *of_graph_get_remote_port_parent(
					const struct device_node *node);
struct device_node *of_graph_get_remote_port(const struct device_node *node);
struct device_node *of_graph_get_remote_node(const struct device_node *node,
					     u32 port, u32 endpoint);
#else

static inline bool of_graph_is_present(const struct device_node *node)
{
	return false;
}

static inline int of_graph_parse_endpoint(const struct device_node *node,
					struct of_endpoint *endpoint)
{
	return -ENOSYS;
}

static inline unsigned int of_graph_get_endpoint_count(const struct device_node *np)
{
	return 0;
}

static inline unsigned int of_graph_get_port_count(struct device_node *np)
{
	return 0;
}

static inline struct device_node *of_graph_get_port_by_id(
					struct device_node *node, u32 id)
{

Annotation

Implementation Notes