ttm_bo_api.h 23 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739
  1. /**************************************************************************
  2. *
  3. * Copyright (c) 2006-2009 VMware, Inc., Palo Alto, CA., USA
  4. * All Rights Reserved.
  5. *
  6. * Permission is hereby granted, free of charge, to any person obtaining a
  7. * copy of this software and associated documentation files (the
  8. * "Software"), to deal in the Software without restriction, including
  9. * without limitation the rights to use, copy, modify, merge, publish,
  10. * distribute, sub license, and/or sell copies of the Software, and to
  11. * permit persons to whom the Software is furnished to do so, subject to
  12. * the following conditions:
  13. *
  14. * The above copyright notice and this permission notice (including the
  15. * next paragraph) shall be included in all copies or substantial portions
  16. * of the Software.
  17. *
  18. * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  19. * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  20. * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL
  21. * THE COPYRIGHT HOLDERS, AUTHORS AND/OR ITS SUPPLIERS BE LIABLE FOR ANY CLAIM,
  22. * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
  23. * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
  24. * USE OR OTHER DEALINGS IN THE SOFTWARE.
  25. *
  26. **************************************************************************/
  27. /*
  28. * Authors: Thomas Hellstrom <thellstrom-at-vmware-dot-com>
  29. */
  30. #ifndef _TTM_BO_API_H_
  31. #define _TTM_BO_API_H_
  32. #include "drm_hashtab.h"
  33. #include <linux/kref.h>
  34. #include <linux/list.h>
  35. #include <linux/wait.h>
  36. #include <linux/mutex.h>
  37. #include <linux/mm.h>
  38. #include <linux/rbtree.h>
  39. #include <linux/bitmap.h>
  40. struct ttm_bo_device;
  41. struct drm_mm_node;
  42. /**
  43. * struct ttm_placement
  44. *
  45. * @fpfn: first valid page frame number to put the object
  46. * @lpfn: last valid page frame number to put the object
  47. * @num_placement: number of preferred placements
  48. * @placement: preferred placements
  49. * @num_busy_placement: number of preferred placements when need to evict buffer
  50. * @busy_placement: preferred placements when need to evict buffer
  51. *
  52. * Structure indicating the placement you request for an object.
  53. */
  54. struct ttm_placement {
  55. unsigned fpfn;
  56. unsigned lpfn;
  57. unsigned num_placement;
  58. const uint32_t *placement;
  59. unsigned num_busy_placement;
  60. const uint32_t *busy_placement;
  61. };
  62. /**
  63. * struct ttm_bus_placement
  64. *
  65. * @addr: mapped virtual address
  66. * @base: bus base address
  67. * @is_iomem: is this io memory ?
  68. * @size: size in byte
  69. * @offset: offset from the base address
  70. * @io_reserved_vm: The VM system has a refcount in @io_reserved_count
  71. * @io_reserved_count: Refcounting the numbers of callers to ttm_mem_io_reserve
  72. *
  73. * Structure indicating the bus placement of an object.
  74. */
  75. struct ttm_bus_placement {
  76. void *addr;
  77. unsigned long base;
  78. unsigned long size;
  79. unsigned long offset;
  80. bool is_iomem;
  81. bool io_reserved_vm;
  82. uint64_t io_reserved_count;
  83. };
  84. /**
  85. * struct ttm_mem_reg
  86. *
  87. * @mm_node: Memory manager node.
  88. * @size: Requested size of memory region.
  89. * @num_pages: Actual size of memory region in pages.
  90. * @page_alignment: Page alignment.
  91. * @placement: Placement flags.
  92. * @bus: Placement on io bus accessible to the CPU
  93. *
  94. * Structure indicating the placement and space resources used by a
  95. * buffer object.
  96. */
  97. struct ttm_mem_reg {
  98. void *mm_node;
  99. unsigned long start;
  100. unsigned long size;
  101. unsigned long num_pages;
  102. uint32_t page_alignment;
  103. uint32_t mem_type;
  104. uint32_t placement;
  105. struct ttm_bus_placement bus;
  106. };
  107. /**
  108. * enum ttm_bo_type
  109. *
  110. * @ttm_bo_type_device: These are 'normal' buffers that can
  111. * be mmapped by user space. Each of these bos occupy a slot in the
  112. * device address space, that can be used for normal vm operations.
  113. *
  114. * @ttm_bo_type_kernel: These buffers are like ttm_bo_type_device buffers,
  115. * but they cannot be accessed from user-space. For kernel-only use.
  116. *
  117. * @ttm_bo_type_sg: Buffer made from dmabuf sg table shared with another
  118. * driver.
  119. */
  120. enum ttm_bo_type {
  121. ttm_bo_type_device,
  122. ttm_bo_type_kernel,
  123. ttm_bo_type_sg
  124. };
  125. struct ttm_tt;
  126. /**
  127. * struct ttm_buffer_object
  128. *
  129. * @bdev: Pointer to the buffer object device structure.
  130. * @buffer_start: The virtual user-space start address of ttm_bo_type_user
  131. * buffers.
  132. * @type: The bo type.
  133. * @destroy: Destruction function. If NULL, kfree is used.
  134. * @num_pages: Actual number of pages.
  135. * @addr_space_offset: Address space offset.
  136. * @acc_size: Accounted size for this object.
  137. * @kref: Reference count of this buffer object. When this refcount reaches
  138. * zero, the object is put on the delayed delete list.
  139. * @list_kref: List reference count of this buffer object. This member is
  140. * used to avoid destruction while the buffer object is still on a list.
  141. * Lru lists may keep one refcount, the delayed delete list, and kref != 0
  142. * keeps one refcount. When this refcount reaches zero,
  143. * the object is destroyed.
  144. * @event_queue: Queue for processes waiting on buffer object status change.
  145. * @mem: structure describing current placement.
  146. * @persistent_swap_storage: Usually the swap storage is deleted for buffers
  147. * pinned in physical memory. If this behaviour is not desired, this member
  148. * holds a pointer to a persistent shmem object.
  149. * @ttm: TTM structure holding system pages.
  150. * @evicted: Whether the object was evicted without user-space knowing.
  151. * @cpu_writes: For synchronization. Number of cpu writers.
  152. * @lru: List head for the lru list.
  153. * @ddestroy: List head for the delayed destroy list.
  154. * @swap: List head for swap LRU list.
  155. * @val_seq: Sequence of the validation holding the @reserved lock.
  156. * Used to avoid starvation when many processes compete to validate the
  157. * buffer. This member is protected by the bo_device::lru_lock.
  158. * @seq_valid: The value of @val_seq is valid. This value is protected by
  159. * the bo_device::lru_lock.
  160. * @reserved: Deadlock-free lock used for synchronization state transitions.
  161. * @sync_obj_arg: Opaque argument to synchronization object function.
  162. * @sync_obj: Pointer to a synchronization object.
  163. * @priv_flags: Flags describing buffer object internal state.
  164. * @vm_rb: Rb node for the vm rb tree.
  165. * @vm_node: Address space manager node.
  166. * @offset: The current GPU offset, which can have different meanings
  167. * depending on the memory type. For SYSTEM type memory, it should be 0.
  168. * @cur_placement: Hint of current placement.
  169. *
  170. * Base class for TTM buffer object, that deals with data placement and CPU
  171. * mappings. GPU mappings are really up to the driver, but for simpler GPUs
  172. * the driver can usually use the placement offset @offset directly as the
  173. * GPU virtual address. For drivers implementing multiple
  174. * GPU memory manager contexts, the driver should manage the address space
  175. * in these contexts separately and use these objects to get the correct
  176. * placement and caching for these GPU maps. This makes it possible to use
  177. * these objects for even quite elaborate memory management schemes.
  178. * The destroy member, the API visibility of this object makes it possible
  179. * to derive driver specific types.
  180. */
  181. struct ttm_buffer_object {
  182. /**
  183. * Members constant at init.
  184. */
  185. struct ttm_bo_global *glob;
  186. struct ttm_bo_device *bdev;
  187. unsigned long buffer_start;
  188. enum ttm_bo_type type;
  189. void (*destroy) (struct ttm_buffer_object *);
  190. unsigned long num_pages;
  191. uint64_t addr_space_offset;
  192. size_t acc_size;
  193. /**
  194. * Members not needing protection.
  195. */
  196. struct kref kref;
  197. struct kref list_kref;
  198. wait_queue_head_t event_queue;
  199. /**
  200. * Members protected by the bo::reserved lock.
  201. */
  202. struct ttm_mem_reg mem;
  203. struct file *persistent_swap_storage;
  204. struct ttm_tt *ttm;
  205. bool evicted;
  206. /**
  207. * Members protected by the bo::reserved lock only when written to.
  208. */
  209. atomic_t cpu_writers;
  210. /**
  211. * Members protected by the bdev::lru_lock.
  212. */
  213. struct list_head lru;
  214. struct list_head ddestroy;
  215. struct list_head swap;
  216. struct list_head io_reserve_lru;
  217. uint32_t val_seq;
  218. bool seq_valid;
  219. /**
  220. * Members protected by the bdev::lru_lock
  221. * only when written to.
  222. */
  223. atomic_t reserved;
  224. /**
  225. * Members protected by struct buffer_object_device::fence_lock
  226. * In addition, setting sync_obj to anything else
  227. * than NULL requires bo::reserved to be held. This allows for
  228. * checking NULL while reserved but not holding the mentioned lock.
  229. */
  230. void *sync_obj_arg;
  231. void *sync_obj;
  232. unsigned long priv_flags;
  233. /**
  234. * Members protected by the bdev::vm_lock
  235. */
  236. struct rb_node vm_rb;
  237. struct drm_mm_node *vm_node;
  238. /**
  239. * Special members that are protected by the reserve lock
  240. * and the bo::lock when written to. Can be read with
  241. * either of these locks held.
  242. */
  243. unsigned long offset;
  244. uint32_t cur_placement;
  245. struct sg_table *sg;
  246. };
  247. /**
  248. * struct ttm_bo_kmap_obj
  249. *
  250. * @virtual: The current kernel virtual address.
  251. * @page: The page when kmap'ing a single page.
  252. * @bo_kmap_type: Type of bo_kmap.
  253. *
  254. * Object describing a kernel mapping. Since a TTM bo may be located
  255. * in various memory types with various caching policies, the
  256. * mapping can either be an ioremap, a vmap, a kmap or part of a
  257. * premapped region.
  258. */
  259. #define TTM_BO_MAP_IOMEM_MASK 0x80
  260. struct ttm_bo_kmap_obj {
  261. void *virtual;
  262. struct page *page;
  263. enum {
  264. ttm_bo_map_iomap = 1 | TTM_BO_MAP_IOMEM_MASK,
  265. ttm_bo_map_vmap = 2,
  266. ttm_bo_map_kmap = 3,
  267. ttm_bo_map_premapped = 4 | TTM_BO_MAP_IOMEM_MASK,
  268. } bo_kmap_type;
  269. struct ttm_buffer_object *bo;
  270. };
  271. /**
  272. * ttm_bo_reference - reference a struct ttm_buffer_object
  273. *
  274. * @bo: The buffer object.
  275. *
  276. * Returns a refcounted pointer to a buffer object.
  277. */
  278. static inline struct ttm_buffer_object *
  279. ttm_bo_reference(struct ttm_buffer_object *bo)
  280. {
  281. kref_get(&bo->kref);
  282. return bo;
  283. }
  284. /**
  285. * ttm_bo_wait - wait for buffer idle.
  286. *
  287. * @bo: The buffer object.
  288. * @interruptible: Use interruptible wait.
  289. * @no_wait: Return immediately if buffer is busy.
  290. *
  291. * This function must be called with the bo::mutex held, and makes
  292. * sure any previous rendering to the buffer is completed.
  293. * Note: It might be necessary to block validations before the
  294. * wait by reserving the buffer.
  295. * Returns -EBUSY if no_wait is true and the buffer is busy.
  296. * Returns -ERESTARTSYS if interrupted by a signal.
  297. */
  298. extern int ttm_bo_wait(struct ttm_buffer_object *bo, bool lazy,
  299. bool interruptible, bool no_wait);
  300. /**
  301. * ttm_bo_validate
  302. *
  303. * @bo: The buffer object.
  304. * @placement: Proposed placement for the buffer object.
  305. * @interruptible: Sleep interruptible if sleeping.
  306. * @no_wait_reserve: Return immediately if other buffers are busy.
  307. * @no_wait_gpu: Return immediately if the GPU is busy.
  308. *
  309. * Changes placement and caching policy of the buffer object
  310. * according proposed placement.
  311. * Returns
  312. * -EINVAL on invalid proposed placement.
  313. * -ENOMEM on out-of-memory condition.
  314. * -EBUSY if no_wait is true and buffer busy.
  315. * -ERESTARTSYS if interrupted by a signal.
  316. */
  317. extern int ttm_bo_validate(struct ttm_buffer_object *bo,
  318. struct ttm_placement *placement,
  319. bool interruptible, bool no_wait_reserve,
  320. bool no_wait_gpu);
  321. /**
  322. * ttm_bo_unref
  323. *
  324. * @bo: The buffer object.
  325. *
  326. * Unreference and clear a pointer to a buffer object.
  327. */
  328. extern void ttm_bo_unref(struct ttm_buffer_object **bo);
  329. /**
  330. * ttm_bo_list_ref_sub
  331. *
  332. * @bo: The buffer object.
  333. * @count: The number of references with which to decrease @bo::list_kref;
  334. * @never_free: The refcount should not reach zero with this operation.
  335. *
  336. * Release @count lru list references to this buffer object.
  337. */
  338. extern void ttm_bo_list_ref_sub(struct ttm_buffer_object *bo, int count,
  339. bool never_free);
  340. /**
  341. * ttm_bo_add_to_lru
  342. *
  343. * @bo: The buffer object.
  344. *
  345. * Add this bo to the relevant mem type lru and, if it's backed by
  346. * system pages (ttms) to the swap list.
  347. * This function must be called with struct ttm_bo_global::lru_lock held, and
  348. * is typically called immediately prior to unreserving a bo.
  349. */
  350. extern void ttm_bo_add_to_lru(struct ttm_buffer_object *bo);
  351. /**
  352. * ttm_bo_del_from_lru
  353. *
  354. * @bo: The buffer object.
  355. *
  356. * Remove this bo from all lru lists used to lookup and reserve an object.
  357. * This function must be called with struct ttm_bo_global::lru_lock held,
  358. * and is usually called just immediately after the bo has been reserved to
  359. * avoid recursive reservation from lru lists.
  360. */
  361. extern int ttm_bo_del_from_lru(struct ttm_buffer_object *bo);
  362. /**
  363. * ttm_bo_lock_delayed_workqueue
  364. *
  365. * Prevent the delayed workqueue from running.
  366. * Returns
  367. * True if the workqueue was queued at the time
  368. */
  369. extern int ttm_bo_lock_delayed_workqueue(struct ttm_bo_device *bdev);
  370. /**
  371. * ttm_bo_unlock_delayed_workqueue
  372. *
  373. * Allows the delayed workqueue to run.
  374. */
  375. extern void ttm_bo_unlock_delayed_workqueue(struct ttm_bo_device *bdev,
  376. int resched);
  377. /**
  378. * ttm_bo_synccpu_write_grab
  379. *
  380. * @bo: The buffer object:
  381. * @no_wait: Return immediately if buffer is busy.
  382. *
  383. * Synchronizes a buffer object for CPU RW access. This means
  384. * blocking command submission that affects the buffer and
  385. * waiting for buffer idle. This lock is recursive.
  386. * Returns
  387. * -EBUSY if the buffer is busy and no_wait is true.
  388. * -ERESTARTSYS if interrupted by a signal.
  389. */
  390. extern int
  391. ttm_bo_synccpu_write_grab(struct ttm_buffer_object *bo, bool no_wait);
  392. /**
  393. * ttm_bo_synccpu_write_release:
  394. *
  395. * @bo : The buffer object.
  396. *
  397. * Releases a synccpu lock.
  398. */
  399. extern void ttm_bo_synccpu_write_release(struct ttm_buffer_object *bo);
  400. /**
  401. * ttm_bo_acc_size
  402. *
  403. * @bdev: Pointer to a ttm_bo_device struct.
  404. * @bo_size: size of the buffer object in byte.
  405. * @struct_size: size of the structure holding buffer object datas
  406. *
  407. * Returns size to account for a buffer object
  408. */
  409. size_t ttm_bo_acc_size(struct ttm_bo_device *bdev,
  410. unsigned long bo_size,
  411. unsigned struct_size);
  412. size_t ttm_bo_dma_acc_size(struct ttm_bo_device *bdev,
  413. unsigned long bo_size,
  414. unsigned struct_size);
  415. /**
  416. * ttm_bo_init
  417. *
  418. * @bdev: Pointer to a ttm_bo_device struct.
  419. * @bo: Pointer to a ttm_buffer_object to be initialized.
  420. * @size: Requested size of buffer object.
  421. * @type: Requested type of buffer object.
  422. * @flags: Initial placement flags.
  423. * @page_alignment: Data alignment in pages.
  424. * @buffer_start: Virtual address of user space data backing a
  425. * user buffer object.
  426. * @interruptible: If needing to sleep to wait for GPU resources,
  427. * sleep interruptible.
  428. * @persistent_swap_storage: Usually the swap storage is deleted for buffers
  429. * pinned in physical memory. If this behaviour is not desired, this member
  430. * holds a pointer to a persistent shmem object. Typically, this would
  431. * point to the shmem object backing a GEM object if TTM is used to back a
  432. * GEM user interface.
  433. * @acc_size: Accounted size for this object.
  434. * @destroy: Destroy function. Use NULL for kfree().
  435. *
  436. * This function initializes a pre-allocated struct ttm_buffer_object.
  437. * As this object may be part of a larger structure, this function,
  438. * together with the @destroy function,
  439. * enables driver-specific objects derived from a ttm_buffer_object.
  440. * On successful return, the object kref and list_kref are set to 1.
  441. * If a failure occurs, the function will call the @destroy function, or
  442. * kfree() if @destroy is NULL. Thus, after a failure, dereferencing @bo is
  443. * illegal and will likely cause memory corruption.
  444. *
  445. * Returns
  446. * -ENOMEM: Out of memory.
  447. * -EINVAL: Invalid placement flags.
  448. * -ERESTARTSYS: Interrupted by signal while sleeping waiting for resources.
  449. */
  450. extern int ttm_bo_init(struct ttm_bo_device *bdev,
  451. struct ttm_buffer_object *bo,
  452. unsigned long size,
  453. enum ttm_bo_type type,
  454. struct ttm_placement *placement,
  455. uint32_t page_alignment,
  456. unsigned long buffer_start,
  457. bool interrubtible,
  458. struct file *persistent_swap_storage,
  459. size_t acc_size,
  460. struct sg_table *sg,
  461. void (*destroy) (struct ttm_buffer_object *));
  462. /**
  463. * ttm_bo_synccpu_object_init
  464. *
  465. * @bdev: Pointer to a ttm_bo_device struct.
  466. * @bo: Pointer to a ttm_buffer_object to be initialized.
  467. * @size: Requested size of buffer object.
  468. * @type: Requested type of buffer object.
  469. * @flags: Initial placement flags.
  470. * @page_alignment: Data alignment in pages.
  471. * @buffer_start: Virtual address of user space data backing a
  472. * user buffer object.
  473. * @interruptible: If needing to sleep while waiting for GPU resources,
  474. * sleep interruptible.
  475. * @persistent_swap_storage: Usually the swap storage is deleted for buffers
  476. * pinned in physical memory. If this behaviour is not desired, this member
  477. * holds a pointer to a persistent shmem object. Typically, this would
  478. * point to the shmem object backing a GEM object if TTM is used to back a
  479. * GEM user interface.
  480. * @p_bo: On successful completion *p_bo points to the created object.
  481. *
  482. * This function allocates a ttm_buffer_object, and then calls ttm_bo_init
  483. * on that object. The destroy function is set to kfree().
  484. * Returns
  485. * -ENOMEM: Out of memory.
  486. * -EINVAL: Invalid placement flags.
  487. * -ERESTARTSYS: Interrupted by signal while waiting for resources.
  488. */
  489. extern int ttm_bo_create(struct ttm_bo_device *bdev,
  490. unsigned long size,
  491. enum ttm_bo_type type,
  492. struct ttm_placement *placement,
  493. uint32_t page_alignment,
  494. unsigned long buffer_start,
  495. bool interruptible,
  496. struct file *persistent_swap_storage,
  497. struct ttm_buffer_object **p_bo);
  498. /**
  499. * ttm_bo_check_placement
  500. *
  501. * @bo: the buffer object.
  502. * @placement: placements
  503. *
  504. * Performs minimal validity checking on an intended change of
  505. * placement flags.
  506. * Returns
  507. * -EINVAL: Intended change is invalid or not allowed.
  508. */
  509. extern int ttm_bo_check_placement(struct ttm_buffer_object *bo,
  510. struct ttm_placement *placement);
  511. /**
  512. * ttm_bo_init_mm
  513. *
  514. * @bdev: Pointer to a ttm_bo_device struct.
  515. * @mem_type: The memory type.
  516. * @p_size: size managed area in pages.
  517. *
  518. * Initialize a manager for a given memory type.
  519. * Note: if part of driver firstopen, it must be protected from a
  520. * potentially racing lastclose.
  521. * Returns:
  522. * -EINVAL: invalid size or memory type.
  523. * -ENOMEM: Not enough memory.
  524. * May also return driver-specified errors.
  525. */
  526. extern int ttm_bo_init_mm(struct ttm_bo_device *bdev, unsigned type,
  527. unsigned long p_size);
  528. /**
  529. * ttm_bo_clean_mm
  530. *
  531. * @bdev: Pointer to a ttm_bo_device struct.
  532. * @mem_type: The memory type.
  533. *
  534. * Take down a manager for a given memory type after first walking
  535. * the LRU list to evict any buffers left alive.
  536. *
  537. * Normally, this function is part of lastclose() or unload(), and at that
  538. * point there shouldn't be any buffers left created by user-space, since
  539. * there should've been removed by the file descriptor release() method.
  540. * However, before this function is run, make sure to signal all sync objects,
  541. * and verify that the delayed delete queue is empty. The driver must also
  542. * make sure that there are no NO_EVICT buffers present in this memory type
  543. * when the call is made.
  544. *
  545. * If this function is part of a VT switch, the caller must make sure that
  546. * there are no appications currently validating buffers before this
  547. * function is called. The caller can do that by first taking the
  548. * struct ttm_bo_device::ttm_lock in write mode.
  549. *
  550. * Returns:
  551. * -EINVAL: invalid or uninitialized memory type.
  552. * -EBUSY: There are still buffers left in this memory type.
  553. */
  554. extern int ttm_bo_clean_mm(struct ttm_bo_device *bdev, unsigned mem_type);
  555. /**
  556. * ttm_bo_evict_mm
  557. *
  558. * @bdev: Pointer to a ttm_bo_device struct.
  559. * @mem_type: The memory type.
  560. *
  561. * Evicts all buffers on the lru list of the memory type.
  562. * This is normally part of a VT switch or an
  563. * out-of-memory-space-due-to-fragmentation handler.
  564. * The caller must make sure that there are no other processes
  565. * currently validating buffers, and can do that by taking the
  566. * struct ttm_bo_device::ttm_lock in write mode.
  567. *
  568. * Returns:
  569. * -EINVAL: Invalid or uninitialized memory type.
  570. * -ERESTARTSYS: The call was interrupted by a signal while waiting to
  571. * evict a buffer.
  572. */
  573. extern int ttm_bo_evict_mm(struct ttm_bo_device *bdev, unsigned mem_type);
  574. /**
  575. * ttm_kmap_obj_virtual
  576. *
  577. * @map: A struct ttm_bo_kmap_obj returned from ttm_bo_kmap.
  578. * @is_iomem: Pointer to an integer that on return indicates 1 if the
  579. * virtual map is io memory, 0 if normal memory.
  580. *
  581. * Returns the virtual address of a buffer object area mapped by ttm_bo_kmap.
  582. * If *is_iomem is 1 on return, the virtual address points to an io memory area,
  583. * that should strictly be accessed by the iowriteXX() and similar functions.
  584. */
  585. static inline void *ttm_kmap_obj_virtual(struct ttm_bo_kmap_obj *map,
  586. bool *is_iomem)
  587. {
  588. *is_iomem = !!(map->bo_kmap_type & TTM_BO_MAP_IOMEM_MASK);
  589. return map->virtual;
  590. }
  591. /**
  592. * ttm_bo_kmap
  593. *
  594. * @bo: The buffer object.
  595. * @start_page: The first page to map.
  596. * @num_pages: Number of pages to map.
  597. * @map: pointer to a struct ttm_bo_kmap_obj representing the map.
  598. *
  599. * Sets up a kernel virtual mapping, using ioremap, vmap or kmap to the
  600. * data in the buffer object. The ttm_kmap_obj_virtual function can then be
  601. * used to obtain a virtual address to the data.
  602. *
  603. * Returns
  604. * -ENOMEM: Out of memory.
  605. * -EINVAL: Invalid range.
  606. */
  607. extern int ttm_bo_kmap(struct ttm_buffer_object *bo, unsigned long start_page,
  608. unsigned long num_pages, struct ttm_bo_kmap_obj *map);
  609. /**
  610. * ttm_bo_kunmap
  611. *
  612. * @map: Object describing the map to unmap.
  613. *
  614. * Unmaps a kernel map set up by ttm_bo_kmap.
  615. */
  616. extern void ttm_bo_kunmap(struct ttm_bo_kmap_obj *map);
  617. /**
  618. * ttm_fbdev_mmap - mmap fbdev memory backed by a ttm buffer object.
  619. *
  620. * @vma: vma as input from the fbdev mmap method.
  621. * @bo: The bo backing the address space. The address space will
  622. * have the same size as the bo, and start at offset 0.
  623. *
  624. * This function is intended to be called by the fbdev mmap method
  625. * if the fbdev address space is to be backed by a bo.
  626. */
  627. extern int ttm_fbdev_mmap(struct vm_area_struct *vma,
  628. struct ttm_buffer_object *bo);
  629. /**
  630. * ttm_bo_mmap - mmap out of the ttm device address space.
  631. *
  632. * @filp: filp as input from the mmap method.
  633. * @vma: vma as input from the mmap method.
  634. * @bdev: Pointer to the ttm_bo_device with the address space manager.
  635. *
  636. * This function is intended to be called by the device mmap method.
  637. * if the device address space is to be backed by the bo manager.
  638. */
  639. extern int ttm_bo_mmap(struct file *filp, struct vm_area_struct *vma,
  640. struct ttm_bo_device *bdev);
  641. /**
  642. * ttm_bo_io
  643. *
  644. * @bdev: Pointer to the struct ttm_bo_device.
  645. * @filp: Pointer to the struct file attempting to read / write.
  646. * @wbuf: User-space pointer to address of buffer to write. NULL on read.
  647. * @rbuf: User-space pointer to address of buffer to read into.
  648. * Null on write.
  649. * @count: Number of bytes to read / write.
  650. * @f_pos: Pointer to current file position.
  651. * @write: 1 for read, 0 for write.
  652. *
  653. * This function implements read / write into ttm buffer objects, and is
  654. * intended to
  655. * be called from the fops::read and fops::write method.
  656. * Returns:
  657. * See man (2) write, man(2) read. In particular,
  658. * the function may return -ERESTARTSYS if
  659. * interrupted by a signal.
  660. */
  661. extern ssize_t ttm_bo_io(struct ttm_bo_device *bdev, struct file *filp,
  662. const char __user *wbuf, char __user *rbuf,
  663. size_t count, loff_t *f_pos, bool write);
  664. extern void ttm_bo_swapout_all(struct ttm_bo_device *bdev);
  665. #endif