xref: /openbmc/linux/include/sound/util_mem.h (revision c819e2cf)
1 #ifndef __SOUND_UTIL_MEM_H
2 #define __SOUND_UTIL_MEM_H
3 
4 #include <linux/mutex.h>
5 /*
6  *  Copyright (C) 2000 Takashi Iwai <tiwai@suse.de>
7  *
8  *  Generic memory management routines for soundcard memory allocation
9  *
10  *   This program is free software; you can redistribute it and/or modify
11  *   it under the terms of the GNU General Public License as published by
12  *   the Free Software Foundation; either version 2 of the License, or
13  *   (at your option) any later version.
14  *
15  *   This program is distributed in the hope that it will be useful,
16  *   but WITHOUT ANY WARRANTY; without even the implied warranty of
17  *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
18  *   GNU General Public License for more details.
19  *
20  *   You should have received a copy of the GNU General Public License
21  *   along with this program; if not, write to the Free Software
22  *   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
23  */
24 
25 /*
26  * memory block
27  */
28 struct snd_util_memblk {
29 	unsigned int size;		/* size of this block */
30 	unsigned int offset;		/* zero-offset of this block */
31 	struct list_head list;		/* link */
32 };
33 
34 #define snd_util_memblk_argptr(blk)	(void*)((char*)(blk) + sizeof(struct snd_util_memblk))
35 
36 /*
37  * memory management information
38  */
39 struct snd_util_memhdr {
40 	unsigned int size;		/* size of whole data */
41 	struct list_head block;		/* block linked-list header */
42 	int nblocks;			/* # of allocated blocks */
43 	unsigned int used;		/* used memory size */
44 	int block_extra_size;		/* extra data size of chunk */
45 	struct mutex block_mutex;	/* lock */
46 };
47 
48 /*
49  * prototypes
50  */
51 struct snd_util_memhdr *snd_util_memhdr_new(int memsize);
52 void snd_util_memhdr_free(struct snd_util_memhdr *hdr);
53 struct snd_util_memblk *snd_util_mem_alloc(struct snd_util_memhdr *hdr, int size);
54 int snd_util_mem_free(struct snd_util_memhdr *hdr, struct snd_util_memblk *blk);
55 int snd_util_mem_avail(struct snd_util_memhdr *hdr);
56 
57 /* functions without mutex */
58 struct snd_util_memblk *__snd_util_mem_alloc(struct snd_util_memhdr *hdr, int size);
59 void __snd_util_mem_free(struct snd_util_memhdr *hdr, struct snd_util_memblk *blk);
60 struct snd_util_memblk *__snd_util_memblk_new(struct snd_util_memhdr *hdr,
61 					      unsigned int units,
62 					      struct list_head *prev);
63 
64 #endif /* __SOUND_UTIL_MEM_H */
65