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
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
|
use crate::net::{TcpStream, TcpListener};
use crate::sys;
use std::io;
use std::mem;
use std::net::SocketAddr;
use std::time::Duration;
#[cfg(unix)]
use std::os::unix::io::{AsRawFd, RawFd, FromRawFd};
#[cfg(windows)]
use std::os::windows::io::{AsRawSocket, FromRawSocket, IntoRawSocket, RawSocket};
/// A non-blocking TCP socket used to configure a stream or listener.
///
/// The `TcpSocket` type wraps the operating-system's socket handle. This type
/// is used to configure the socket before establishing a connection or start
/// listening for inbound connections.
///
/// The socket will be closed when the value is dropped.
#[derive(Debug)]
pub struct TcpSocket {
sys: sys::tcp::TcpSocket,
}
impl TcpSocket {
/// Create a new IPv4 TCP socket.
///
/// This calls `socket(2)`.
pub fn new_v4() -> io::Result<TcpSocket> {
sys::tcp::new_v4_socket().map(|sys| TcpSocket {
sys
})
}
/// Create a new IPv6 TCP socket.
///
/// This calls `socket(2)`.
pub fn new_v6() -> io::Result<TcpSocket> {
sys::tcp::new_v6_socket().map(|sys| TcpSocket {
sys
})
}
pub(crate) fn new_for_addr(addr: SocketAddr) -> io::Result<TcpSocket> {
if addr.is_ipv4() {
TcpSocket::new_v4()
} else {
TcpSocket::new_v6()
}
}
/// Bind `addr` to the TCP socket.
pub fn bind(&self, addr: SocketAddr) -> io::Result<()> {
sys::tcp::bind(self.sys, addr)
}
/// Connect the socket to `addr`.
///
/// This consumes the socket and performs the connect operation. Once the
/// connection completes, the socket is now a non-blocking `TcpStream` and
/// can be used as such.
pub fn connect(self, addr: SocketAddr) -> io::Result<TcpStream> {
let stream = sys::tcp::connect(self.sys, addr)?;
// Don't close the socket
mem::forget(self);
Ok(TcpStream::from_std(stream))
}
/// Listen for inbound connections, converting the socket to a
/// `TcpListener`.
pub fn listen(self, backlog: u32) -> io::Result<TcpListener> {
let listener = sys::tcp::listen(self.sys, backlog)?;
// Don't close the socket
mem::forget(self);
Ok(TcpListener::from_std(listener))
}
/// Sets the value of `SO_REUSEADDR` on this socket.
pub fn set_reuseaddr(&self, reuseaddr: bool) -> io::Result<()> {
sys::tcp::set_reuseaddr(self.sys, reuseaddr)
}
/// Get the value of `SO_REUSEADDR` set on this socket.
pub fn get_reuseaddr(&self) -> io::Result<bool> {
sys::tcp::get_reuseaddr(self.sys)
}
/// Sets the value of `SO_REUSEPORT` on this socket.
/// Only supported available in unix
#[cfg(all(unix, not(any(target_os = "solaris", target_os = "illumos"))))]
pub fn set_reuseport(&self, reuseport: bool) -> io::Result<()> {
sys::tcp::set_reuseport(self.sys, reuseport)
}
/// Get the value of `SO_REUSEPORT` set on this socket.
/// Only supported available in unix
#[cfg(all(unix, not(any(target_os = "solaris", target_os = "illumos"))))]
pub fn get_reuseport(&self) -> io::Result<bool> {
sys::tcp::get_reuseport(self.sys)
}
/// Sets the value of `SO_LINGER` on this socket.
pub fn set_linger(&self, dur: Option<Duration>) -> io::Result<()> {
sys::tcp::set_linger(self.sys, dur)
}
/// Returns the local address of this socket
///
/// Will return `Err` result in windows if called before calling `bind`
pub fn get_localaddr(&self) -> io::Result<SocketAddr> {
sys::tcp::get_localaddr(self.sys)
}
}
impl Drop for TcpSocket {
fn drop(&mut self) {
sys::tcp::close(self.sys);
}
}
#[cfg(unix)]
impl AsRawFd for TcpSocket {
fn as_raw_fd(&self) -> RawFd {
self.sys
}
}
#[cfg(unix)]
impl FromRawFd for TcpSocket {
/// Converts a `RawFd` to a `TcpSocket`.
///
/// # Notes
///
/// The caller is responsible for ensuring that the socket is in
/// non-blocking mode.
unsafe fn from_raw_fd(fd: RawFd) -> TcpSocket {
TcpSocket { sys: fd }
}
}
#[cfg(windows)]
impl IntoRawSocket for TcpSocket {
fn into_raw_socket(self) -> RawSocket {
// The winapi crate defines `SOCKET` as `usize`. The Rust std
// conditionally defines `RawSocket` as a fixed size unsigned integer
// matching the pointer width. These end up being the same type but we
// must cast between them.
let ret = self.sys as RawSocket;
// Avoid closing the socket
mem::forget(self);
ret
}
}
#[cfg(windows)]
impl AsRawSocket for TcpSocket {
fn as_raw_socket(&self) -> RawSocket {
self.sys as RawSocket
}
}
#[cfg(windows)]
impl FromRawSocket for TcpSocket {
/// Converts a `RawSocket` to a `TcpSocket`.
///
/// # Notes
///
/// The caller is responsible for ensuring that the socket is in
/// non-blocking mode.
unsafe fn from_raw_socket(socket: RawSocket) -> TcpSocket {
TcpSocket { sys: socket as sys::tcp::TcpSocket }
}
}
|
