rsocks 2.2.1

A super basic SOCKS5 proxy.
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
102
103
104

use std::sync::Arc;
use tokio::sync::{Mutex, MutexGuard};

pub struct BufferPool {
    buffer_size: usize,
    buffers: Vec<Arc<Mutex<Vec<u8>>>>,
}

impl BufferPool {
    pub fn new(buffer_size: usize) -> Self {
        BufferPool {
            buffer_size,
            buffers: Vec::<Arc<Mutex<Vec<u8>>>>::new(),
        }
    }

    pub fn lease(&mut self) -> Buffer {
        let mut free_buffer_index: Option<usize> = None;

        // Find an unleased buffer.
        for k in 0..self.buffers.len() {
            let ref_count = Arc::strong_count(&self.buffers[k]);
            if ref_count < 2 {
                free_buffer_index = Some(k);
                break;
            }
        }

        // Or, create a new one.
        if free_buffer_index.is_none() {
            free_buffer_index = Some(self.add_buffer());
        }

        assert_ne!(None, free_buffer_index);

        let index = free_buffer_index.unwrap();

        Buffer::new(self.buffers[index].clone())
    }

    pub fn leased_count(&self) -> usize {
        self.buffers.iter().filter(|b| Arc::strong_count(b) >= 2).count()
    }

    pub fn total_count(&self) -> usize {
        self.buffers.len()
    }

    fn add_buffer(&mut self) -> usize {
        self.buffers.push(Arc::new(Mutex::new(vec![0; self.buffer_size])));

        self.buffers.len() - 1
    }
}

pub struct Buffer {
    buffer: Arc<Mutex<Vec<u8>>>,
}

impl Buffer {
    fn new(buffer: Arc<Mutex<Vec<u8>>>) -> Buffer {
        Buffer { buffer }
    }

    pub async fn get(&mut self) -> MutexGuard<'_, Vec<u8>> {
        self.buffer.lock().await
    }
}

#[cfg(test)]
mod tests {
    use super::*;
    use pretty_assertions::assert_eq;

    #[test]
    fn lease_reuses_freed_buffers() {
        let mut pool = BufferPool::new(1024);
        assert_eq!(pool.total_count(), 0);

        let a = pool.lease();
        assert_eq!(pool.leased_count(), 1);
        assert_eq!(pool.total_count(), 1);

        // A second concurrent lease must allocate a new buffer.
        let b = pool.lease();
        assert_eq!(pool.total_count(), 2);

        // Dropping frees them; a subsequent lease reuses rather than growing the pool.
        drop(a);
        drop(b);
        assert_eq!(pool.leased_count(), 0);

        let _c = pool.lease();
        assert_eq!(pool.leased_count(), 1);
        assert_eq!(pool.total_count(), 2);
    }

    #[tokio::test]
    async fn leased_buffer_has_requested_size() {
        let mut pool = BufferPool::new(1500);
        let mut buffer = pool.lease();
        assert_eq!(buffer.get().await.len(), 1500);
    }
}