Linux kernel & device driver programming

Cross-Referenced Linux and Device Driver Code

[ source navigation ] [ diff markup ] [ identifier search ] [ freetext search ] [ file search ]
Version: [ 2.6.11.8 ] [ 2.6.25 ] [ 2.6.25.8 ] [ 2.6.31.13 ] Architecture: [ i386 ]
  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->enabled = 1;
170         return 0;
171 }
172 
173 EXPORT_SYMBOL(drm_agp_enable);
174 
175 int drm_agp_enable_ioctl(struct drm_device *dev, void *data,
176                          struct drm_file *file_priv)
177 {
178         struct drm_agp_mode *mode = data;
179 
180         return drm_agp_enable(dev, *mode);
181 }
182 
183 /**
184  * Allocate AGP memory.
185  *
186  * \param inode device inode.
187  * \param file_priv file private pointer.
188  * \param cmd command.
189  * \param arg pointer to a drm_agp_buffer structure.
190  * \return zero on success or a negative number on failure.
191  *
192  * Verifies the AGP device is present and has been acquired, allocates the
193  * memory via alloc_agp() and creates a drm_agp_mem entry for it.
194  */
195 int drm_agp_alloc(struct drm_device *dev, struct drm_agp_buffer *request)
196 {
197         struct drm_agp_mem *entry;
198         DRM_AGP_MEM *memory;
199         unsigned long pages;
200         u32 type;
201 
202         if (!dev->agp || !dev->agp->acquired)
203                 return -EINVAL;
204         if (!(entry = drm_alloc(sizeof(*entry), DRM_MEM_AGPLISTS)))
205                 return -ENOMEM;
206 
207         memset(entry, 0, sizeof(*entry));
208 
209         pages = (request->size + PAGE_SIZE - 1) / PAGE_SIZE;
210         type = (u32) request->type;
211         if (!(memory = drm_alloc_agp(dev, pages, type))) {
212                 drm_free(entry, sizeof(*entry), DRM_MEM_AGPLISTS);
213                 return -ENOMEM;
214         }
215 
216         entry->handle = (unsigned long)memory->key + 1;
217         entry->memory = memory;
218         entry->bound = 0;
219         entry->pages = pages;
220         list_add(&entry->head, &dev->agp->memory);
221 
222         request->handle = entry->handle;
223         request->physical = memory->physical;
224 
225         return 0;
226 }
227 EXPORT_SYMBOL(drm_agp_alloc);
228 
229 
230 int drm_agp_alloc_ioctl(struct drm_device *dev, void *data,
231                         struct drm_file *file_priv)
232 {
233         struct drm_agp_buffer *request = data;
234 
235         return drm_agp_alloc(dev, request);
236 }
237 
238 /**
239  * Search for the AGP memory entry associated with a handle.
240  *
241  * \param dev DRM device structure.
242  * \param handle AGP memory handle.
243  * \return pointer to the drm_agp_mem structure associated with \p handle.
244  *
245  * Walks through drm_agp_head::memory until finding a matching handle.
246  */
247 static struct drm_agp_mem *drm_agp_lookup_entry(struct drm_device * dev,
248                                            unsigned long handle)
249 {
250         struct drm_agp_mem *entry;
251 
252         list_for_each_entry(entry, &dev->agp->memory, head) {
253                 if (entry->handle == handle)
254                         return entry;
255         }
256         return NULL;
257 }
258 
259 /**
260  * Unbind AGP memory from the GATT (ioctl).
261  *
262  * \param inode device inode.
263  * \param file_priv DRM file private.
264  * \param cmd command.
265  * \param arg pointer to a drm_agp_binding structure.
266  * \return zero on success or a negative number on failure.
267  *
268  * Verifies the AGP device is present and acquired, looks-up the AGP memory
269  * entry and passes it to the unbind_agp() function.
270  */
271 int drm_agp_unbind(struct drm_device *dev, struct drm_agp_binding *request)
272 {
273         struct drm_agp_mem *entry;
274         int ret;
275 
276         if (!dev->agp || !dev->agp->acquired)
277                 return -EINVAL;
278         if (!(entry = drm_agp_lookup_entry(dev, request->handle)))
279                 return -EINVAL;
280         if (!entry->bound)
281                 return -EINVAL;
282         ret = drm_unbind_agp(entry->memory);
283         if (ret == 0)
284                 entry->bound = 0;
285         return ret;
286 }
287 EXPORT_SYMBOL(drm_agp_unbind);
288 
289 
290 int drm_agp_unbind_ioctl(struct drm_device *dev, void *data,
291                          struct drm_file *file_priv)
292 {
293         struct drm_agp_binding *request = data;
294 
295         return drm_agp_unbind(dev, request);
296 }
297 
298 /**
299  * Bind AGP memory into the GATT (ioctl)
300  *
301  * \param inode device inode.
302  * \param file_priv DRM file private.
303  * \param cmd command.
304  * \param arg pointer to a drm_agp_binding structure.
305  * \return zero on success or a negative number on failure.
306  *
307  * Verifies the AGP device is present and has been acquired and that no memory
308  * is currently bound into the GATT. Looks-up the AGP memory entry and passes
309  * it to bind_agp() function.
310  */
311 int drm_agp_bind(struct drm_device *dev, struct drm_agp_binding *request)
312 {
313         struct drm_agp_mem *entry;
314         int retcode;
315         int page;
316 
317         if (!dev->agp || !dev->agp->acquired)
318                 return -EINVAL;
319         if (!(entry = drm_agp_lookup_entry(dev, request->handle)))
320                 return -EINVAL;
321         if (entry->bound)
322                 return -EINVAL;
323         page = (request->offset + PAGE_SIZE - 1) / PAGE_SIZE;
324         if ((retcode = drm_bind_agp(entry->memory, page)))
325                 return retcode;
326         entry->bound = dev->agp->base + (page << PAGE_SHIFT);
327         DRM_DEBUG("base = 0x%lx entry->bound = 0x%lx\n",
328                   dev->agp->base, entry->bound);
329         return 0;
330 }
331 EXPORT_SYMBOL(drm_agp_bind);
332 
333 
334 int drm_agp_bind_ioctl(struct drm_device *dev, void *data,
335                        struct drm_file *file_priv)
336 {
337         struct drm_agp_binding *request = data;
338 
339         return drm_agp_bind(dev, request);
340 }
341 
342 /**
343  * Free AGP memory (ioctl).
344  *
345  * \param inode device inode.
346  * \param file_priv DRM file private.
347  * \param cmd command.
348  * \param arg pointer to a drm_agp_buffer structure.
349  * \return zero on success or a negative number on failure.
350  *
351  * Verifies the AGP device is present and has been acquired and looks up the
352  * AGP memory entry. If the memory it's currently bound, unbind it via
353  * unbind_agp(). Frees it via free_agp() as well as the entry itself
354  * and unlinks from the doubly linked list it's inserted in.
355  */
356 int drm_agp_free(struct drm_device *dev, struct drm_agp_buffer *request)
357 {
358         struct drm_agp_mem *entry;
359 
360         if (!dev->agp || !dev->agp->acquired)
361                 return -EINVAL;
362         if (!(entry = drm_agp_lookup_entry(dev, request->handle)))
363                 return -EINVAL;
364         if (entry->bound)
365                 drm_unbind_agp(entry->memory);
366 
367         list_del(&entry->head);
368 
369         drm_free_agp(entry->memory, entry->pages);
370         drm_free(entry, sizeof(*entry), DRM_MEM_AGPLISTS);
371         return 0;
372 }
373 EXPORT_SYMBOL(drm_agp_free);
374 
375 
376 
377 int drm_agp_free_ioctl(struct drm_device *dev, void *data,
378                        struct drm_file *file_priv)
379 {
380         struct drm_agp_buffer *request = data;
381 
382         return drm_agp_free(dev, request);
383 }
384 
385 /**
386  * Initialize the AGP resources.
387  *
388  * \return pointer to a drm_agp_head structure.
389  *
390  * Gets the drm_agp_t structure which is made available by the agpgart module
391  * via the inter_module_* functions. Creates and initializes a drm_agp_head
392  * structure.
393  */
394 struct drm_agp_head *drm_agp_init(struct drm_device *dev)
395 {
396         struct drm_agp_head *head = NULL;
397 
398         if (!(head = drm_alloc(sizeof(*head), DRM_MEM_AGPLISTS)))
399                 return NULL;
400         memset((void *)head, 0, sizeof(*head));
401         head->bridge = agp_find_bridge(dev->pdev);
402         if (!head->bridge) {
403                 if (!(head->bridge = agp_backend_acquire(dev->pdev))) {
404                         drm_free(head, sizeof(*head), DRM_MEM_AGPLISTS);
405                         return NULL;
406                 }
407                 agp_copy_info(head->bridge, &head->agp_info);
408                 agp_backend_release(head->bridge);
409         } else {
410                 agp_copy_info(head->bridge, &head->agp_info);
411         }
412         if (head->agp_info.chipset == NOT_SUPPORTED) {
413                 drm_free(head, sizeof(*head), DRM_MEM_AGPLISTS);
414                 return NULL;
415         }
416         INIT_LIST_HEAD(&head->memory);
417         head->cant_use_aperture = head->agp_info.cant_use_aperture;
418         head->page_mask = head->agp_info.page_mask;
419         head->base = head->agp_info.aper_base;
420         return head;
421 }
422 
423 /** Calls agp_allocate_memory() */
424 DRM_AGP_MEM *drm_agp_allocate_memory(struct agp_bridge_data * bridge,
425                                      size_t pages, u32 type)
426 {
427         return agp_allocate_memory(bridge, pages, type);
428 }
429 
430 /** Calls agp_free_memory() */
431 int drm_agp_free_memory(DRM_AGP_MEM * handle)
432 {
433         if (!handle)
434                 return 0;
435         agp_free_memory(handle);
436         return 1;
437 }
438 
439 /** Calls agp_bind_memory() */
440 int drm_agp_bind_memory(DRM_AGP_MEM * handle, off_t start)
441 {
442         if (!handle)
443                 return -EINVAL;
444         return agp_bind_memory(handle, start);
445 }
446 
447 /** Calls agp_unbind_memory() */
448 int drm_agp_unbind_memory(DRM_AGP_MEM * handle)
449 {
450         if (!handle)
451                 return -EINVAL;
452         return agp_unbind_memory(handle);
453 }
454 
455 #endif                          /* __OS_HAS_AGP */
456 
  This page was automatically generated by the LXR engine.