drivers/isdn/hardware/eicon/message.c fix 'and' typo in eicons' AddInfo()
[linux-2.6] / drivers / char / drm / drm_agpsupport.c
1 /**
2  * \file drm_agpsupport.c
3  * DRM support for AGP/GART backend
4  *
5  * \author Rickard E. (Rik) Faith <faith@valinux.com>
6  * \author Gareth Hughes <gareth@valinux.com>
7  */
8
9 /*
10  * Copyright 1999 Precision Insight, Inc., Cedar Park, Texas.
11  * Copyright 2000 VA Linux Systems, Inc., Sunnyvale, California.
12  * All Rights Reserved.
13  *
14  * Permission is hereby granted, free of charge, to any person obtaining a
15  * copy of this software and associated documentation files (the "Software"),
16  * to deal in the Software without restriction, including without limitation
17  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
18  * and/or sell copies of the Software, and to permit persons to whom the
19  * Software is furnished to do so, subject to the following conditions:
20  *
21  * The above copyright notice and this permission notice (including the next
22  * paragraph) shall be included in all copies or substantial portions of the
23  * Software.
24  *
25  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
26  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
27  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
28  * VA LINUX SYSTEMS AND/OR ITS SUPPLIERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
29  * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
30  * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
31  * OTHER DEALINGS IN THE SOFTWARE.
32  */
33
34 #include "drmP.h"
35 #include <linux/module.h>
36
37 #if __OS_HAS_AGP
38
39 /**
40  * Get AGP information.
41  *
42  * \param inode device inode.
43  * \param file_priv DRM file private.
44  * \param cmd command.
45  * \param arg pointer to a (output) drm_agp_info structure.
46  * \return zero on success or a negative number on failure.
47  *
48  * Verifies the AGP device has been initialized and acquired and fills in the
49  * drm_agp_info structure with the information in drm_agp_head::agp_info.
50  */
51 int drm_agp_info(struct drm_device *dev, struct drm_agp_info *info)
52 {
53         DRM_AGP_KERN *kern;
54
55         if (!dev->agp || !dev->agp->acquired)
56                 return -EINVAL;
57
58         kern = &dev->agp->agp_info;
59         info->agp_version_major = kern->version.major;
60         info->agp_version_minor = kern->version.minor;
61         info->mode = kern->mode;
62         info->aperture_base = kern->aper_base;
63         info->aperture_size = kern->aper_size * 1024 * 1024;
64         info->memory_allowed = kern->max_memory << PAGE_SHIFT;
65         info->memory_used = kern->current_memory << PAGE_SHIFT;
66         info->id_vendor = kern->device->vendor;
67         info->id_device = kern->device->device;
68
69         return 0;
70 }
71
72 EXPORT_SYMBOL(drm_agp_info);
73
74 int drm_agp_info_ioctl(struct drm_device *dev, void *data,
75                        struct drm_file *file_priv)
76 {
77         struct drm_agp_info *info = data;
78         int err;
79
80         err = drm_agp_info(dev, info);
81         if (err)
82                 return err;
83
84         return 0;
85 }
86
87 /**
88  * Acquire the AGP device.
89  *
90  * \param dev DRM device that is to acquire AGP.
91  * \return zero on success or a negative number on failure.
92  *
93  * Verifies the AGP device hasn't been acquired before and calls
94  * \c agp_backend_acquire.
95  */
96 int drm_agp_acquire(struct drm_device * dev)
97 {
98         if (!dev->agp)
99                 return -ENODEV;
100         if (dev->agp->acquired)
101                 return -EBUSY;
102         if (!(dev->agp->bridge = agp_backend_acquire(dev->pdev)))
103                 return -ENODEV;
104         dev->agp->acquired = 1;
105         return 0;
106 }
107
108 EXPORT_SYMBOL(drm_agp_acquire);
109
110 /**
111  * Acquire the AGP device (ioctl).
112  *
113  * \param inode device inode.
114  * \param file_priv DRM file private.
115  * \param cmd command.
116  * \param arg user argument.
117  * \return zero on success or a negative number on failure.
118  *
119  * Verifies the AGP device hasn't been acquired before and calls
120  * \c agp_backend_acquire.
121  */
122 int drm_agp_acquire_ioctl(struct drm_device *dev, void *data,
123                           struct drm_file *file_priv)
124 {
125         return drm_agp_acquire((struct drm_device *) file_priv->head->dev);
126 }
127
128 /**
129  * Release the AGP device.
130  *
131  * \param dev DRM device that is to release AGP.
132  * \return zero on success or a negative number on failure.
133  *
134  * Verifies the AGP device has been acquired and calls \c agp_backend_release.
135  */
136 int drm_agp_release(struct drm_device * dev)
137 {
138         if (!dev->agp || !dev->agp->acquired)
139                 return -EINVAL;
140         agp_backend_release(dev->agp->bridge);
141         dev->agp->acquired = 0;
142         return 0;
143 }
144 EXPORT_SYMBOL(drm_agp_release);
145
146 int drm_agp_release_ioctl(struct drm_device *dev, void *data,
147                           struct drm_file *file_priv)
148 {
149         return drm_agp_release(dev);
150 }
151
152 /**
153  * Enable the AGP bus.
154  *
155  * \param dev DRM device that has previously acquired AGP.
156  * \param mode Requested AGP mode.
157  * \return zero on success or a negative number on failure.
158  *
159  * Verifies the AGP device has been acquired but not enabled, and calls
160  * \c agp_enable.
161  */
162 int drm_agp_enable(struct drm_device * dev, struct drm_agp_mode mode)
163 {
164         if (!dev->agp || !dev->agp->acquired)
165                 return -EINVAL;
166
167         dev->agp->mode = mode.mode;
168         agp_enable(dev->agp->bridge, mode.mode);
169         dev->agp->base = dev->agp->agp_info.aper_base;
170         dev->agp->enabled = 1;
171         return 0;
172 }
173
174 EXPORT_SYMBOL(drm_agp_enable);
175
176 int drm_agp_enable_ioctl(struct drm_device *dev, void *data,
177                          struct drm_file *file_priv)
178 {
179         struct drm_agp_mode *mode = data;
180
181         return drm_agp_enable(dev, *mode);
182 }
183
184 /**
185  * Allocate AGP memory.
186  *
187  * \param inode device inode.
188  * \param file_priv file private pointer.
189  * \param cmd command.
190  * \param arg pointer to a drm_agp_buffer structure.
191  * \return zero on success or a negative number on failure.
192  *
193  * Verifies the AGP device is present and has been acquired, allocates the
194  * memory via alloc_agp() and creates a drm_agp_mem entry for it.
195  */
196 int drm_agp_alloc(struct drm_device *dev, struct drm_agp_buffer *request)
197 {
198         struct drm_agp_mem *entry;
199         DRM_AGP_MEM *memory;
200         unsigned long pages;
201         u32 type;
202
203         if (!dev->agp || !dev->agp->acquired)
204                 return -EINVAL;
205         if (!(entry = drm_alloc(sizeof(*entry), DRM_MEM_AGPLISTS)))
206                 return -ENOMEM;
207
208         memset(entry, 0, sizeof(*entry));
209
210         pages = (request->size + PAGE_SIZE - 1) / PAGE_SIZE;
211         type = (u32) request->type;
212         if (!(memory = drm_alloc_agp(dev, pages, type))) {
213                 drm_free(entry, sizeof(*entry), DRM_MEM_AGPLISTS);
214                 return -ENOMEM;
215         }
216
217         entry->handle = (unsigned long)memory->key + 1;
218         entry->memory = memory;
219         entry->bound = 0;
220         entry->pages = pages;
221         list_add(&entry->head, &dev->agp->memory);
222
223         request->handle = entry->handle;
224         request->physical = memory->physical;
225
226         return 0;
227 }
228 EXPORT_SYMBOL(drm_agp_alloc);
229
230
231 int drm_agp_alloc_ioctl(struct drm_device *dev, void *data,
232                         struct drm_file *file_priv)
233 {
234         struct drm_agp_buffer *request = data;
235
236         return drm_agp_alloc(dev, request);
237 }
238
239 /**
240  * Search for the AGP memory entry associated with a handle.
241  *
242  * \param dev DRM device structure.
243  * \param handle AGP memory handle.
244  * \return pointer to the drm_agp_mem structure associated with \p handle.
245  *
246  * Walks through drm_agp_head::memory until finding a matching handle.
247  */
248 static struct drm_agp_mem *drm_agp_lookup_entry(struct drm_device * dev,
249                                            unsigned long handle)
250 {
251         struct drm_agp_mem *entry;
252
253         list_for_each_entry(entry, &dev->agp->memory, head) {
254                 if (entry->handle == handle)
255                         return entry;
256         }
257         return NULL;
258 }
259
260 /**
261  * Unbind AGP memory from the GATT (ioctl).
262  *
263  * \param inode device inode.
264  * \param file_priv DRM file private.
265  * \param cmd command.
266  * \param arg pointer to a drm_agp_binding structure.
267  * \return zero on success or a negative number on failure.
268  *
269  * Verifies the AGP device is present and acquired, looks-up the AGP memory
270  * entry and passes it to the unbind_agp() function.
271  */
272 int drm_agp_unbind(struct drm_device *dev, struct drm_agp_binding *request)
273 {
274         struct drm_agp_mem *entry;
275         int ret;
276
277         if (!dev->agp || !dev->agp->acquired)
278                 return -EINVAL;
279         if (!(entry = drm_agp_lookup_entry(dev, request->handle)))
280                 return -EINVAL;
281         if (!entry->bound)
282                 return -EINVAL;
283         ret = drm_unbind_agp(entry->memory);
284         if (ret == 0)
285                 entry->bound = 0;
286         return ret;
287 }
288 EXPORT_SYMBOL(drm_agp_unbind);
289
290
291 int drm_agp_unbind_ioctl(struct drm_device *dev, void *data,
292                          struct drm_file *file_priv)
293 {
294         struct drm_agp_binding *request = data;
295
296         return drm_agp_unbind(dev, request);
297 }
298
299 /**
300  * Bind AGP memory into the GATT (ioctl)
301  *
302  * \param inode device inode.
303  * \param file_priv DRM file private.
304  * \param cmd command.
305  * \param arg pointer to a drm_agp_binding structure.
306  * \return zero on success or a negative number on failure.
307  *
308  * Verifies the AGP device is present and has been acquired and that no memory
309  * is currently bound into the GATT. Looks-up the AGP memory entry and passes
310  * it to bind_agp() function.
311  */
312 int drm_agp_bind(struct drm_device *dev, struct drm_agp_binding *request)
313 {
314         struct drm_agp_mem *entry;
315         int retcode;
316         int page;
317
318         if (!dev->agp || !dev->agp->acquired)
319                 return -EINVAL;
320         if (!(entry = drm_agp_lookup_entry(dev, request->handle)))
321                 return -EINVAL;
322         if (entry->bound)
323                 return -EINVAL;
324         page = (request->offset + PAGE_SIZE - 1) / PAGE_SIZE;
325         if ((retcode = drm_bind_agp(entry->memory, page)))
326                 return retcode;
327         entry->bound = dev->agp->base + (page << PAGE_SHIFT);
328         DRM_DEBUG("base = 0x%lx entry->bound = 0x%lx\n",
329                   dev->agp->base, entry->bound);
330         return 0;
331 }
332 EXPORT_SYMBOL(drm_agp_bind);
333
334
335 int drm_agp_bind_ioctl(struct drm_device *dev, void *data,
336                        struct drm_file *file_priv)
337 {
338         struct drm_agp_binding *request = data;
339
340         return drm_agp_bind(dev, request);
341 }
342
343 /**
344  * Free AGP memory (ioctl).
345  *
346  * \param inode device inode.
347  * \param file_priv DRM file private.
348  * \param cmd command.
349  * \param arg pointer to a drm_agp_buffer structure.
350  * \return zero on success or a negative number on failure.
351  *
352  * Verifies the AGP device is present and has been acquired and looks up the
353  * AGP memory entry. If the memory it's currently bound, unbind it via
354  * unbind_agp(). Frees it via free_agp() as well as the entry itself
355  * and unlinks from the doubly linked list it's inserted in.
356  */
357 int drm_agp_free(struct drm_device *dev, struct drm_agp_buffer *request)
358 {
359         struct drm_agp_mem *entry;
360
361         if (!dev->agp || !dev->agp->acquired)
362                 return -EINVAL;
363         if (!(entry = drm_agp_lookup_entry(dev, request->handle)))
364                 return -EINVAL;
365         if (entry->bound)
366                 drm_unbind_agp(entry->memory);
367
368         list_del(&entry->head);
369
370         drm_free_agp(entry->memory, entry->pages);
371         drm_free(entry, sizeof(*entry), DRM_MEM_AGPLISTS);
372         return 0;
373 }
374 EXPORT_SYMBOL(drm_agp_free);
375
376
377
378 int drm_agp_free_ioctl(struct drm_device *dev, void *data,
379                        struct drm_file *file_priv)
380 {
381         struct drm_agp_buffer *request = data;
382
383         return drm_agp_free(dev, request);
384 }
385
386 /**
387  * Initialize the AGP resources.
388  *
389  * \return pointer to a drm_agp_head structure.
390  *
391  * Gets the drm_agp_t structure which is made available by the agpgart module
392  * via the inter_module_* functions. Creates and initializes a drm_agp_head
393  * structure.
394  */
395 struct drm_agp_head *drm_agp_init(struct drm_device *dev)
396 {
397         struct drm_agp_head *head = NULL;
398
399         if (!(head = drm_alloc(sizeof(*head), DRM_MEM_AGPLISTS)))
400                 return NULL;
401         memset((void *)head, 0, sizeof(*head));
402         head->bridge = agp_find_bridge(dev->pdev);
403         if (!head->bridge) {
404                 if (!(head->bridge = agp_backend_acquire(dev->pdev))) {
405                         drm_free(head, sizeof(*head), DRM_MEM_AGPLISTS);
406                         return NULL;
407                 }
408                 agp_copy_info(head->bridge, &head->agp_info);
409                 agp_backend_release(head->bridge);
410         } else {
411                 agp_copy_info(head->bridge, &head->agp_info);
412         }
413         if (head->agp_info.chipset == NOT_SUPPORTED) {
414                 drm_free(head, sizeof(*head), DRM_MEM_AGPLISTS);
415                 return NULL;
416         }
417         INIT_LIST_HEAD(&head->memory);
418         head->cant_use_aperture = head->agp_info.cant_use_aperture;
419         head->page_mask = head->agp_info.page_mask;
420
421         return head;
422 }
423
424 /** Calls agp_allocate_memory() */
425 DRM_AGP_MEM *drm_agp_allocate_memory(struct agp_bridge_data * bridge,
426                                      size_t pages, u32 type)
427 {
428         return agp_allocate_memory(bridge, pages, type);
429 }
430
431 /** Calls agp_free_memory() */
432 int drm_agp_free_memory(DRM_AGP_MEM * handle)
433 {
434         if (!handle)
435                 return 0;
436         agp_free_memory(handle);
437         return 1;
438 }
439
440 /** Calls agp_bind_memory() */
441 int drm_agp_bind_memory(DRM_AGP_MEM * handle, off_t start)
442 {
443         if (!handle)
444                 return -EINVAL;
445         return agp_bind_memory(handle, start);
446 }
447
448 /** Calls agp_unbind_memory() */
449 int drm_agp_unbind_memory(DRM_AGP_MEM * handle)
450 {
451         if (!handle)
452                 return -EINVAL;
453         return agp_unbind_memory(handle);
454 }
455
456 #endif                          /* __OS_HAS_AGP */