ꦫꦣꦺꦤ꧀ꦄꦤ꧀ꦠꦱꦺꦤ

PATH: usr / src / kernels / 5.14.0-611.49.2.el9_7.x86_64 / include / drm

/* SPDX-License-Identifier: MIT */
/*
 * Copyright © 2021 Intel Corporation
 */

#ifndef __DRM_BUDDY_H__
#define __DRM_BUDDY_H__

#include <linux/bitops.h>
#include <linux/list.h>
#include <linux/slab.h>
#include <linux/sched.h>

#include <drm/drm_print.h>

#define range_overflows(start, size, max) ({ \
	typeof(start) start__ = (start); \
	typeof(size) size__ = (size); \
	typeof(max) max__ = (max); \
	(void)(&start__ == &size__); \
	(void)(&start__ == &max__); \
	start__ >= max__ || size__ > max__ - start__; \
})

#define DRM_BUDDY_RANGE_ALLOCATION		BIT(0)
#define DRM_BUDDY_TOPDOWN_ALLOCATION		BIT(1)
#define DRM_BUDDY_CONTIGUOUS_ALLOCATION		BIT(2)
#define DRM_BUDDY_CLEAR_ALLOCATION		BIT(3)
#define DRM_BUDDY_CLEARED			BIT(4)
#define DRM_BUDDY_TRIM_DISABLE			BIT(5)

struct drm_buddy_block {
#define DRM_BUDDY_HEADER_OFFSET GENMASK_ULL(63, 12)
#define DRM_BUDDY_HEADER_STATE  GENMASK_ULL(11, 10)
#define   DRM_BUDDY_ALLOCATED	   (1 << 10)
#define   DRM_BUDDY_FREE	   (2 << 10)
#define   DRM_BUDDY_SPLIT	   (3 << 10)
#define DRM_BUDDY_HEADER_CLEAR  GENMASK_ULL(9, 9)
/* Free to be used, if needed in the future */
#define DRM_BUDDY_HEADER_UNUSED GENMASK_ULL(8, 6)
#define DRM_BUDDY_HEADER_ORDER  GENMASK_ULL(5, 0)
	u64 header;

struct drm_buddy_block *left;
	struct drm_buddy_block *right;
	struct drm_buddy_block *parent;

void *private; /* owned by creator */

/*
	 * While the block is allocated by the user through drm_buddy_alloc*,
	 * the user has ownership of the link, for example to maintain within
	 * a list, if so desired. As soon as the block is freed with
	 * drm_buddy_free* ownership is given back to the mm.
	 */
	struct list_head link;
	struct list_head tmp_link;
};

/* Order-zero must be at least SZ_4K */
#define DRM_BUDDY_MAX_ORDER (63 - 12)

/*
 * Binary Buddy System.
 *
 * Locking should be handled by the user, a simple mutex around
 * drm_buddy_alloc* and drm_buddy_free* should suffice.
 */
struct drm_buddy {
	/* Maintain a free list for each order. */
	struct list_head *free_list;

/*
	 * Maintain explicit binary tree(s) to track the allocation of the
	 * address space. This gives us a simple way of finding a buddy block
	 * and performing the potentially recursive merge step when freeing a
	 * block.  Nodes are either allocated or free, in which case they will
	 * also exist on the respective free list.
	 */
	struct drm_buddy_block **roots;

/*
	 * Anything from here is public, and remains static for the lifetime of
	 * the mm. Everything above is considered do-not-touch.
	 */
	unsigned int n_roots;
	unsigned int max_order;

/* Must be at least SZ_4K */
	u64 chunk_size;
	u64 size;
	u64 avail;
	u64 clear_avail;
};

static inline u64
drm_buddy_block_offset(struct drm_buddy_block *block)
{
	return block->header & DRM_BUDDY_HEADER_OFFSET;
}

static inline unsigned int
drm_buddy_block_order(struct drm_buddy_block *block)
{
	return block->header & DRM_BUDDY_HEADER_ORDER;
}

static inline unsigned int
drm_buddy_block_state(struct drm_buddy_block *block)
{
	return block->header & DRM_BUDDY_HEADER_STATE;
}

static inline bool
drm_buddy_block_is_allocated(struct drm_buddy_block *block)
{
	return drm_buddy_block_state(block) == DRM_BUDDY_ALLOCATED;
}

static inline bool
drm_buddy_block_is_clear(struct drm_buddy_block *block)
{
	return block->header & DRM_BUDDY_HEADER_CLEAR;
}

static inline bool
drm_buddy_block_is_free(struct drm_buddy_block *block)
{
	return drm_buddy_block_state(block) == DRM_BUDDY_FREE;
}

static inline bool
drm_buddy_block_is_split(struct drm_buddy_block *block)
{
	return drm_buddy_block_state(block) == DRM_BUDDY_SPLIT;
}

static inline u64
drm_buddy_block_size(struct drm_buddy *mm,
		     struct drm_buddy_block *block)
{
	return mm->chunk_size << drm_buddy_block_order(block);
}

int drm_buddy_init(struct drm_buddy *mm, u64 size, u64 chunk_size);

