aboutsummaryrefslogtreecommitdiffstats
path: root/lib/receiver.h
blob: cf13e1bbb41caf991ca650ca17b1580d7ff1af58 (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
76
77
78
/* 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