xref: /openbmc/linux/include/drm/drm_mm.h (revision 89579f77)
1 /**************************************************************************
2  *
3  * Copyright 2006-2008 Tungsten Graphics, Inc., Cedar Park, TX. USA.
4  * All Rights Reserved.
5  *
6  * Permission is hereby granted, free of charge, to any person obtaining a
7  * copy of this software and associated documentation files (the
8  * "Software"), to deal in the Software without restriction, including
9  * without limitation the rights to use, copy, modify, merge, publish,
10  * distribute, sub license, and/or sell copies of the Software, and to
11  * permit persons to whom the Software is furnished to do so, subject to
12  * the following conditions:
13  *
14  * The above copyright notice and this permission notice (including the
15  * next paragraph) shall be included in all copies or substantial portions
16  * of the Software.
17  *
18  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
19  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
20  * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL
21  * THE COPYRIGHT HOLDERS, AUTHORS AND/OR ITS SUPPLIERS BE LIABLE FOR ANY CLAIM,
22  * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
23  * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
24  * USE OR OTHER DEALINGS IN THE SOFTWARE.
25  *
26  *
27  **************************************************************************/
28 /*
29  * Authors:
30  * Thomas Hellstrom <thomas-at-tungstengraphics-dot-com>
31  */
32 
33 #ifndef _DRM_MM_H_
34 #define _DRM_MM_H_
35 
36 /*
37  * Generic range manager structs
38  */
39 #include <linux/list.h>
40 
41 struct drm_mm_node {
42 	struct list_head fl_entry;
43 	struct list_head ml_entry;
44 	int free;
45 	unsigned long start;
46 	unsigned long size;
47 	struct drm_mm *mm;
48 	void *private;
49 };
50 
51 struct drm_mm {
52 	struct list_head fl_entry;
53 	struct list_head ml_entry;
54 	struct list_head unused_nodes;
55 	int num_unused;
56 	spinlock_t unused_lock;
57 };
58 
59 /*
60  * Basic range manager support (drm_mm.c)
61  */
62 extern struct drm_mm_node *drm_mm_get_block_generic(struct drm_mm_node *node,
63 						    unsigned long size,
64 						    unsigned alignment,
65 						    int atomic);
66 static inline struct drm_mm_node *drm_mm_get_block(struct drm_mm_node *parent,
67 						   unsigned long size,
68 						   unsigned alignment)
69 {
70 	return drm_mm_get_block_generic(parent, size, alignment, 0);
71 }
72 static inline struct drm_mm_node *drm_mm_get_block_atomic(struct drm_mm_node *parent,
73 							  unsigned long size,
74 							  unsigned alignment)
75 {
76 	return drm_mm_get_block_generic(parent, size, alignment, 1);
77 }
78 extern void drm_mm_put_block(struct drm_mm_node *cur);
79 extern struct drm_mm_node *drm_mm_search_free(const struct drm_mm *mm,
80 					      unsigned long size,
81 					      unsigned alignment,
82 					      int best_match);
83 extern int drm_mm_init(struct drm_mm *mm, unsigned long start,
84 		       unsigned long size);
85 extern void drm_mm_takedown(struct drm_mm *mm);
86 extern int drm_mm_clean(struct drm_mm *mm);
87 extern unsigned long drm_mm_tail_space(struct drm_mm *mm);
88 extern int drm_mm_remove_space_from_tail(struct drm_mm *mm,
89 					 unsigned long size);
90 extern int drm_mm_add_space_to_tail(struct drm_mm *mm,
91 				    unsigned long size, int atomic);
92 extern int drm_mm_pre_get(struct drm_mm *mm);
93 
94 static inline struct drm_mm *drm_get_mm(struct drm_mm_node *block)
95 {
96 	return block->mm;
97 }
98 
99 #endif
100