void drm_buddy_fini(struct drm_buddy *mm);

struct drm_buddy_block *
drm_get_buddy(struct drm_buddy_block *block);

int drm_buddy_alloc_blocks(struct drm_buddy *mm,
			   u64 start, u64 end, u64 size,
			   u64 min_page_size,
			   struct list_head *blocks,
			   unsigned long flags);

int drm_buddy_block_trim(struct drm_buddy *mm,
			 u64 *start,
			 u64 new_size,
			 struct list_head *blocks);

void drm_buddy_free_block(struct drm_buddy *mm, struct drm_buddy_block *block);

void drm_buddy_free_list(struct drm_buddy *mm,
			 struct list_head *objects,
			 unsigned int flags);

void drm_buddy_print(struct drm_buddy *mm, struct drm_printer *p);
void drm_buddy_block_print(struct drm_buddy *mm,
			   struct drm_buddy_block *block,
			   struct drm_printer *p);
#endif

[-] drm_eld.h [edit]
[-] drm_bridge.h [edit]
[-] spsc_queue.h [edit]
[-] drm_gem_dma_helper.h [edit]
[-] drm_property.h [edit]
[-] drm_auth.h [edit]
[-] drm_mipi_dbi.h [edit]
[-] drm_mode_object.h [edit]
[-] drm_pciids.h [edit]
[+] ttm
[-] drm_privacy_screen_machine.h [edit]
[-] drm_fixed.h [edit]
[-] drm_fb_helper.h [edit]
[-] drm_gem_ttm_helper.h [edit]
[-] drm_pagemap.h [edit]
[-] drm_atomic_uapi.h [edit]
[-] drm_module.h [edit]
[+] display
[-] drm_encoder.h [edit]
[-] drm_file.h [edit]
[-] drm_connector.h [edit]
[-] drm_utils.h [edit]
[-] drm_suballoc.h [edit]
[+] intel
[-] drm_audio_component.h [edit]
[-] drm_prime.h [edit]
[-] drm_atomic_helper.h [edit]
[-] i915_pciids.h [edit]
[-] drm_mipi_dsi.h [edit]
[-] drm_writeback.h [edit]
[-] drm_gem_framebuffer_helper.h [edit]
[-] drm_lease.h [edit]
[-] drm_crtc_helper.h [edit]
[-] drm_client.h [edit]
[-] Makefile [edit]
[-] drm_vblank.h [edit]
[-] drm_format_helper.h [edit]
[-] drm_fb_dma_helper.h [edit]
[-] drm_mode_config.h [edit]
[-] drm_debugfs.h [edit]
[-] drm_print.h [edit]
[-] drm_client_event.h [edit]
[-] drm_panel.h [edit]
[-] drm_gem_shmem_helper.h [edit]
[-] drm_debugfs_crc.h [edit]
[-] drm_cache.h [edit]
[-] drm_sysfs.h [edit]
[+] clients
[-] drm_edid.h [edit]
[-] drm_modeset_helper.h [edit]
[-] drm_atomic_state_helper.h [edit]
[-] drm_ioctl.h [edit]
[-] drm_blend.h [edit]
[-] drm_gem_vram_helper.h [edit]
[-] drm_panic.h [edit]
[-] drm_plane_helper.h [edit]
[-] drm_fbdev_dma.h [edit]
[-] drm_bridge_connector.h [edit]
[-] drm_probe_helper.h [edit]
[-] drm_modeset_helper_vtables.h [edit]
[-] drm_device.h [edit]
[-] drm_exec.h [edit]
[-] drm_atomic.h [edit]
[-] gud.h [edit]
[-] drm_gem.h [edit]
[-] drm_gpuvm.h [edit]
[-] drm_mm.h [edit]
[-] drm_plane.h [edit]
[-] drm_gpusvm.h [edit]
[-] drm_simple_kms_helper.h [edit]
[-] drm_syncobj.h [edit]
[-] drm_gem_atomic_helper.h [edit]
[-] drm_fbdev_shmem.h [edit]
[-] drm_framebuffer.h [edit]
[-] drm_accel.h [edit]
[-] drm_self_refresh_helper.h [edit]
[-] amd_asic_type.h [edit]
[-] drm_privacy_screen_consumer.h [edit]
[-] gpu_scheduler.h [edit]
[-] drm_fbdev_ttm.h [edit]
[-] drm_managed.h [edit]
[-] task_barrier.h [edit]
[-] drm_fourcc.h [edit]
[-] drm_vblank_work.h [edit]
[-] drm_modes.h [edit]
[-] drm_vma_manager.h [edit]
[-] drm_buddy.h [edit]
[-] drm_of.h [edit]
[+] ..
[+] bridge
[-] drm_modeset_lock.h [edit]
[-] drm_rect.h [edit]
[-] drm_flip_work.h [edit]
[-] drm_util.h [edit]
[-] drm_damage_helper.h [edit]
[-] drm_drv.h [edit]
[-] drm_kunit_helpers.h [edit]
[-] drm_color_mgmt.h [edit]
[-] drm_crtc.h [edit]
[-] drm_privacy_screen_driver.h [edit]