xref: /openbmc/linux/include/drm/drm_mm.h (revision f1938cd6)
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 #ifdef CONFIG_DEBUG_FS
41 #include <linux/seq_file.h>
42 #endif
43 
44 struct drm_mm_node {
45 	struct list_head fl_entry;
46 	struct list_head ml_entry;
47 	int free;
48 	unsigned long start;
49 	unsigned long size;
50 	struct drm_mm *mm;
51 	void *private;
52 };
53 
54 struct drm_mm {
55 	struct list_head fl_entry;
56 	struct list_head ml_entry;
57 	struct list_head unused_nodes;
58 	int num_unused;
59 	spinlock_t unused_lock;
60 };
61 
62 /*
63  * Basic range manager support (drm_mm.c)
64  */
65 extern struct drm_mm_node *drm_mm_get_block_generic(struct drm_mm_node *node,
66 						    unsigned long size,
67 						    unsigned alignment,
68 						    int atomic);
69 static inline struct drm_mm_node *drm_mm_get_block(struct drm_mm_node *parent,
70 						   unsigned long size,
71 						   unsigned alignment)
72 {
73 	return drm_mm_get_block_generic(parent, size, alignment, 0);
74 }
75 static inline struct drm_mm_node *drm_mm_get_block_atomic(struct drm_mm_node *parent,
76 							  unsigned long size,
77 							  unsigned alignment)
78 {
79 	return drm_mm_get_block_generic(parent, size, alignment, 1);
80 }
81 extern void drm_mm_put_block(struct drm_mm_node *cur);
82 extern struct drm_mm_node *drm_mm_search_free(const struct drm_mm *mm,
83 					      unsigned long size,
84 					      unsigned alignment,
85 					      int best_match);
86 extern int drm_mm_init(struct drm_mm *mm, unsigned long start,
87 		       unsigned long size);
88 extern void drm_mm_takedown(struct drm_mm *mm);
89 extern int drm_mm_clean(struct drm_mm *mm);
90 extern unsigned long drm_mm_tail_space(struct drm_mm *mm);
91 extern int drm_mm_remove_space_from_tail(struct drm_mm *mm,
92 					 unsigned long size);
93 extern int drm_mm_add_space_to_tail(struct drm_mm *mm,
94 				    unsigned long size, int atomic);
95 extern int drm_mm_pre_get(struct drm_mm *mm);
96 
97 static inline struct drm_mm *drm_get_mm(struct drm_mm_node *block)
98 {
99 	return block->mm;
100 }
101 
102 #ifdef CONFIG_DEBUG_FS
103 int drm_mm_dump_table(struct seq_file *m, struct drm_mm *mm);
104 #endif
105 
106 #endif
107