1/** 2 * \file drm_proc.c 3 * /proc support for DRM 4 * 5 * \author Rickard E. (Rik) Faith <faith@valinux.com> 6 * \author Gareth Hughes <gareth@valinux.com> 7 * 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. 11 */ 12 13/* 14 * Created: Mon Jan 11 09:48:47 1999 by faith@valinux.com 15 * 16 * Copyright 1999 Precision Insight, Inc., Cedar Park, Texas. 17 * Copyright 2000 VA Linux Systems, Inc., Sunnyvale, California. 18 * All Rights Reserved. 19 * 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: 26 * 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 29 * Software. 30 * 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. 38 */ 39 40#include <linux/seq_file.h> 41#include <linux/slab.h> 42#include "drmP.h" 43 44/*************************************************** 45 * Initialization, etc. 46 **************************************************/ 47 48/** 49 * Proc file list. 50 */ 51static struct drm_info_list drm_proc_list[] = { 52 {"name", drm_name_info, 0}, 53 {"vm", drm_vm_info, 0}, 54 {"clients", drm_clients_info, 0}, 55 {"queues", drm_queues_info, 0}, 56 {"bufs", drm_bufs_info, 0}, 57 {"gem_names", drm_gem_name_info, DRIVER_GEM}, 58 {"gem_objects", drm_gem_object_info, DRIVER_GEM}, 59#if DRM_DEBUG_CODE 60 {"vma", drm_vma_info, 0}, 61#endif 62}; 63#define DRM_PROC_ENTRIES ARRAY_SIZE(drm_proc_list) 64 65static int drm_proc_open(struct inode *inode, struct file *file) 66{ 67 struct drm_info_node* node = PDE(inode)->data; 68 69 return single_open(file, node->info_ent->show, node); 70} 71 72static const struct file_operations drm_proc_fops = { 73 .owner = THIS_MODULE, 74 .open = drm_proc_open, 75 .read = seq_read, 76 .llseek = seq_lseek, 77 .release = single_release, 78}; 79 80 81/** 82 * Initialize a given set of proc files for a device 83 * 84 * \param files The array of files to create 85 * \param count The number of files given 86 * \param root DRI proc dir entry. 87 * \param minor device minor number 88 * \return Zero on success, non-zero on failure 89 * 90 * Create a given set of proc files represented by an array of 91 * gdm_proc_lists in the given root directory. 92 */ 93int drm_proc_create_files(struct drm_info_list *files, int count, 94 struct proc_dir_entry *root, struct drm_minor *minor) 95{ 96 struct drm_device *dev = minor->dev; 97 struct proc_dir_entry *ent; 98 struct drm_info_node *tmp; 99 char name[64]; 100 int i, ret; 101 102 for (i = 0; i < count; i++) { 103 u32 features = files[i].driver_features; 104 105 if (features != 0 && 106 (dev->driver->driver_features & features) != features) 107 continue; 108 109 tmp = kmalloc(sizeof(struct drm_info_node), GFP_KERNEL); 110 if (tmp == NULL) { 111 ret = -1; 112 goto fail; 113 } 114 tmp->minor = minor; 115 tmp->info_ent = &files[i]; 116 list_add(&tmp->list, &minor->proc_nodes.list); 117 118 ent = proc_create_data(files[i].name, S_IRUGO, root, 119 &drm_proc_fops, tmp); 120 if (!ent) { 121 DRM_ERROR("Cannot create /proc/dri/%s/%s\n", 122 name, files[i].name); 123 list_del(&tmp->list); 124 kfree(tmp); 125 ret = -1; 126 goto fail; 127 } 128 129 } 130 return 0; 131 132fail: 133 for (i = 0; i < count; i++) 134 remove_proc_entry(drm_proc_list[i].name, minor->proc_root); 135 return ret; 136} 137 138/** 139 * Initialize the DRI proc filesystem for a device 140 * 141 * \param dev DRM device 142 * \param minor device minor number 143 * \param root DRI proc dir entry. 144 * \param dev_root resulting DRI device proc dir entry. 145 * \return root entry pointer on success, or NULL on failure. 146 * 147 * Create the DRI proc root entry "/proc/dri", the device proc root entry 148 * "/proc/dri/%minor%/", and each entry in proc_list as 149 * "/proc/dri/%minor%/%name%". 150 */ 151int drm_proc_init(struct drm_minor *minor, int minor_id, 152 struct proc_dir_entry *root) 153{ 154 struct drm_device *dev = minor->dev; 155 char name[64]; 156 int ret; 157 158 INIT_LIST_HEAD(&minor->proc_nodes.list); 159 sprintf(name, "%d", minor_id); 160 minor->proc_root = proc_mkdir(name, root); 161 if (!minor->proc_root) { 162 DRM_ERROR("Cannot create /proc/dri/%s\n", name); 163 return -1; 164 } 165 166 ret = drm_proc_create_files(drm_proc_list, DRM_PROC_ENTRIES, 167 minor->proc_root, minor); 168 if (ret) { 169 remove_proc_entry(name, root); 170 minor->proc_root = NULL; 171 DRM_ERROR("Failed to create core drm proc files\n"); 172 return ret; 173 } 174 175 if (dev->driver->proc_init) { 176 ret = dev->driver->proc_init(minor); 177 if (ret) { 178 DRM_ERROR("DRM: Driver failed to initialize " 179 "/proc/dri.\n"); 180 return ret; 181 } 182 } 183 return 0; 184} 185 186int drm_proc_remove_files(struct drm_info_list *files, int count, 187 struct drm_minor *minor) 188{ 189 struct list_head *pos, *q; 190 struct drm_info_node *tmp; 191 int i; 192 193 for (i = 0; i < count; i++) { 194 list_for_each_safe(pos, q, &minor->proc_nodes.list) { 195 tmp = list_entry(pos, struct drm_info_node, list); 196 if (tmp->info_ent == &files[i]) { 197 remove_proc_entry(files[i].name, 198 minor->proc_root); 199 list_del(pos); 200 kfree(tmp); 201 } 202 } 203 } 204 return 0; 205} 206 207/** 208 * Cleanup the proc filesystem resources. 209 * 210 * \param minor device minor number. 211 * \param root DRI proc dir entry. 212 * \param dev_root DRI device proc dir entry. 213 * \return always zero. 214 * 215 * Remove all proc entries created by proc_init(). 216 */ 217int drm_proc_cleanup(struct drm_minor *minor, struct proc_dir_entry *root) 218{ 219 struct drm_device *dev = minor->dev; 220 char name[64]; 221 222 if (!root || !minor->proc_root) 223 return 0; 224 225 if (dev->driver->proc_cleanup) 226 dev->driver->proc_cleanup(minor); 227 228 drm_proc_remove_files(drm_proc_list, DRM_PROC_ENTRIES, minor); 229 230 sprintf(name, "%d", minor->index); 231 remove_proc_entry(name, root); 232 233 return 0; 234} 235