/* SPDX-License-Identifier: GPL-2.0-or-later */
/*
 *   ALSA sequencer Client Manager
 *   Copyright (c) 1998-1999 by Frank van de Pol <fvdpol@coil.demon.nl>
 */
#ifndef __SND_SEQ_CLIENTMGR_H
#define __SND_SEQ_CLIENTMGR_H

#include <sound/seq_kernel.h>
#include <linux/bitops.h>
#include "seq_fifo.h"
#include "seq_ports.h"
#include "seq_lock.h"

/* client manager */

struct snd_seq_user_client {
        struct file *file;      /* file struct of client */
        /* ... */
        struct pid *owner;
        
        /* fifo */
        struct snd_seq_fifo *fifo;      /* queue for incoming events */
        int fifo_pool_size;
};

struct snd_seq_kernel_client {
        /* ... */
        struct snd_card *card;
};


struct snd_seq_client {
        snd_seq_client_type_t type;
        unsigned int accept_input: 1,
                accept_output: 1;
        unsigned int midi_version;
        unsigned int user_pversion;
        char name[64];          /* client name */
        int number;             /* client number */
        unsigned int filter;    /* filter flags */
        DECLARE_BITMAP(event_filter, 256);
        unsigned short group_filter;
        snd_use_lock_t use_lock;
        int event_lost;
        /* ports */
        int num_ports;          /* number of ports */
        struct list_head ports_list_head;
        rwlock_t ports_lock;
        struct mutex ports_mutex;
        struct mutex ioctl_mutex;
        int convert32;          /* convert 32->64bit */
        int ump_endpoint_port;

        /* output pool */
        struct snd_seq_pool *pool;              /* memory pool for this client */

        union {
                struct snd_seq_user_client user;
                struct snd_seq_kernel_client kernel;
        } data;

        /* for UMP */
        void **ump_info;
};

/* usage statistics */
struct snd_seq_usage {
        int cur;
        int peak;
};


int client_init_data(void);
int snd_sequencer_device_init(void);
void snd_sequencer_device_done(void);

/* get locked pointer to client */
struct snd_seq_client *snd_seq_client_use_ptr(int clientid);

static inline struct snd_seq_client *
snd_seq_client_ref(struct snd_seq_client *client)
{
        snd_use_lock_use(&client->use_lock);
        return client;
}

/* unlock pointer to client */
static inline void snd_seq_client_unref(struct snd_seq_client *client)
{
        snd_use_lock_free(&client->use_lock);
}

DEFINE_FREE(snd_seq_client, struct snd_seq_client *, if (!IS_ERR_OR_NULL(_T)) snd_seq_client_unref(_T))

/* dispatch event to client(s) */
int snd_seq_dispatch_event(struct snd_seq_event_cell *cell, int atomic, int hop);

int snd_seq_kernel_client_write_poll(int clientid, struct file *file, poll_table *wait);
int snd_seq_client_notify_subscription(int client, int port,
                                       struct snd_seq_port_subscribe *info, int evtype);

int __snd_seq_deliver_single_event(struct snd_seq_client *dest,
                                   struct snd_seq_client_port *dest_port,
                                   struct snd_seq_event *event,
                                   int atomic, int hop);

/* only for OSS sequencer */
int snd_seq_kernel_client_ioctl(int clientid, unsigned int cmd, void *arg);

extern int seq_client_load[15];

/* for internal use between kernel sequencer clients */
struct snd_seq_client *snd_seq_kernel_client_get(int client);
void snd_seq_kernel_client_put(struct snd_seq_client *cptr);

static inline bool snd_seq_client_is_ump(struct snd_seq_client *c)
{
        return c->midi_version != SNDRV_SEQ_CLIENT_LEGACY_MIDI;
}

static inline bool snd_seq_client_is_midi2(struct snd_seq_client *c)
{
        return c->midi_version == SNDRV_SEQ_CLIENT_UMP_MIDI_2_0;
}

#endif