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