xref: /openbmc/linux/include/sound/util_mem.h (revision 1a59d1b8)
11a59d1b8SThomas Gleixner /* SPDX-License-Identifier: GPL-2.0-or-later */
21da177e4SLinus Torvalds #ifndef __SOUND_UTIL_MEM_H
31da177e4SLinus Torvalds #define __SOUND_UTIL_MEM_H
4ef9f0a42SIngo Molnar 
5ef9f0a42SIngo Molnar #include <linux/mutex.h>
61da177e4SLinus Torvalds /*
71da177e4SLinus Torvalds  *  Copyright (C) 2000 Takashi Iwai <tiwai@suse.de>
81da177e4SLinus Torvalds  *
91da177e4SLinus Torvalds  *  Generic memory management routines for soundcard memory allocation
101da177e4SLinus Torvalds  */
111da177e4SLinus Torvalds 
121da177e4SLinus Torvalds /*
131da177e4SLinus Torvalds  * memory block
141da177e4SLinus Torvalds  */
151da177e4SLinus Torvalds struct snd_util_memblk {
1603da312aSTakashi Iwai 	unsigned int size;		/* size of this block */
1703da312aSTakashi Iwai 	unsigned int offset;		/* zero-offset of this block */
181da177e4SLinus Torvalds 	struct list_head list;		/* link */
191da177e4SLinus Torvalds };
201da177e4SLinus Torvalds 
2103da312aSTakashi Iwai #define snd_util_memblk_argptr(blk)	(void*)((char*)(blk) + sizeof(struct snd_util_memblk))
221da177e4SLinus Torvalds 
231da177e4SLinus Torvalds /*
241da177e4SLinus Torvalds  * memory management information
251da177e4SLinus Torvalds  */
261da177e4SLinus Torvalds struct snd_util_memhdr {
2703da312aSTakashi Iwai 	unsigned int size;		/* size of whole data */
281da177e4SLinus Torvalds 	struct list_head block;		/* block linked-list header */
291da177e4SLinus Torvalds 	int nblocks;			/* # of allocated blocks */
3003da312aSTakashi Iwai 	unsigned int used;		/* used memory size */
311da177e4SLinus Torvalds 	int block_extra_size;		/* extra data size of chunk */
32ef9f0a42SIngo Molnar 	struct mutex block_mutex;	/* lock */
331da177e4SLinus Torvalds };
341da177e4SLinus Torvalds 
351da177e4SLinus Torvalds /*
361da177e4SLinus Torvalds  * prototypes
371da177e4SLinus Torvalds  */
3803da312aSTakashi Iwai struct snd_util_memhdr *snd_util_memhdr_new(int memsize);
3903da312aSTakashi Iwai void snd_util_memhdr_free(struct snd_util_memhdr *hdr);
4003da312aSTakashi Iwai struct snd_util_memblk *snd_util_mem_alloc(struct snd_util_memhdr *hdr, int size);
4103da312aSTakashi Iwai int snd_util_mem_free(struct snd_util_memhdr *hdr, struct snd_util_memblk *blk);
4203da312aSTakashi Iwai int snd_util_mem_avail(struct snd_util_memhdr *hdr);
431da177e4SLinus Torvalds 
441da177e4SLinus Torvalds /* functions without mutex */
4503da312aSTakashi Iwai struct snd_util_memblk *__snd_util_mem_alloc(struct snd_util_memhdr *hdr, int size);
4603da312aSTakashi Iwai void __snd_util_mem_free(struct snd_util_memhdr *hdr, struct snd_util_memblk *blk);
4703da312aSTakashi Iwai struct snd_util_memblk *__snd_util_memblk_new(struct snd_util_memhdr *hdr,
4803da312aSTakashi Iwai 					      unsigned int units,
4903da312aSTakashi Iwai 					      struct list_head *prev);
501da177e4SLinus Torvalds 
511da177e4SLinus Torvalds #endif /* __SOUND_UTIL_MEM_H */
52