]> git.karo-electronics.de Git - karo-tx-linux.git/blob - include/drm/drm_sman.h
drm: reorganise drm tree to be more future proof.
[karo-tx-linux.git] / include / drm / drm_sman.h
1 /**************************************************************************
2  *
3  * Copyright 2006 Tungsten Graphics, Inc., Bismarck, ND., 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  * Simple memory MANager interface that keeps track on allocate regions on a
30  * per "owner" basis. All regions associated with an "owner" can be released
31  * with a simple call. Typically if the "owner" exists. The owner is any
32  * "unsigned long" identifier. Can typically be a pointer to a file private
33  * struct or a context identifier.
34  *
35  * Authors:
36  * Thomas Hellström <thomas-at-tungstengraphics-dot-com>
37  */
38
39 #ifndef DRM_SMAN_H
40 #define DRM_SMAN_H
41
42 #include "drmP.h"
43 #include "drm_hashtab.h"
44
45 /*
46  * A class that is an abstration of a simple memory allocator.
47  * The sman implementation provides a default such allocator
48  * using the drm_mm.c implementation. But the user can replace it.
49  * See the SiS implementation, which may use the SiS FB kernel module
50  * for memory management.
51  */
52
53 struct drm_sman_mm {
54         /* private info. If allocated, needs to be destroyed by the destroy
55            function */
56         void *private;
57
58         /* Allocate a memory block with given size and alignment.
59            Return an opaque reference to the memory block */
60
61         void *(*allocate) (void *private, unsigned long size,
62                            unsigned alignment);
63
64         /* Free a memory block. "ref" is the opaque reference that we got from
65            the "alloc" function */
66
67         void (*free) (void *private, void *ref);
68
69         /* Free all resources associated with this allocator */
70
71         void (*destroy) (void *private);
72
73         /* Return a memory offset from the opaque reference returned from the
74            "alloc" function */
75
76         unsigned long (*offset) (void *private, void *ref);
77 };
78
79 struct drm_memblock_item {
80         struct list_head owner_list;
81         struct drm_hash_item user_hash;
82         void *mm_info;
83         struct drm_sman_mm *mm;
84         struct drm_sman *sman;
85 };
86
87 struct drm_sman {
88         struct drm_sman_mm *mm;
89         int num_managers;
90         struct drm_open_hash owner_hash_tab;
91         struct drm_open_hash user_hash_tab;
92         struct list_head owner_items;
93 };
94
95 /*
96  * Take down a memory manager. This function should only be called after a
97  * successful init and after a call to drm_sman_cleanup.
98  */
99
100 extern void drm_sman_takedown(struct drm_sman * sman);
101
102 /*
103  * Allocate structures for a manager.
104  * num_managers are the number of memory pools to manage. (VRAM, AGP, ....)
105  * user_order is the log2 of the number of buckets in the user hash table.
106  *          set this to approximately log2 of the max number of memory regions
107  *          that will be allocated for _all_ pools together.
108  * owner_order is the log2 of the number of buckets in the owner hash table.
109  *          set this to approximately log2 of
110  *          the number of client file connections that will
111  *          be using the manager.
112  *
113  */
114
115 extern int drm_sman_init(struct drm_sman * sman, unsigned int num_managers,
116                          unsigned int user_order, unsigned int owner_order);
117
118 /*
119  * Initialize a drm_mm.c allocator. Should be called only once for each
120  * manager unless a customized allogator is used.
121  */
122
123 extern int drm_sman_set_range(struct drm_sman * sman, unsigned int manager,
124                               unsigned long start, unsigned long size);
125
126 /*
127  * Initialize a customized allocator for one of the managers.
128  * (See the SiS module). The object pointed to by "allocator" is copied,
129  * so it can be destroyed after this call.
130  */
131
132 extern int drm_sman_set_manager(struct drm_sman * sman, unsigned int mananger,
133                                 struct drm_sman_mm * allocator);
134
135 /*
136  * Allocate a memory block. Aligment is not implemented yet.
137  */
138
139 extern struct drm_memblock_item *drm_sman_alloc(struct drm_sman * sman,
140                                                 unsigned int manager,
141                                                 unsigned long size,
142                                                 unsigned alignment,
143                                                 unsigned long owner);
144 /*
145  * Free a memory block identified by its user hash key.
146  */
147
148 extern int drm_sman_free_key(struct drm_sman * sman, unsigned int key);
149
150 /*
151  * returns 1 iff there are no stale memory blocks associated with this owner.
152  * Typically called to determine if we need to idle the hardware and call
153  * drm_sman_owner_cleanup. If there are no stale memory blocks, it removes all
154  * resources associated with owner.
155  */
156
157 extern int drm_sman_owner_clean(struct drm_sman * sman, unsigned long owner);
158
159 /*
160  * Frees all stale memory blocks associated with this owner. Note that this
161  * requires that the hardware is finished with all blocks, so the graphics engine
162  * should be idled before this call is made. This function also frees
163  * any resources associated with "owner" and should be called when owner
164  * is not going to be referenced anymore.
165  */
166
167 extern void drm_sman_owner_cleanup(struct drm_sman * sman, unsigned long owner);
168
169 /*
170  * Frees all stale memory blocks associated with the memory manager.
171  * See idling above.
172  */
173
174 extern void drm_sman_cleanup(struct drm_sman * sman);
175
176 #endif