/* SPDX-License-Identifier: GPL-2.0-or-later */
#ifndef __SOUND_UTIL_MEM_H
#define __SOUND_UTIL_MEM_H

#include <linux/mutex.h>
/*
 *  Copyright (C) 2000 Takashi Iwai <[email protected]>
 *
 *  Generic memory management routines for soundcard memory allocation
 */

/*
 * memory block
 */
struct snd_util_memblk {
    unsigned int size;        /* size of this block */
    unsigned int offset;        /* zero-offset of this block */
    struct list_head list;        /* link */
};

#define snd_util_memblk_argptr(blk)    (void*)((char*)(blk) + sizeof(struct snd_util_memblk))

/*
 * memory management information
 */
struct snd_util_memhdr {
    unsigned int size;        /* size of whole data */
    struct list_head block;        /* block linked-list header */
    int nblocks;            /* # of allocated blocks */
    unsigned int used;        /* used memory size */
    int block_extra_size;        /* extra data size of chunk */
    struct mutex block_mutex;    /* lock */
};

/*
 * prototypes
 */
struct snd_util_memhdr *snd_util_memhdr_new(int memsize);
void snd_util_memhdr_free(struct snd_util_memhdr *hdr);
struct snd_util_memblk *snd_util_mem_alloc(struct snd_util_memhdr *hdr, int size);
int snd_util_mem_free(struct snd_util_memhdr *hdr, struct snd_util_memblk *blk);
int snd_util_mem_avail(struct snd_util_memhdr *hdr);

/* functions without mutex */
struct snd_util_memblk *__snd_util_mem_alloc(struct snd_util_memhdr *hdr, int size);
void __snd_util_mem_free(struct snd_util_memhdr *hdr, struct snd_util_memblk *blk);
struct snd_util_memblk *__snd_util_memblk_new(struct snd_util_memhdr *hdr,
                          unsigned int units,
                          struct list_head *prev);

#endif /* __SOUND_UTIL_MEM_H */