1 /*-
2  * Copyright (c) 2010 Isilon Systems, Inc.
3  * Copyright (c) 2010 iX Systems, Inc.
4  * Copyright (c) 2010 Panasas, Inc.
5  * Copyright (c) 2013, 2014 Mellanox Technologies, Ltd.
6  * All rights reserved.
7  *
8  * Redistribution and use in source and binary forms, with or without
9  * modification, are permitted provided that the following conditions
10  * are met:
11  * 1. Redistributions of source code must retain the above copyright
12  *    notice unmodified, this list of conditions, and the following
13  *    disclaimer.
14  * 2. Redistributions in binary form must reproduce the above copyright
15  *    notice, this list of conditions and the following disclaimer in the
16  *    documentation and/or other materials provided with the distribution.
17  *
18  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
19  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
20  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
21  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
22  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
23  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
24  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
25  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
26  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
27  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
28  *
29  * $FreeBSD$
30  */
31 #ifndef _LINUX_DMAPOOL_H_
32 #define	_LINUX_DMAPOOL_H_
33 
34 #include <linux/types.h>
35 #include <linux/io.h>
36 #include <linux/scatterlist.h>
37 #include <linux/device.h>
38 #include <linux/slab.h>
39 
40 struct dma_pool;
41 struct dma_pool *linux_dma_pool_create(char *name, struct device *dev,
42     size_t size, size_t align, size_t boundary);
43 void linux_dma_pool_destroy(struct dma_pool *pool);
44 void lkpi_dmam_pool_destroy(struct device *, void *);
45 void *linux_dma_pool_alloc(struct dma_pool *pool, gfp_t mem_flags,
46     dma_addr_t *handle);
47 void linux_dma_pool_free(struct dma_pool *pool, void *vaddr,
48     dma_addr_t dma_addr);
49 
50 static inline struct dma_pool *
51 dma_pool_create(char *name, struct device *dev, size_t size,
52     size_t align, size_t boundary)
53 {
54 
55 	return (linux_dma_pool_create(name, dev, size, align, boundary));
56 }
57 
58 static inline struct dma_pool *
59 dmam_pool_create(/* const */ char *name, struct device *dev, size_t size,
60     size_t align, size_t boundary)
61 {
62 	struct dma_pool **pp;
63 
64 	pp = devres_alloc(lkpi_dmam_pool_destroy, sizeof(*pp), GFP_KERNEL);
65 	if (pp == NULL)
66 		return (NULL);
67 	*pp = linux_dma_pool_create(name, dev, size, align, boundary);
68 	if (*pp == NULL) {
69 		devres_free(pp);
70 		return (NULL);
71 	}
72 
73 	devres_add(dev, pp);
74 	return (*pp);
75 }
76 
77 static inline void
78 dma_pool_destroy(struct dma_pool *pool)
79 {
80 
81 	linux_dma_pool_destroy(pool);
82 }
83 
84 static inline void *
85 dma_pool_alloc(struct dma_pool *pool, gfp_t mem_flags, dma_addr_t *handle)
86 {
87 
88 	return (linux_dma_pool_alloc(pool, mem_flags, handle));
89 }
90 
91 static inline void *
92 dma_pool_zalloc(struct dma_pool *pool, gfp_t mem_flags, dma_addr_t *handle)
93 {
94 
95 	return (dma_pool_alloc(pool, mem_flags | __GFP_ZERO, handle));
96 }
97 
98 static inline void
99 dma_pool_free(struct dma_pool *pool, void *vaddr, dma_addr_t dma_addr)
100 {
101 
102 	linux_dma_pool_free(pool, vaddr, dma_addr);
103 }
104 
105 #endif /* _LINUX_DMAPOOL_H_ */
106