xref: /OK3568_Linux_fs/kernel/include/sound/util_mem.h (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593Smuzhiyun /* SPDX-License-Identifier: GPL-2.0-or-later */
2*4882a593Smuzhiyun #ifndef __SOUND_UTIL_MEM_H
3*4882a593Smuzhiyun #define __SOUND_UTIL_MEM_H
4*4882a593Smuzhiyun 
5*4882a593Smuzhiyun #include <linux/mutex.h>
6*4882a593Smuzhiyun /*
7*4882a593Smuzhiyun  *  Copyright (C) 2000 Takashi Iwai <tiwai@suse.de>
8*4882a593Smuzhiyun  *
9*4882a593Smuzhiyun  *  Generic memory management routines for soundcard memory allocation
10*4882a593Smuzhiyun  */
11*4882a593Smuzhiyun 
12*4882a593Smuzhiyun /*
13*4882a593Smuzhiyun  * memory block
14*4882a593Smuzhiyun  */
15*4882a593Smuzhiyun struct snd_util_memblk {
16*4882a593Smuzhiyun 	unsigned int size;		/* size of this block */
17*4882a593Smuzhiyun 	unsigned int offset;		/* zero-offset of this block */
18*4882a593Smuzhiyun 	struct list_head list;		/* link */
19*4882a593Smuzhiyun };
20*4882a593Smuzhiyun 
21*4882a593Smuzhiyun #define snd_util_memblk_argptr(blk)	(void*)((char*)(blk) + sizeof(struct snd_util_memblk))
22*4882a593Smuzhiyun 
23*4882a593Smuzhiyun /*
24*4882a593Smuzhiyun  * memory management information
25*4882a593Smuzhiyun  */
26*4882a593Smuzhiyun struct snd_util_memhdr {
27*4882a593Smuzhiyun 	unsigned int size;		/* size of whole data */
28*4882a593Smuzhiyun 	struct list_head block;		/* block linked-list header */
29*4882a593Smuzhiyun 	int nblocks;			/* # of allocated blocks */
30*4882a593Smuzhiyun 	unsigned int used;		/* used memory size */
31*4882a593Smuzhiyun 	int block_extra_size;		/* extra data size of chunk */
32*4882a593Smuzhiyun 	struct mutex block_mutex;	/* lock */
33*4882a593Smuzhiyun };
34*4882a593Smuzhiyun 
35*4882a593Smuzhiyun /*
36*4882a593Smuzhiyun  * prototypes
37*4882a593Smuzhiyun  */
38*4882a593Smuzhiyun struct snd_util_memhdr *snd_util_memhdr_new(int memsize);
39*4882a593Smuzhiyun void snd_util_memhdr_free(struct snd_util_memhdr *hdr);
40*4882a593Smuzhiyun struct snd_util_memblk *snd_util_mem_alloc(struct snd_util_memhdr *hdr, int size);
41*4882a593Smuzhiyun int snd_util_mem_free(struct snd_util_memhdr *hdr, struct snd_util_memblk *blk);
42*4882a593Smuzhiyun int snd_util_mem_avail(struct snd_util_memhdr *hdr);
43*4882a593Smuzhiyun 
44*4882a593Smuzhiyun /* functions without mutex */
45*4882a593Smuzhiyun struct snd_util_memblk *__snd_util_mem_alloc(struct snd_util_memhdr *hdr, int size);
46*4882a593Smuzhiyun void __snd_util_mem_free(struct snd_util_memhdr *hdr, struct snd_util_memblk *blk);
47*4882a593Smuzhiyun struct snd_util_memblk *__snd_util_memblk_new(struct snd_util_memhdr *hdr,
48*4882a593Smuzhiyun 					      unsigned int units,
49*4882a593Smuzhiyun 					      struct list_head *prev);
50*4882a593Smuzhiyun 
51*4882a593Smuzhiyun #endif /* __SOUND_UTIL_MEM_H */
52