drm_stub.c 15 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612
  1. /**
  2. * \file drm_stub.h
  3. * Stub support
  4. *
  5. * \author Rickard E. (Rik) Faith <faith@valinux.com>
  6. */
  7. /*
  8. * Created: Fri Jan 19 10:48:35 2001 by faith@acm.org
  9. *
  10. * Copyright 2001 VA Linux Systems, Inc., Sunnyvale, California.
  11. * All Rights Reserved.
  12. *
  13. * Permission is hereby granted, free of charge, to any person obtaining a
  14. * copy of this software and associated documentation files (the "Software"),
  15. * to deal in the Software without restriction, including without limitation
  16. * the rights to use, copy, modify, merge, publish, distribute, sublicense,
  17. * and/or sell copies of the Software, and to permit persons to whom the
  18. * Software is furnished to do so, subject to the following conditions:
  19. *
  20. * The above copyright notice and this permission notice (including the next
  21. * paragraph) shall be included in all copies or substantial portions of the
  22. * Software.
  23. *
  24. * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  25. * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  26. * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
  27. * PRECISION INSIGHT AND/OR ITS SUPPLIERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
  28. * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
  29. * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
  30. * DEALINGS IN THE SOFTWARE.
  31. */
  32. #include <linux/module.h>
  33. #include <linux/moduleparam.h>
  34. #include <linux/slab.h>
  35. #include <drm/drmP.h>
  36. #include <drm/drm_core.h>
  37. unsigned int drm_debug = 0; /* 1 to enable debug output */
  38. EXPORT_SYMBOL(drm_debug);
  39. unsigned int drm_rnodes = 0; /* 1 to enable experimental render nodes API */
  40. EXPORT_SYMBOL(drm_rnodes);
  41. unsigned int drm_vblank_offdelay = 5000; /* Default to 5000 msecs. */
  42. EXPORT_SYMBOL(drm_vblank_offdelay);
  43. unsigned int drm_timestamp_precision = 20; /* Default to 20 usecs. */
  44. EXPORT_SYMBOL(drm_timestamp_precision);
  45. /*
  46. * Default to use monotonic timestamps for wait-for-vblank and page-flip
  47. * complete events.
  48. */
  49. unsigned int drm_timestamp_monotonic = 1;
  50. MODULE_AUTHOR(CORE_AUTHOR);
  51. MODULE_DESCRIPTION(CORE_DESC);
  52. MODULE_LICENSE("GPL and additional rights");
  53. MODULE_PARM_DESC(debug, "Enable debug output");
  54. MODULE_PARM_DESC(rnodes, "Enable experimental render nodes API");
  55. MODULE_PARM_DESC(vblankoffdelay, "Delay until vblank irq auto-disable [msecs]");
  56. MODULE_PARM_DESC(timestamp_precision_usec, "Max. error on timestamps [usecs]");
  57. MODULE_PARM_DESC(timestamp_monotonic, "Use monotonic timestamps");
  58. module_param_named(debug, drm_debug, int, 0600);
  59. module_param_named(rnodes, drm_rnodes, int, 0600);
  60. module_param_named(vblankoffdelay, drm_vblank_offdelay, int, 0600);
  61. module_param_named(timestamp_precision_usec, drm_timestamp_precision, int, 0600);
  62. module_param_named(timestamp_monotonic, drm_timestamp_monotonic, int, 0600);
  63. struct idr drm_minors_idr;
  64. struct class *drm_class;
  65. struct dentry *drm_debugfs_root;
  66. int drm_err(const char *func, const char *format, ...)
  67. {
  68. struct va_format vaf;
  69. va_list args;
  70. int r;
  71. va_start(args, format);
  72. vaf.fmt = format;
  73. vaf.va = &args;
  74. r = printk(KERN_ERR "[" DRM_NAME ":%s] *ERROR* %pV", func, &vaf);
  75. va_end(args);
  76. return r;
  77. }
  78. EXPORT_SYMBOL(drm_err);
  79. void drm_ut_debug_printk(unsigned int request_level,
  80. const char *prefix,
  81. const char *function_name,
  82. const char *format, ...)
  83. {
  84. va_list args;
  85. if (drm_debug & request_level) {
  86. if (function_name)
  87. printk(KERN_DEBUG "[%s:%s], ", prefix, function_name);
  88. va_start(args, format);
  89. vprintk(format, args);
  90. va_end(args);
  91. }
  92. }
  93. EXPORT_SYMBOL(drm_ut_debug_printk);
  94. static int drm_minor_get_id(struct drm_device *dev, int type)
  95. {
  96. int ret;
  97. int base = 0, limit = 63;
  98. if (type == DRM_MINOR_CONTROL) {
  99. base += 64;
  100. limit = base + 63;
  101. } else if (type == DRM_MINOR_RENDER) {
  102. base += 128;
  103. limit = base + 63;
  104. }
  105. mutex_lock(&dev->struct_mutex);
  106. ret = idr_alloc(&drm_minors_idr, NULL, base, limit, GFP_KERNEL);
  107. mutex_unlock(&dev->struct_mutex);
  108. return ret == -ENOSPC ? -EINVAL : ret;
  109. }
  110. struct drm_master *drm_master_create(struct drm_minor *minor)
  111. {
  112. struct drm_master *master;
  113. master = kzalloc(sizeof(*master), GFP_KERNEL);
  114. if (!master)
  115. return NULL;
  116. kref_init(&master->refcount);
  117. spin_lock_init(&master->lock.spinlock);
  118. init_waitqueue_head(&master->lock.lock_queue);
  119. drm_ht_create(&master->magiclist, DRM_MAGIC_HASH_ORDER);
  120. INIT_LIST_HEAD(&master->magicfree);
  121. master->minor = minor;
  122. list_add_tail(&master->head, &minor->master_list);
  123. return master;
  124. }
  125. struct drm_master *drm_master_get(struct drm_master *master)
  126. {
  127. kref_get(&master->refcount);
  128. return master;
  129. }
  130. EXPORT_SYMBOL(drm_master_get);
  131. static void drm_master_destroy(struct kref *kref)
  132. {
  133. struct drm_master *master = container_of(kref, struct drm_master, refcount);
  134. struct drm_magic_entry *pt, *next;
  135. struct drm_device *dev = master->minor->dev;
  136. struct drm_map_list *r_list, *list_temp;
  137. list_del(&master->head);
  138. if (dev->driver->master_destroy)
  139. dev->driver->master_destroy(dev, master);
  140. list_for_each_entry_safe(r_list, list_temp, &dev->maplist, head) {
  141. if (r_list->master == master) {
  142. drm_rmmap_locked(dev, r_list->map);
  143. r_list = NULL;
  144. }
  145. }
  146. if (master->unique) {
  147. kfree(master->unique);
  148. master->unique = NULL;
  149. master->unique_len = 0;
  150. }
  151. kfree(dev->devname);
  152. dev->devname = NULL;
  153. list_for_each_entry_safe(pt, next, &master->magicfree, head) {
  154. list_del(&pt->head);
  155. drm_ht_remove_item(&master->magiclist, &pt->hash_item);
  156. kfree(pt);
  157. }
  158. drm_ht_remove(&master->magiclist);
  159. kfree(master);
  160. }
  161. void drm_master_put(struct drm_master **master)
  162. {
  163. kref_put(&(*master)->refcount, drm_master_destroy);
  164. *master = NULL;
  165. }
  166. EXPORT_SYMBOL(drm_master_put);
  167. int drm_setmaster_ioctl(struct drm_device *dev, void *data,
  168. struct drm_file *file_priv)
  169. {
  170. int ret = 0;
  171. if (file_priv->is_master)
  172. return 0;
  173. if (file_priv->minor->master && file_priv->minor->master != file_priv->master)
  174. return -EINVAL;
  175. if (!file_priv->master)
  176. return -EINVAL;
  177. if (file_priv->minor->master)
  178. return -EINVAL;
  179. mutex_lock(&dev->struct_mutex);
  180. file_priv->minor->master = drm_master_get(file_priv->master);
  181. file_priv->is_master = 1;
  182. if (dev->driver->master_set) {
  183. ret = dev->driver->master_set(dev, file_priv, false);
  184. if (unlikely(ret != 0)) {
  185. file_priv->is_master = 0;
  186. drm_master_put(&file_priv->minor->master);
  187. }
  188. }
  189. mutex_unlock(&dev->struct_mutex);
  190. return ret;
  191. }
  192. int drm_dropmaster_ioctl(struct drm_device *dev, void *data,
  193. struct drm_file *file_priv)
  194. {
  195. if (!file_priv->is_master)
  196. return -EINVAL;
  197. if (!file_priv->minor->master)
  198. return -EINVAL;
  199. mutex_lock(&dev->struct_mutex);
  200. if (dev->driver->master_drop)
  201. dev->driver->master_drop(dev, file_priv, false);
  202. drm_master_put(&file_priv->minor->master);
  203. file_priv->is_master = 0;
  204. mutex_unlock(&dev->struct_mutex);
  205. return 0;
  206. }
  207. /**
  208. * drm_get_minor - Allocate and register new DRM minor
  209. * @dev: DRM device
  210. * @minor: Pointer to where new minor is stored
  211. * @type: Type of minor
  212. *
  213. * Allocate a new minor of the given type and register it. A pointer to the new
  214. * minor is returned in @minor.
  215. * Caller must hold the global DRM mutex.
  216. *
  217. * RETURNS:
  218. * 0 on success, negative error code on failure.
  219. */
  220. static int drm_get_minor(struct drm_device *dev, struct drm_minor **minor,
  221. int type)
  222. {
  223. struct drm_minor *new_minor;
  224. int ret;
  225. int minor_id;
  226. DRM_DEBUG("\n");
  227. minor_id = drm_minor_get_id(dev, type);
  228. if (minor_id < 0)
  229. return minor_id;
  230. new_minor = kzalloc(sizeof(struct drm_minor), GFP_KERNEL);
  231. if (!new_minor) {
  232. ret = -ENOMEM;
  233. goto err_idr;
  234. }
  235. new_minor->type = type;
  236. new_minor->device = MKDEV(DRM_MAJOR, minor_id);
  237. new_minor->dev = dev;
  238. new_minor->index = minor_id;
  239. INIT_LIST_HEAD(&new_minor->master_list);
  240. idr_replace(&drm_minors_idr, new_minor, minor_id);
  241. #if defined(CONFIG_DEBUG_FS)
  242. ret = drm_debugfs_init(new_minor, minor_id, drm_debugfs_root);
  243. if (ret) {
  244. DRM_ERROR("DRM: Failed to initialize /sys/kernel/debug/dri.\n");
  245. goto err_mem;
  246. }
  247. #endif
  248. ret = drm_sysfs_device_add(new_minor);
  249. if (ret) {
  250. printk(KERN_ERR
  251. "DRM: Error sysfs_device_add.\n");
  252. goto err_debugfs;
  253. }
  254. *minor = new_minor;
  255. DRM_DEBUG("new minor assigned %d\n", minor_id);
  256. return 0;
  257. err_debugfs:
  258. #if defined(CONFIG_DEBUG_FS)
  259. drm_debugfs_cleanup(new_minor);
  260. err_mem:
  261. #endif
  262. kfree(new_minor);
  263. err_idr:
  264. idr_remove(&drm_minors_idr, minor_id);
  265. *minor = NULL;
  266. return ret;
  267. }
  268. /**
  269. * drm_unplug_minor - Unplug DRM minor
  270. * @minor: Minor to unplug
  271. *
  272. * Unplugs the given DRM minor but keeps the object. So after this returns,
  273. * minor->dev is still valid so existing open-files can still access it to get
  274. * device information from their drm_file ojects.
  275. * If the minor is already unplugged or if @minor is NULL, nothing is done.
  276. * The global DRM mutex must be held by the caller.
  277. */
  278. static void drm_unplug_minor(struct drm_minor *minor)
  279. {
  280. if (!minor || !device_is_registered(minor->kdev))
  281. return;
  282. #if defined(CONFIG_DEBUG_FS)
  283. drm_debugfs_cleanup(minor);
  284. #endif
  285. drm_sysfs_device_remove(minor);
  286. }
  287. /**
  288. * drm_put_minor - Destroy DRM minor
  289. * @minor: Minor to destroy
  290. *
  291. * This calls drm_unplug_minor() on the given minor and then frees it. Nothing
  292. * is done if @minor is NULL. It is fine to call this on already unplugged
  293. * minors.
  294. * The global DRM mutex must be held by the caller.
  295. */
  296. static void drm_put_minor(struct drm_minor *minor)
  297. {
  298. if (!minor)
  299. return;
  300. DRM_DEBUG("release secondary minor %d\n", minor->index);
  301. drm_unplug_minor(minor);
  302. idr_remove(&drm_minors_idr, minor->index);
  303. kfree(minor);
  304. }
  305. /**
  306. * Called via drm_exit() at module unload time or when pci device is
  307. * unplugged.
  308. *
  309. * Cleans up all DRM device, calling drm_lastclose().
  310. *
  311. */
  312. void drm_put_dev(struct drm_device *dev)
  313. {
  314. DRM_DEBUG("\n");
  315. if (!dev) {
  316. DRM_ERROR("cleanup called no dev\n");
  317. return;
  318. }
  319. drm_dev_unregister(dev);
  320. drm_dev_free(dev);
  321. }
  322. EXPORT_SYMBOL(drm_put_dev);
  323. void drm_unplug_dev(struct drm_device *dev)
  324. {
  325. /* for a USB device */
  326. if (drm_core_check_feature(dev, DRIVER_MODESET))
  327. drm_unplug_minor(dev->control);
  328. if (dev->render)
  329. drm_unplug_minor(dev->render);
  330. drm_unplug_minor(dev->primary);
  331. mutex_lock(&drm_global_mutex);
  332. drm_device_set_unplugged(dev);
  333. if (dev->open_count == 0) {
  334. drm_put_dev(dev);
  335. }
  336. mutex_unlock(&drm_global_mutex);
  337. }
  338. EXPORT_SYMBOL(drm_unplug_dev);
  339. /**
  340. * drm_dev_alloc - Allocate new drm device
  341. * @driver: DRM driver to allocate device for
  342. * @parent: Parent device object
  343. *
  344. * Allocate and initialize a new DRM device. No device registration is done.
  345. * Call drm_dev_register() to advertice the device to user space and register it
  346. * with other core subsystems.
  347. *
  348. * RETURNS:
  349. * Pointer to new DRM device, or NULL if out of memory.
  350. */
  351. struct drm_device *drm_dev_alloc(struct drm_driver *driver,
  352. struct device *parent)
  353. {
  354. struct drm_device *dev;
  355. int ret;
  356. dev = kzalloc(sizeof(*dev), GFP_KERNEL);
  357. if (!dev)
  358. return NULL;
  359. dev->dev = parent;
  360. dev->driver = driver;
  361. INIT_LIST_HEAD(&dev->filelist);
  362. INIT_LIST_HEAD(&dev->ctxlist);
  363. INIT_LIST_HEAD(&dev->vmalist);
  364. INIT_LIST_HEAD(&dev->maplist);
  365. INIT_LIST_HEAD(&dev->vblank_event_list);
  366. spin_lock_init(&dev->count_lock);
  367. spin_lock_init(&dev->event_lock);
  368. mutex_init(&dev->struct_mutex);
  369. mutex_init(&dev->ctxlist_mutex);
  370. if (drm_ht_create(&dev->map_hash, 12))
  371. goto err_free;
  372. ret = drm_ctxbitmap_init(dev);
  373. if (ret) {
  374. DRM_ERROR("Cannot allocate memory for context bitmap.\n");
  375. goto err_ht;
  376. }
  377. if (driver->driver_features & DRIVER_GEM) {
  378. ret = drm_gem_init(dev);
  379. if (ret) {
  380. DRM_ERROR("Cannot initialize graphics execution manager (GEM)\n");
  381. goto err_ctxbitmap;
  382. }
  383. }
  384. return dev;
  385. err_ctxbitmap:
  386. drm_ctxbitmap_cleanup(dev);
  387. err_ht:
  388. drm_ht_remove(&dev->map_hash);
  389. err_free:
  390. kfree(dev);
  391. return NULL;
  392. }
  393. EXPORT_SYMBOL(drm_dev_alloc);
  394. /**
  395. * drm_dev_free - Free DRM device
  396. * @dev: DRM device to free
  397. *
  398. * Free a DRM device that has previously been allocated via drm_dev_alloc().
  399. * You must not use kfree() instead or you will leak memory.
  400. *
  401. * This must not be called once the device got registered. Use drm_put_dev()
  402. * instead, which then calls drm_dev_free().
  403. */
  404. void drm_dev_free(struct drm_device *dev)
  405. {
  406. if (dev->driver->driver_features & DRIVER_GEM)
  407. drm_gem_destroy(dev);
  408. drm_ctxbitmap_cleanup(dev);
  409. drm_ht_remove(&dev->map_hash);
  410. kfree(dev->devname);
  411. kfree(dev);
  412. }
  413. EXPORT_SYMBOL(drm_dev_free);
  414. /**
  415. * drm_dev_register - Register DRM device
  416. * @dev: Device to register
  417. *
  418. * Register the DRM device @dev with the system, advertise device to user-space
  419. * and start normal device operation. @dev must be allocated via drm_dev_alloc()
  420. * previously.
  421. *
  422. * Never call this twice on any device!
  423. *
  424. * RETURNS:
  425. * 0 on success, negative error code on failure.
  426. */
  427. int drm_dev_register(struct drm_device *dev, unsigned long flags)
  428. {
  429. int ret;
  430. mutex_lock(&drm_global_mutex);
  431. if (dev->driver->bus->agp_init) {
  432. ret = dev->driver->bus->agp_init(dev);
  433. if (ret)
  434. goto out_unlock;
  435. }
  436. if (drm_core_check_feature(dev, DRIVER_MODESET)) {
  437. ret = drm_get_minor(dev, &dev->control, DRM_MINOR_CONTROL);
  438. if (ret)
  439. goto err_agp;
  440. }
  441. if (drm_core_check_feature(dev, DRIVER_RENDER) && drm_rnodes) {
  442. ret = drm_get_minor(dev, &dev->render, DRM_MINOR_RENDER);
  443. if (ret)
  444. goto err_control_node;
  445. }
  446. ret = drm_get_minor(dev, &dev->primary, DRM_MINOR_LEGACY);
  447. if (ret)
  448. goto err_render_node;
  449. if (dev->driver->load) {
  450. ret = dev->driver->load(dev, flags);
  451. if (ret)
  452. goto err_primary_node;
  453. }
  454. /* setup grouping for legacy outputs */
  455. if (drm_core_check_feature(dev, DRIVER_MODESET)) {
  456. ret = drm_mode_group_init_legacy_group(dev,
  457. &dev->primary->mode_group);
  458. if (ret)
  459. goto err_unload;
  460. }
  461. list_add_tail(&dev->driver_item, &dev->driver->device_list);
  462. ret = 0;
  463. goto out_unlock;
  464. err_unload:
  465. if (dev->driver->unload)
  466. dev->driver->unload(dev);
  467. err_primary_node:
  468. drm_put_minor(dev->primary);
  469. err_render_node:
  470. drm_put_minor(dev->render);
  471. err_control_node:
  472. drm_put_minor(dev->control);
  473. err_agp:
  474. if (dev->driver->bus->agp_destroy)
  475. dev->driver->bus->agp_destroy(dev);
  476. out_unlock:
  477. mutex_unlock(&drm_global_mutex);
  478. return ret;
  479. }
  480. EXPORT_SYMBOL(drm_dev_register);
  481. /**
  482. * drm_dev_unregister - Unregister DRM device
  483. * @dev: Device to unregister
  484. *
  485. * Unregister the DRM device from the system. This does the reverse of
  486. * drm_dev_register() but does not deallocate the device. The caller must call
  487. * drm_dev_free() to free all resources.
  488. */
  489. void drm_dev_unregister(struct drm_device *dev)
  490. {
  491. struct drm_map_list *r_list, *list_temp;
  492. drm_lastclose(dev);
  493. if (dev->driver->unload)
  494. dev->driver->unload(dev);
  495. if (dev->driver->bus->agp_destroy)
  496. dev->driver->bus->agp_destroy(dev);
  497. drm_vblank_cleanup(dev);
  498. list_for_each_entry_safe(r_list, list_temp, &dev->maplist, head)
  499. drm_rmmap(dev, r_list->map);
  500. drm_put_minor(dev->control);
  501. drm_put_minor(dev->render);
  502. drm_put_minor(dev->primary);
  503. list_del(&dev->driver_item);
  504. }
  505. EXPORT_SYMBOL(drm_dev_unregister);