3 * /proc support for DRM
5 * \author Rickard E. (Rik) Faith <faith@valinux.com>
6 * \author Gareth Hughes <gareth@valinux.com>
8 * \par Acknowledgements:
9 * Matthew J Sottek <matthew.j.sottek@intel.com> sent in a patch to fix
10 * the problem with the proc files not outputting all their information.
14 * Created: Mon Jan 11 09:48:47 1999 by faith@valinux.com
16 * Copyright 1999 Precision Insight, Inc., Cedar Park, Texas.
17 * Copyright 2000 VA Linux Systems, Inc., Sunnyvale, California.
18 * All Rights Reserved.
20 * Permission is hereby granted, free of charge, to any person obtaining a
21 * copy of this software and associated documentation files (the "Software"),
22 * to deal in the Software without restriction, including without limitation
23 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
24 * and/or sell copies of the Software, and to permit persons to whom the
25 * Software is furnished to do so, subject to the following conditions:
27 * The above copyright notice and this permission notice (including the next
28 * paragraph) shall be included in all copies or substantial portions of the
31 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
32 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
33 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
34 * VA LINUX SYSTEMS AND/OR ITS SUPPLIERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
35 * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
36 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
37 * OTHER DEALINGS IN THE SOFTWARE.
42 static int drm_name_info(char *buf
, char **start
, off_t offset
,
43 int request
, int *eof
, void *data
);
44 static int drm_vm_info(char *buf
, char **start
, off_t offset
,
45 int request
, int *eof
, void *data
);
46 static int drm_clients_info(char *buf
, char **start
, off_t offset
,
47 int request
, int *eof
, void *data
);
48 static int drm_queues_info(char *buf
, char **start
, off_t offset
,
49 int request
, int *eof
, void *data
);
50 static int drm_bufs_info(char *buf
, char **start
, off_t offset
,
51 int request
, int *eof
, void *data
);
52 static int drm_gem_name_info(char *buf
, char **start
, off_t offset
,
53 int request
, int *eof
, void *data
);
54 static int drm_gem_object_info(char *buf
, char **start
, off_t offset
,
55 int request
, int *eof
, void *data
);
57 static int drm_vma_info(char *buf
, char **start
, off_t offset
,
58 int request
, int *eof
, void *data
);
64 static struct drm_proc_list
{
65 const char *name
; /**< file name */
66 int (*f
) (char *, char **, off_t
, int, int *, void *); /**< proc callback*/
67 u32 driver_features
; /**< Required driver features for this entry */
69 {"name", drm_name_info
, 0},
70 {"mem", drm_mem_info
, 0},
71 {"vm", drm_vm_info
, 0},
72 {"clients", drm_clients_info
, 0},
73 {"queues", drm_queues_info
, 0},
74 {"bufs", drm_bufs_info
, 0},
75 {"gem_names", drm_gem_name_info
, DRIVER_GEM
},
76 {"gem_objects", drm_gem_object_info
, DRIVER_GEM
},
78 {"vma", drm_vma_info
},
82 #define DRM_PROC_ENTRIES ARRAY_SIZE(drm_proc_list)
85 * Initialize the DRI proc filesystem for a device.
87 * \param dev DRM device.
88 * \param minor device minor number.
89 * \param root DRI proc dir entry.
90 * \param dev_root resulting DRI device proc dir entry.
91 * \return root entry pointer on success, or NULL on failure.
93 * Create the DRI proc root entry "/proc/dri", the device proc root entry
94 * "/proc/dri/%minor%/", and each entry in proc_list as
95 * "/proc/dri/%minor%/%name%".
97 int drm_proc_init(struct drm_minor
*minor
, int minor_id
,
98 struct proc_dir_entry
*root
)
100 struct drm_device
*dev
= minor
->dev
;
101 struct proc_dir_entry
*ent
;
105 sprintf(name
, "%d", minor_id
);
106 minor
->dev_root
= proc_mkdir(name
, root
);
107 if (!minor
->dev_root
) {
108 DRM_ERROR("Cannot create /proc/dri/%s\n", name
);
112 for (i
= 0; i
< DRM_PROC_ENTRIES
; i
++) {
113 u32 features
= drm_proc_list
[i
].driver_features
;
116 (dev
->driver
->driver_features
& features
) != features
)
119 ent
= create_proc_entry(drm_proc_list
[i
].name
,
120 S_IFREG
| S_IRUGO
, minor
->dev_root
);
122 DRM_ERROR("Cannot create /proc/dri/%s/%s\n",
123 name
, drm_proc_list
[i
].name
);
127 ent
->read_proc
= drm_proc_list
[i
].f
;
131 if (dev
->driver
->proc_init
) {
132 ret
= dev
->driver
->proc_init(minor
);
134 DRM_ERROR("DRM: Driver failed to initialize "
143 for (j
= 0; j
< i
; j
++)
144 remove_proc_entry(drm_proc_list
[i
].name
,
146 remove_proc_entry(name
, root
);
147 minor
->dev_root
= NULL
;
152 * Cleanup the proc filesystem resources.
154 * \param minor device minor number.
155 * \param root DRI proc dir entry.
156 * \param dev_root DRI device proc dir entry.
157 * \return always zero.
159 * Remove all proc entries created by proc_init().
161 int drm_proc_cleanup(struct drm_minor
*minor
, struct proc_dir_entry
*root
)
163 struct drm_device
*dev
= minor
->dev
;
167 if (!root
|| !minor
->dev_root
)
170 if (dev
->driver
->proc_cleanup
)
171 dev
->driver
->proc_cleanup(minor
);
173 for (i
= 0; i
< DRM_PROC_ENTRIES
; i
++)
174 remove_proc_entry(drm_proc_list
[i
].name
, minor
->dev_root
);
175 sprintf(name
, "%d", minor
->index
);
176 remove_proc_entry(name
, root
);
182 * Called when "/proc/dri/.../name" is read.
184 * \param buf output buffer.
185 * \param start start of output data.
186 * \param offset requested start offset.
187 * \param request requested number of bytes.
188 * \param eof whether there is no more data to return.
189 * \param data private data.
190 * \return number of written bytes.
192 * Prints the device name together with the bus id if available.
194 static int drm_name_info(char *buf
, char **start
, off_t offset
, int request
,
195 int *eof
, void *data
)
197 struct drm_minor
*minor
= (struct drm_minor
*) data
;
198 struct drm_device
*dev
= minor
->dev
;
201 if (offset
> DRM_PROC_LIMIT
) {
206 *start
= &buf
[offset
];
210 DRM_PROC_PRINT("%s %s %s\n",
211 dev
->driver
->pci_driver
.name
,
212 pci_name(dev
->pdev
), dev
->unique
);
214 DRM_PROC_PRINT("%s %s\n", dev
->driver
->pci_driver
.name
,
215 pci_name(dev
->pdev
));
218 if (len
> request
+ offset
)
225 * Called when "/proc/dri/.../vm" is read.
227 * \param buf output buffer.
228 * \param start start of output data.
229 * \param offset requested start offset.
230 * \param request requested number of bytes.
231 * \param eof whether there is no more data to return.
232 * \param data private data.
233 * \return number of written bytes.
235 * Prints information about all mappings in drm_device::maplist.
237 static int drm__vm_info(char *buf
, char **start
, off_t offset
, int request
,
238 int *eof
, void *data
)
240 struct drm_minor
*minor
= (struct drm_minor
*) data
;
241 struct drm_device
*dev
= minor
->dev
;
244 struct drm_map_list
*r_list
;
246 /* Hardcoded from _DRM_FRAME_BUFFER,
247 _DRM_REGISTERS, _DRM_SHM, _DRM_AGP, and
248 _DRM_SCATTER_GATHER and _DRM_CONSISTENT */
249 const char *types
[] = { "FB", "REG", "SHM", "AGP", "SG", "PCI" };
253 if (offset
> DRM_PROC_LIMIT
) {
258 *start
= &buf
[offset
];
261 DRM_PROC_PRINT("slot offset size type flags "
264 list_for_each_entry(r_list
, &dev
->maplist
, head
) {
268 if (map
->type
< 0 || map
->type
> 5)
271 type
= types
[map
->type
];
272 DRM_PROC_PRINT("%4d 0x%08lx 0x%08lx %4.4s 0x%02x 0x%08lx ",
275 map
->size
, type
, map
->flags
,
276 (unsigned long) r_list
->user_token
);
278 DRM_PROC_PRINT("none\n");
280 DRM_PROC_PRINT("%4d\n", map
->mtrr
);
285 if (len
> request
+ offset
)
292 * Simply calls _vm_info() while holding the drm_device::struct_mutex lock.
294 static int drm_vm_info(char *buf
, char **start
, off_t offset
, int request
,
295 int *eof
, void *data
)
297 struct drm_minor
*minor
= (struct drm_minor
*) data
;
298 struct drm_device
*dev
= minor
->dev
;
301 mutex_lock(&dev
->struct_mutex
);
302 ret
= drm__vm_info(buf
, start
, offset
, request
, eof
, data
);
303 mutex_unlock(&dev
->struct_mutex
);
308 * Called when "/proc/dri/.../queues" is read.
310 * \param buf output buffer.
311 * \param start start of output data.
312 * \param offset requested start offset.
313 * \param request requested number of bytes.
314 * \param eof whether there is no more data to return.
315 * \param data private data.
316 * \return number of written bytes.
318 static int drm__queues_info(char *buf
, char **start
, off_t offset
,
319 int request
, int *eof
, void *data
)
321 struct drm_minor
*minor
= (struct drm_minor
*) data
;
322 struct drm_device
*dev
= minor
->dev
;
327 if (offset
> DRM_PROC_LIMIT
) {
332 *start
= &buf
[offset
];
335 DRM_PROC_PRINT(" ctx/flags use fin"
336 " blk/rw/rwf wait flushed queued"
338 for (i
= 0; i
< dev
->queue_count
; i
++) {
339 q
= dev
->queuelist
[i
];
340 atomic_inc(&q
->use_count
);
341 DRM_PROC_PRINT_RET(atomic_dec(&q
->use_count
),
343 " %5d/%c%c/%c%c%c %5Zd\n",
346 atomic_read(&q
->use_count
),
347 atomic_read(&q
->finalization
),
348 atomic_read(&q
->block_count
),
349 atomic_read(&q
->block_read
) ? 'r' : '-',
350 atomic_read(&q
->block_write
) ? 'w' : '-',
351 waitqueue_active(&q
->read_queue
) ? 'r' : '-',
352 waitqueue_active(&q
->
353 write_queue
) ? 'w' : '-',
354 waitqueue_active(&q
->
355 flush_queue
) ? 'f' : '-',
356 DRM_BUFCOUNT(&q
->waitlist
));
357 atomic_dec(&q
->use_count
);
360 if (len
> request
+ offset
)
367 * Simply calls _queues_info() while holding the drm_device::struct_mutex lock.
369 static int drm_queues_info(char *buf
, char **start
, off_t offset
, int request
,
370 int *eof
, void *data
)
372 struct drm_minor
*minor
= (struct drm_minor
*) data
;
373 struct drm_device
*dev
= minor
->dev
;
376 mutex_lock(&dev
->struct_mutex
);
377 ret
= drm__queues_info(buf
, start
, offset
, request
, eof
, data
);
378 mutex_unlock(&dev
->struct_mutex
);
383 * Called when "/proc/dri/.../bufs" is read.
385 * \param buf output buffer.
386 * \param start start of output data.
387 * \param offset requested start offset.
388 * \param request requested number of bytes.
389 * \param eof whether there is no more data to return.
390 * \param data private data.
391 * \return number of written bytes.
393 static int drm__bufs_info(char *buf
, char **start
, off_t offset
, int request
,
394 int *eof
, void *data
)
396 struct drm_minor
*minor
= (struct drm_minor
*) data
;
397 struct drm_device
*dev
= minor
->dev
;
399 struct drm_device_dma
*dma
= dev
->dma
;
402 if (!dma
|| offset
> DRM_PROC_LIMIT
) {
407 *start
= &buf
[offset
];
410 DRM_PROC_PRINT(" o size count free segs pages kB\n\n");
411 for (i
= 0; i
<= DRM_MAX_ORDER
; i
++) {
412 if (dma
->bufs
[i
].buf_count
)
413 DRM_PROC_PRINT("%2d %8d %5d %5d %5d %5d %5ld\n",
415 dma
->bufs
[i
].buf_size
,
416 dma
->bufs
[i
].buf_count
,
417 atomic_read(&dma
->bufs
[i
]
419 dma
->bufs
[i
].seg_count
,
420 dma
->bufs
[i
].seg_count
421 * (1 << dma
->bufs
[i
].page_order
),
422 (dma
->bufs
[i
].seg_count
423 * (1 << dma
->bufs
[i
].page_order
))
426 DRM_PROC_PRINT("\n");
427 for (i
= 0; i
< dma
->buf_count
; i
++) {
429 DRM_PROC_PRINT("\n");
430 DRM_PROC_PRINT(" %d", dma
->buflist
[i
]->list
);
432 DRM_PROC_PRINT("\n");
434 if (len
> request
+ offset
)
441 * Simply calls _bufs_info() while holding the drm_device::struct_mutex lock.
443 static int drm_bufs_info(char *buf
, char **start
, off_t offset
, int request
,
444 int *eof
, void *data
)
446 struct drm_minor
*minor
= (struct drm_minor
*) data
;
447 struct drm_device
*dev
= minor
->dev
;
450 mutex_lock(&dev
->struct_mutex
);
451 ret
= drm__bufs_info(buf
, start
, offset
, request
, eof
, data
);
452 mutex_unlock(&dev
->struct_mutex
);
457 * Called when "/proc/dri/.../clients" is read.
459 * \param buf output buffer.
460 * \param start start of output data.
461 * \param offset requested start offset.
462 * \param request requested number of bytes.
463 * \param eof whether there is no more data to return.
464 * \param data private data.
465 * \return number of written bytes.
467 static int drm__clients_info(char *buf
, char **start
, off_t offset
,
468 int request
, int *eof
, void *data
)
470 struct drm_minor
*minor
= (struct drm_minor
*) data
;
471 struct drm_device
*dev
= minor
->dev
;
473 struct drm_file
*priv
;
475 if (offset
> DRM_PROC_LIMIT
) {
480 *start
= &buf
[offset
];
483 DRM_PROC_PRINT("a dev pid uid magic ioctls\n\n");
484 list_for_each_entry(priv
, &dev
->filelist
, lhead
) {
485 DRM_PROC_PRINT("%c %3d %5d %5d %10u %10lu\n",
486 priv
->authenticated
? 'y' : 'n',
489 priv
->uid
, priv
->magic
, priv
->ioctl_count
);
492 if (len
> request
+ offset
)
499 * Simply calls _clients_info() while holding the drm_device::struct_mutex lock.
501 static int drm_clients_info(char *buf
, char **start
, off_t offset
,
502 int request
, int *eof
, void *data
)
504 struct drm_minor
*minor
= (struct drm_minor
*) data
;
505 struct drm_device
*dev
= minor
->dev
;
508 mutex_lock(&dev
->struct_mutex
);
509 ret
= drm__clients_info(buf
, start
, offset
, request
, eof
, data
);
510 mutex_unlock(&dev
->struct_mutex
);
514 struct drm_gem_name_info_data
{
520 static int drm_gem_one_name_info(int id
, void *ptr
, void *data
)
522 struct drm_gem_object
*obj
= ptr
;
523 struct drm_gem_name_info_data
*nid
= data
;
525 DRM_INFO("name %d size %zd\n", obj
->name
, obj
->size
);
529 nid
->len
+= sprintf(&nid
->buf
[nid
->len
],
530 "%6d %8zd %7d %8d\n",
531 obj
->name
, obj
->size
,
532 atomic_read(&obj
->handlecount
.refcount
),
533 atomic_read(&obj
->refcount
.refcount
));
534 if (nid
->len
> DRM_PROC_LIMIT
) {
541 static int drm_gem_name_info(char *buf
, char **start
, off_t offset
,
542 int request
, int *eof
, void *data
)
544 struct drm_minor
*minor
= (struct drm_minor
*) data
;
545 struct drm_device
*dev
= minor
->dev
;
546 struct drm_gem_name_info_data nid
;
548 if (offset
> DRM_PROC_LIMIT
) {
553 nid
.len
= sprintf(buf
, " name size handles refcount\n");
556 idr_for_each(&dev
->object_name_idr
, drm_gem_one_name_info
, &nid
);
558 *start
= &buf
[offset
];
560 if (nid
.len
> request
+ offset
)
563 return nid
.len
- offset
;
566 static int drm_gem_object_info(char *buf
, char **start
, off_t offset
,
567 int request
, int *eof
, void *data
)
569 struct drm_minor
*minor
= (struct drm_minor
*) data
;
570 struct drm_device
*dev
= minor
->dev
;
573 if (offset
> DRM_PROC_LIMIT
) {
578 *start
= &buf
[offset
];
580 DRM_PROC_PRINT("%d objects\n", atomic_read(&dev
->object_count
));
581 DRM_PROC_PRINT("%d object bytes\n", atomic_read(&dev
->object_memory
));
582 DRM_PROC_PRINT("%d pinned\n", atomic_read(&dev
->pin_count
));
583 DRM_PROC_PRINT("%d pin bytes\n", atomic_read(&dev
->pin_memory
));
584 DRM_PROC_PRINT("%d gtt bytes\n", atomic_read(&dev
->gtt_memory
));
585 DRM_PROC_PRINT("%d gtt total\n", dev
->gtt_total
);
586 if (len
> request
+ offset
)
594 static int drm__vma_info(char *buf
, char **start
, off_t offset
, int request
,
595 int *eof
, void *data
)
597 struct drm_minor
*minor
= (struct drm_minor
*) data
;
598 struct drm_device
*dev
= minor
->dev
;
600 struct drm_vma_entry
*pt
;
601 struct vm_area_struct
*vma
;
602 #if defined(__i386__)
606 if (offset
> DRM_PROC_LIMIT
) {
611 *start
= &buf
[offset
];
614 DRM_PROC_PRINT("vma use count: %d, high_memory = %p, 0x%08lx\n",
615 atomic_read(&dev
->vma_count
),
616 high_memory
, virt_to_phys(high_memory
));
617 list_for_each_entry(pt
, &dev
->vmalist
, head
) {
618 if (!(vma
= pt
->vma
))
620 DRM_PROC_PRINT("\n%5d 0x%08lx-0x%08lx %c%c%c%c%c%c 0x%08lx000",
624 vma
->vm_flags
& VM_READ
? 'r' : '-',
625 vma
->vm_flags
& VM_WRITE
? 'w' : '-',
626 vma
->vm_flags
& VM_EXEC
? 'x' : '-',
627 vma
->vm_flags
& VM_MAYSHARE
? 's' : 'p',
628 vma
->vm_flags
& VM_LOCKED
? 'l' : '-',
629 vma
->vm_flags
& VM_IO
? 'i' : '-',
632 #if defined(__i386__)
633 pgprot
= pgprot_val(vma
->vm_page_prot
);
634 DRM_PROC_PRINT(" %c%c%c%c%c%c%c%c%c",
635 pgprot
& _PAGE_PRESENT
? 'p' : '-',
636 pgprot
& _PAGE_RW
? 'w' : 'r',
637 pgprot
& _PAGE_USER
? 'u' : 's',
638 pgprot
& _PAGE_PWT
? 't' : 'b',
639 pgprot
& _PAGE_PCD
? 'u' : 'c',
640 pgprot
& _PAGE_ACCESSED
? 'a' : '-',
641 pgprot
& _PAGE_DIRTY
? 'd' : '-',
642 pgprot
& _PAGE_PSE
? 'm' : 'k',
643 pgprot
& _PAGE_GLOBAL
? 'g' : 'l');
645 DRM_PROC_PRINT("\n");
648 if (len
> request
+ offset
)
654 static int drm_vma_info(char *buf
, char **start
, off_t offset
, int request
,
655 int *eof
, void *data
)
657 struct drm_minor
*minor
= (struct drm_minor
*) data
;
658 struct drm_device
*dev
= minor
->dev
;
661 mutex_lock(&dev
->struct_mutex
);
662 ret
= drm__vma_info(buf
, start
, offset
, request
, eof
, data
);
663 mutex_unlock(&dev
->struct_mutex
);