include/linux/of_reserved_mem.h

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

File Facts

System
Linux kernel
Corpus path
include/linux/of_reserved_mem.h
Extension
.h
Size
3178 bytes
Lines
112
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 reserved_mem {
	const char			*name;
	const struct reserved_mem_ops	*ops;
	phys_addr_t			base;
	phys_addr_t			size;
	void				*priv;
};

struct reserved_mem_ops {
	int	(*node_validate)(unsigned long fdt_node, phys_addr_t *align);
	int	(*node_fixup)(unsigned long fdt_node, phys_addr_t base,
			      phys_addr_t size);
	int	(*node_init)(unsigned long fdt_node, struct reserved_mem *rmem);
	int	(*device_init)(struct reserved_mem *rmem,
			       struct device *dev);
	void	(*device_release)(struct reserved_mem *rmem,
				  struct device *dev);
};

#ifdef CONFIG_OF_RESERVED_MEM

#define RESERVEDMEM_OF_DECLARE(name, compat, ops)			\
	_OF_DECLARE(reservedmem, name, compat, ops, struct reserved_mem_ops *)

int of_reserved_mem_device_init_by_idx(struct device *dev,
				       struct device_node *np, int idx);
int of_reserved_mem_device_init_by_name(struct device *dev,
					struct device_node *np,
					const char *name);
void of_reserved_mem_device_release(struct device *dev);

struct reserved_mem *of_reserved_mem_lookup(struct device_node *np);
int of_reserved_mem_region_to_resource(const struct device_node *np,
				       unsigned int idx, struct resource *res);
int of_reserved_mem_region_to_resource_byname(const struct device_node *np,
					      const char *name, struct resource *res);
int of_reserved_mem_region_count(const struct device_node *np);

#else

#define RESERVEDMEM_OF_DECLARE(name, compat, ops)			\
	_OF_DECLARE_STUB(reservedmem, name, compat, ops,		\
			 struct reserved_mem_ops *)

static inline int of_reserved_mem_device_init_by_idx(struct device *dev,
					struct device_node *np, int idx)
{
	return -ENOSYS;
}

static inline int of_reserved_mem_device_init_by_name(struct device *dev,
						      struct device_node *np,
						      const char *name)
{
	return -ENOSYS;
}

static inline void of_reserved_mem_device_release(struct device *pdev) { }

static inline struct reserved_mem *of_reserved_mem_lookup(struct device_node *np)
{
	return NULL;
}

static inline int of_reserved_mem_region_to_resource(const struct device_node *np,
						     unsigned int idx,
						     struct resource *res)
{
	return -ENOSYS;
}

static inline int of_reserved_mem_region_to_resource_byname(const struct device_node *np,
							    const char *name,
							    struct resource *res)
{
	return -ENOSYS;
}

static inline int of_reserved_mem_region_count(const struct device_node *np)
{
	return 0;
}
#endif

/**
 * of_reserved_mem_device_init() - assign reserved memory region to given device
 * @dev:	Pointer to the device to configure
 *
 * This function assigns respective DMA-mapping operations based on the first
 * reserved memory region specified by 'memory-region' property in device tree

Annotation

Implementation Notes