aboutsummaryrefslogtreecommitdiffstats
path: root/lib/receiver.h
blob: b14da3597dba3e151d445d6bac9f15cdc2b257ee (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
/* PipeWire AGL Cluster IPC
 *
 * Copyright © 2021 Collabora Ltd.
 *    @author Julian Bouzas <julian.bouzas@collabora.com>
 *
 * SPDX-License-Identifier: MIT
 */

#ifndef __ICIPC_RECEIVER_H__
#define __ICIPC_RECEIVER_H__

#include <stdbool.h>
#include <stdint.h>
#include <stddef.h>

#include "defs.h"

#ifdef __cplusplus
extern "C" {
#endif

struct icipc_receiver;

enum icipc_receiver_sender_state {
        ICIPC_RECEIVER_SENDER_STATE_CONNECTED = 0,
        ICIPC_RECEIVER_SENDER_STATE_DISCONNECTED
};

struct icipc_receiver_events {
        /* emitted when a sender state changes */
        void (*sender_state)(
                        struct icipc_receiver *self,
                        int sender_fd,
                        enum icipc_receiver_sender_state state,
                        void *data);

        /* emitted when message is received and needs to be handled */
        bool (*handle_message)(
                        struct icipc_receiver *self,
                        int sender_fd,
                        const uint8_t *buffer,
                        size_t size,
                        void *data);
};

ICIPC_API
struct icipc_receiver *icipc_receiver_new(
                const char *path,
                size_t buffer_size,
                const struct icipc_receiver_events *events,
                void *events_data,
                size_t user_size);

ICIPC_API
void icipc_receiver_free(struct icipc_receiver *self);

ICIPC_API
bool icipc_receiver_start(struct icipc_receiver *self);

ICIPC_API
void icipc_receiver_stop(struct icipc_receiver *self);

ICIPC_API
bool icipc_receiver_is_running(struct icipc_receiver *self);

/* for subclasses only */

ICIPC_API
void *icipc_receiver_get_user_data(struct icipc_receiver *self);

#ifdef __cplusplus
}
#endif

#endif