tun2socks 0.0.1

High performance tun2socks
Documentation 
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
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101

/*
 ============================================================================
 Name        : hev-task-channel.h
 Author      : Heiher <r@hev.cc>
 Copyright   : Copyright (c) 2019 everyone.
 Description : Channel
 ============================================================================
 */

#ifndef __HEV_TASK_CHANNEL_H__
#define __HEV_TASK_CHANNEL_H__

#include <sys/types.h>

#ifdef __cplusplus
extern "C" {
#endif

typedef struct _HevTaskChannel HevTaskChannel;

/**
 * hev_task_channel_new:
 * @chan1: (out): a #HevTaskChannel
 * @chan2: (out): a #HevTaskChannel
 *
 * Creates a pair of connected task channel.
 * The channels are synchronous, both sides of the channel will wait until the
 * other side is ready.
 *
 * Returns: When successful, returns zero. When an error occurs, returns -1.
 *
 * Since: 4.5
 */
int hev_task_channel_new (HevTaskChannel **chan1, HevTaskChannel **chan2);

/**
 * hev_task_channel_new_with_buffers:
 * @chan1: (out): a #HevTaskChannel
 * @chan2: (out): a #HevTaskChannel
 * @size: buffer size
 * @buffers: buffers capacity
 *
 * Creates a pair of connected task channel with a capacity of @buffers.
 * The channels are asynchronous, sending or receiving a data will not wait
 * unless the channel is already full.
 *
 * Returns: When successful, returns zero. When an error occurs, returns -1.
 *
 * Since: 5.1.0
 */
int hev_task_channel_new_with_buffers (HevTaskChannel **chan1,
                                       HevTaskChannel **chan2,
                                       unsigned int size, unsigned int buffers);

/**
 * hev_task_channel_destroy:
 * @self: a #HevTaskChannel
 *
 * Destroy the task channel.
 *
 * Since: 4.5
 */
void hev_task_channel_destroy (HevTaskChannel *self);

/**
 * hev_task_channel_read:
 * @self: a #HevTaskChannel
 * @buffer: (array length=count): a buffer to read data into
 * @count: the number of bytes that will be read
 *
 * The read function shall attempt to read @count bytes from the channel into
 * @buffer. Just as datagram which the data transfer on task channel.
 *
 * Returns: the number of bytes actually read
 *
 * Since: 4.5
 */
ssize_t hev_task_channel_read (HevTaskChannel *self, void *buffer,
                               size_t count);

/**
 * hev_task_channel_write:
 * @self: a #HevTaskChannel
 * @buffer: (array length=count): a buffer to write data from
 * @count: the number of bytes that will be write
 *
 * The write function shall attempt to write @count bytes to the channel from
 * @buffer. Just as datagram which the data transfer on task channel.
 *
 * Returns: the number of bytes actually write
 *
 * Since: 4.5
 */
ssize_t hev_task_channel_write (HevTaskChannel *self, const void *buffer,
                                size_t count);

#ifdef __cplusplus
}
#endif

#endif /* __HEV_TASK_CHANNEL_H__ */