std/sys/net/connection/
socket.rs

Help
1#[cfg(test)]
2mod tests;
3
4use crate::ffi::{c_int, c_void};
5use crate::io::{self, BorrowedCursor, ErrorKind, IoSlice, IoSliceMut};
6use crate::net::{Ipv4Addr, Ipv6Addr, Shutdown, SocketAddr, SocketAddrV4, SocketAddrV6};
7use crate::sys::common::small_c_string::run_with_cstr;
8use crate::sys_common::{AsInner, FromInner};
9use crate::time::Duration;
10use crate::{cmp, fmt, mem, ptr};
11
12cfg_if::cfg_if! {
13    if #[cfg(target_os = "hermit")] {
14        mod hermit;
15        pub use hermit::*;
16    } else if #[cfg(target_os = "solid_asp3")] {
17        mod solid;
18        pub use solid::*;
19    } else if #[cfg(target_family = "unix")] {
20        mod unix;
21        pub use unix::*;
22    } else if #[cfg(all(target_os = "wasi", target_env = "p2"))] {
23        mod wasip2;
24        pub use wasip2::*;
25    } else if #[cfg(target_os = "windows")] {
26        mod windows;
27        pub use windows::*;
28    }
29}
30
31use netc as c;
32
33cfg_if::cfg_if! {
34    if #[cfg(any(
35        target_os = "dragonfly",
36        target_os = "freebsd",
37        target_os = "openbsd",
38        target_os = "netbsd",
39        target_os = "illumos",
40        target_os = "solaris",
41        target_os = "haiku",
42        target_os = "l4re",
43        target_os = "nto",
44        target_os = "nuttx",
45        target_vendor = "apple",
46    ))] {
47        use c::IPV6_JOIN_GROUP as IPV6_ADD_MEMBERSHIP;
48        use c::IPV6_LEAVE_GROUP as IPV6_DROP_MEMBERSHIP;
49    } else {
50        use c::IPV6_ADD_MEMBERSHIP;
51        use c::IPV6_DROP_MEMBERSHIP;
52    }
53}
54
55cfg_if::cfg_if! {
56    if #[cfg(any(
57        target_os = "linux", target_os = "android",
58        target_os = "hurd",
59        target_os = "dragonfly", target_os = "freebsd",
60        target_os = "openbsd", target_os = "netbsd",
61        target_os = "solaris", target_os = "illumos",
62        target_os = "haiku", target_os = "nto"))] {
63        use libc::MSG_NOSIGNAL;
64    } else {
65        const MSG_NOSIGNAL: c_int = 0x0;
66    }
67}
68
69cfg_if::cfg_if! {
70    if #[cfg(any(
71        target_os = "dragonfly", target_os = "freebsd",
72        target_os = "openbsd", target_os = "netbsd",
73        target_os = "solaris", target_os = "illumos",
74        target_os = "nto"))] {
75        use crate::ffi::c_uchar;
76        type IpV4MultiCastType = c_uchar;
77    } else {
78        type IpV4MultiCastType = c_int;
79    }
80}
81
82////////////////////////////////////////////////////////////////////////////////
83// address conversions
84////////////////////////////////////////////////////////////////////////////////
85
86fn ip_v4_addr_to_c(addr: &Ipv4Addr) -> c::in_addr {
87    // `s_addr` is stored as BE on all machines and the array is in BE order.
88    // So the native endian conversion method is used so that it's never swapped.
89    c::in_addr { s_addr: u32::from_ne_bytes(addr.octets()) }
90}
91
92fn ip_v6_addr_to_c(addr: &Ipv6Addr) -> c::in6_addr {
93    c::in6_addr { s6_addr: addr.octets() }
94}
95
96fn ip_v4_addr_from_c(addr: c::in_addr) -> Ipv4Addr {
97    Ipv4Addr::from(addr.s_addr.to_ne_bytes())
98}
99
100fn ip_v6_addr_from_c(addr: c::in6_addr) -> Ipv6Addr {
101    Ipv6Addr::from(addr.s6_addr)
102}
103
104fn socket_addr_v4_to_c(addr: &SocketAddrV4) -> c::sockaddr_in {
105    c::sockaddr_in {
106        sin_family: c::AF_INET as c::sa_family_t,
107        sin_port: addr.port().to_be(),
108        sin_addr: ip_v4_addr_to_c(addr.ip()),
109        ..unsafe { mem::zeroed() }
110    }
111}
112
113fn socket_addr_v6_to_c(addr: &SocketAddrV6) -> c::sockaddr_in6 {
114    c::sockaddr_in6 {
115        sin6_family: c::AF_INET6 as c::sa_family_t,
116        sin6_port: addr.port().to_be(),
117        sin6_addr: ip_v6_addr_to_c(addr.ip()),
118        sin6_flowinfo: addr.flowinfo(),
119        sin6_scope_id: addr.scope_id(),
120        ..unsafe { mem::zeroed() }
121    }
122}
123
124fn socket_addr_v4_from_c(addr: c::sockaddr_in) -> SocketAddrV4 {
125    SocketAddrV4::new(ip_v4_addr_from_c(addr.sin_addr), u16::from_be(addr.sin_port))
126}
127
128fn socket_addr_v6_from_c(addr: c::sockaddr_in6) -> SocketAddrV6 {
129    SocketAddrV6::new(
130        ip_v6_addr_from_c(addr.sin6_addr),
131        u16::from_be(addr.sin6_port),
132        addr.sin6_flowinfo,
133        addr.sin6_scope_id,
134    )
135}
136
137/// A type with the same memory layout as `c::sockaddr`. Used in converting Rust level
138/// SocketAddr* types into their system representation. The benefit of this specific
139/// type over using `c::sockaddr_storage` is that this type is exactly as large as it
140/// needs to be and not a lot larger. And it can be initialized more cleanly from Rust.
141#[repr(C)]
142union SocketAddrCRepr {
143    v4: c::sockaddr_in,
144    v6: c::sockaddr_in6,
145}
146
147impl SocketAddrCRepr {
148    fn as_ptr(&self) -> *const c::sockaddr {
149        self as *const _ as *const c::sockaddr
150    }
151}
152
153fn socket_addr_to_c(addr: &SocketAddr) -> (SocketAddrCRepr, c::socklen_t) {
154    match addr {
155        SocketAddr::V4(a) => {
156            let sockaddr = SocketAddrCRepr { v4: socket_addr_v4_to_c(a) };
157            (sockaddr, mem::size_of::<c::sockaddr_in>() as c::socklen_t)
158        }
159        SocketAddr::V6(a) => {
160            let sockaddr = SocketAddrCRepr { v6: socket_addr_v6_to_c(a) };
161            (sockaddr, mem::size_of::<c::sockaddr_in6>() as c::socklen_t)
162        }
163    }
164}
165
166unsafe fn socket_addr_from_c(
167    storage: *const c::sockaddr_storage,
168    len: usize,
169) -> io::Result<SocketAddr> {
170    match (*storage).ss_family as c_int {
171        c::AF_INET => {
172            assert!(len >= mem::size_of::<c::sockaddr_in>());
173            Ok(SocketAddr::V4(socket_addr_v4_from_c(unsafe {
174                *(storage as *const _ as *const c::sockaddr_in)
175            })))
176        }
177        c::AF_INET6 => {
178            assert!(len >= mem::size_of::<c::sockaddr_in6>());
179            Ok(SocketAddr::V6(socket_addr_v6_from_c(unsafe {
180                *(storage as *const _ as *const c::sockaddr_in6)
181            })))
182        }
183        _ => Err(io::const_error!(ErrorKind::InvalidInput, "invalid argument")),
184    }
185}
186
187////////////////////////////////////////////////////////////////////////////////
188// sockaddr and misc bindings
189////////////////////////////////////////////////////////////////////////////////
190
191pub fn setsockopt<T>(
192    sock: &Socket,
193    level: c_int,
194    option_name: c_int,
195    option_value: T,
196) -> io::Result<()> {
197    unsafe {
198        cvt(c::setsockopt(
199            sock.as_raw(),
200            level,
201            option_name,
202            (&raw const option_value) as *const _,
203            mem::size_of::<T>() as c::socklen_t,
204        ))?;
205        Ok(())
206    }
207}
208
209pub fn getsockopt<T: Copy>(sock: &Socket, level: c_int, option_name: c_int) -> io::Result<T> {
210    unsafe {
211        let mut option_value: T = mem::zeroed();
212        let mut option_len = mem::size_of::<T>() as c::socklen_t;
213        cvt(c::getsockopt(
214            sock.as_raw(),
215            level,
216            option_name,
217            (&raw mut option_value) as *mut _,
218            &mut option_len,
219        ))?;
220        Ok(option_value)
221    }
222}
223
224fn sockname<F>(f: F) -> io::Result<SocketAddr>
225where
226    F: FnOnce(*mut c::sockaddr, *mut c::socklen_t) -> c_int,
227{
228    unsafe {
229        let mut storage: c::sockaddr_storage = mem::zeroed();
230        let mut len = mem::size_of_val(&storage) as c::socklen_t;
231        cvt(f((&raw mut storage) as *mut _, &mut len))?;
232        socket_addr_from_c(&storage, len as usize)
233    }
234}
235
236#[cfg(target_os = "android")]
237fn to_ipv6mr_interface(value: u32) -> c_int {
238    value as c_int
239}
240
241#[cfg(not(target_os = "android"))]
242fn to_ipv6mr_interface(value: u32) -> crate::ffi::c_uint {
243    value as crate::ffi::c_uint
244}
245
246////////////////////////////////////////////////////////////////////////////////
247// get_host_addresses
248////////////////////////////////////////////////////////////////////////////////
249
250pub struct LookupHost {
251    original: *mut c::addrinfo,
252    cur: *mut c::addrinfo,
253    port: u16,
254}
255
256impl LookupHost {
257    pub fn port(&self) -> u16 {
258        self.port
259    }
260}
261
262impl Iterator for LookupHost {
263    type Item = SocketAddr;
264    fn next(&mut self) -> Option<SocketAddr> {
265        loop {
266            unsafe {
267                let cur = self.cur.as_ref()?;
268                self.cur = cur.ai_next;
269                match socket_addr_from_c(cur.ai_addr.cast(), cur.ai_addrlen as usize) {
270                    Ok(addr) => return Some(addr),
271                    Err(_) => continue,
272                }
273            }
274        }
275    }
276}
277
278unsafe impl Sync for LookupHost {}
279unsafe impl Send for LookupHost {}
280
281impl Drop for LookupHost {
282    fn drop(&mut self) {
283        unsafe { c::freeaddrinfo(self.original) }
284    }
285}
286
287impl TryFrom<&str> for LookupHost {
288    type Error = io::Error;
289
290    fn try_from(s: &str) -> io::Result<LookupHost> {
291        macro_rules! try_opt {
292            ($e:expr, $msg:expr) => {
293                match $e {
294                    Some(r) => r,
295                    None => return Err(io::const_error!(io::ErrorKind::InvalidInput, $msg)),
296                }
297            };
298        }
299
300        // split the string by ':' and convert the second part to u16
301        let (host, port_str) = try_opt!(s.rsplit_once(':'), "invalid socket address");
302        let port: u16 = try_opt!(port_str.parse().ok(), "invalid port value");
303        (host, port).try_into()
304    }
305}
306
307impl<'a> TryFrom<(&'a str, u16)> for LookupHost {
308    type Error = io::Error;
309
310    fn try_from((host, port): (&'a str, u16)) -> io::Result<LookupHost> {
311        init();
312
313        run_with_cstr(host.as_bytes(), &|c_host| {
314            let mut hints: c::addrinfo = unsafe { mem::zeroed() };
315            hints.ai_socktype = c::SOCK_STREAM;
316            let mut res = ptr::null_mut();
317            unsafe {
318                cvt_gai(c::getaddrinfo(c_host.as_ptr(), ptr::null(), &hints, &mut res))
319                    .map(|_| LookupHost { original: res, cur: res, port })
320            }
321        })
322    }
323}
324
325////////////////////////////////////////////////////////////////////////////////
326// TCP streams
327////////////////////////////////////////////////////////////////////////////////
328
329pub struct TcpStream {
330    inner: Socket,
331}
332
333impl TcpStream {
334    pub fn connect(addr: io::Result<&SocketAddr>) -> io::Result<TcpStream> {
335        let addr = addr?;
336
337        init();
338
339        let sock = Socket::new(addr, c::SOCK_STREAM)?;
340        sock.connect(addr)?;
341        Ok(TcpStream { inner: sock })
342    }
343
344    pub fn connect_timeout(addr: &SocketAddr, timeout: Duration) -> io::Result<TcpStream> {
345        init();
346
347        let sock = Socket::new(addr, c::SOCK_STREAM)?;
348        sock.connect_timeout(addr, timeout)?;
349        Ok(TcpStream { inner: sock })
350    }
351
352    #[inline]
353    pub fn socket(&self) -> &Socket {
354        &self.inner
355    }
356
357    pub fn into_socket(self) -> Socket {
358        self.inner
359    }
360
361    pub fn set_read_timeout(&self, dur: Option<Duration>) -> io::Result<()> {
362        self.inner.set_timeout(dur, c::SO_RCVTIMEO)
363    }
364
365    pub fn set_write_timeout(&self, dur: Option<Duration>) -> io::Result<()> {
366        self.inner.set_timeout(dur, c::SO_SNDTIMEO)
367    }
368
369    pub fn read_timeout(&self) -> io::Result<Option<Duration>> {
370        self.inner.timeout(c::SO_RCVTIMEO)
371    }
372
373    pub fn write_timeout(&self) -> io::Result<Option<Duration>> {
374        self.inner.timeout(c::SO_SNDTIMEO)
375    }
376
377    pub fn peek(&self, buf: &mut [u8]) -> io::Result<usize> {
378        self.inner.peek(buf)
379    }
380
381    pub fn read(&self, buf: &mut [u8]) -> io::Result<usize> {
382        self.inner.read(buf)
383    }
384
385    pub fn read_buf(&self, buf: BorrowedCursor<'_>) -> io::Result<()> {
386        self.inner.read_buf(buf)
387    }
388
389    pub fn read_vectored(&self, bufs: &mut [IoSliceMut<'_>]) -> io::Result<usize> {
390        self.inner.read_vectored(bufs)
391    }
392
393    #[inline]
394    pub fn is_read_vectored(&self) -> bool {
395        self.inner.is_read_vectored()
396    }
397
398    pub fn write(&self, buf: &[u8]) -> io::Result<usize> {
399        let len = cmp::min(buf.len(), <wrlen_t>::MAX as usize) as wrlen_t;
400        let ret = cvt(unsafe {
401            c::send(self.inner.as_raw(), buf.as_ptr() as *const c_void, len, MSG_NOSIGNAL)
402        })?;
403        Ok(ret as usize)
404    }
405
406    pub fn write_vectored(&self, bufs: &[IoSlice<'_>]) -> io::Result<usize> {
407        self.inner.write_vectored(bufs)
408    }
409
410    #[inline]
411    pub fn is_write_vectored(&self) -> bool {
412        self.inner.is_write_vectored()
413    }
414
415    pub fn peer_addr(&self) -> io::Result<SocketAddr> {
416        sockname(|buf, len| unsafe { c::getpeername(self.inner.as_raw(), buf, len) })
417    }
418
419    pub fn socket_addr(&self) -> io::Result<SocketAddr> {
420        sockname(|buf, len| unsafe { c::getsockname(self.inner.as_raw(), buf, len) })
421    }
422
423    pub fn shutdown(&self, how: Shutdown) -> io::Result<()> {
424        self.inner.shutdown(how)
425    }
426
427    pub fn duplicate(&self) -> io::Result<TcpStream> {
428        self.inner.duplicate().map(|s| TcpStream { inner: s })
429    }
430
431    pub fn set_linger(&self, linger: Option<Duration>) -> io::Result<()> {
432        self.inner.set_linger(linger)
433    }
434
435    pub fn linger(&self) -> io::Result<Option<Duration>> {
436        self.inner.linger()
437    }
438
439    pub fn set_nodelay(&self, nodelay: bool) -> io::Result<()> {
440        self.inner.set_nodelay(nodelay)
441    }
442
443    pub fn nodelay(&self) -> io::Result<bool> {
444        self.inner.nodelay()
445    }
446
447    pub fn set_ttl(&self, ttl: u32) -> io::Result<()> {
448        setsockopt(&self.inner, c::IPPROTO_IP, c::IP_TTL, ttl as c_int)
449    }
450
451    pub fn ttl(&self) -> io::Result<u32> {
452        let raw: c_int = getsockopt(&self.inner, c::IPPROTO_IP, c::IP_TTL)?;
453        Ok(raw as u32)
454    }
455
456    pub fn take_error(&self) -> io::Result<Option<io::Error>> {
457        self.inner.take_error()
458    }
459
460    pub fn set_nonblocking(&self, nonblocking: bool) -> io::Result<()> {
461        self.inner.set_nonblocking(nonblocking)
462    }
463}
464
465impl AsInner<Socket> for TcpStream {
466    #[inline]
467    fn as_inner(&self) -> &Socket {
468        &self.inner
469    }
470}
471
472impl FromInner<Socket> for TcpStream {
473    fn from_inner(socket: Socket) -> TcpStream {
474        TcpStream { inner: socket }
475    }
476}
477
478impl fmt::Debug for TcpStream {
479    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
480        let mut res = f.debug_struct("TcpStream");
481
482        if let Ok(addr) = self.socket_addr() {
483            res.field("addr", &addr);
484        }
485
486        if let Ok(peer) = self.peer_addr() {
487            res.field("peer", &peer);
488        }
489
490        let name = if cfg!(windows) { "socket" } else { "fd" };
491        res.field(name, &self.inner.as_raw()).finish()
492    }
493}
494
495////////////////////////////////////////////////////////////////////////////////
496// TCP listeners
497////////////////////////////////////////////////////////////////////////////////
498
499pub struct TcpListener {
500    inner: Socket,
501}
502
503impl TcpListener {
504    pub fn bind(addr: io::Result<&SocketAddr>) -> io::Result<TcpListener> {
505        let addr = addr?;
506
507        init();
508
509        let sock = Socket::new(addr, c::SOCK_STREAM)?;
510
511        // On platforms with Berkeley-derived sockets, this allows to quickly
512        // rebind a socket, without needing to wait for the OS to clean up the
513        // previous one.
514        //
515        // On Windows, this allows rebinding sockets which are actively in use,
516        // which allows “socket hijacking”, so we explicitly don't set it here.
517        // https://docs.microsoft.com/en-us/windows/win32/winsock/using-so-reuseaddr-and-so-exclusiveaddruse
518        #[cfg(not(windows))]
519        setsockopt(&sock, c::SOL_SOCKET, c::SO_REUSEADDR, 1 as c_int)?;
520
521        // Bind our new socket
522        let (addr, len) = socket_addr_to_c(addr);
523        cvt(unsafe { c::bind(sock.as_raw(), addr.as_ptr(), len as _) })?;
524
525        cfg_if::cfg_if! {
526            if #[cfg(target_os = "horizon")] {
527                // The 3DS doesn't support a big connection backlog. Sometimes
528                // it allows up to about 37, but other times it doesn't even
529                // accept 32. There may be a global limitation causing this.
530                let backlog = 20;
531            } else if #[cfg(target_os = "haiku")] {
532                // Haiku does not support a queue length > 32
533                // https://github.com/haiku/haiku/blob/979a0bc487864675517fb2fab28f87dc8bf43041/headers/posix/sys/socket.h#L81
534                let backlog = 32;
535            } else {
536                // The default for all other platforms
537                let backlog = 128;
538            }
539        }
540
541        // Start listening
542        cvt(unsafe { c::listen(sock.as_raw(), backlog) })?;
543        Ok(TcpListener { inner: sock })
544    }
545
546    #[inline]
547    pub fn socket(&self) -> &Socket {
548        &self.inner
549    }
550
551    pub fn into_socket(self) -> Socket {
552        self.inner
553    }
554
555    pub fn socket_addr(&self) -> io::Result<SocketAddr> {
556        sockname(|buf, len| unsafe { c::getsockname(self.inner.as_raw(), buf, len) })
557    }
558
559    pub fn accept(&self) -> io::Result<(TcpStream, SocketAddr)> {
560        let mut storage: c::sockaddr_storage = unsafe { mem::zeroed() };
561        let mut len = mem::size_of_val(&storage) as c::socklen_t;
562        let sock = self.inner.accept((&raw mut storage) as *mut _, &mut len)?;
563        let addr = unsafe { socket_addr_from_c(&storage, len as usize)? };
564        Ok((TcpStream { inner: sock }, addr))
565    }
566
567    pub fn duplicate(&self) -> io::Result<TcpListener> {
568        self.inner.duplicate().map(|s| TcpListener { inner: s })
569    }
570
571    pub fn set_ttl(&self, ttl: u32) -> io::Result<()> {
572        setsockopt(&self.inner, c::IPPROTO_IP, c::IP_TTL, ttl as c_int)
573    }
574
575    pub fn ttl(&self) -> io::Result<u32> {
576        let raw: c_int = getsockopt(&self.inner, c::IPPROTO_IP, c::IP_TTL)?;
577        Ok(raw as u32)
578    }
579
580    pub fn set_only_v6(&self, only_v6: bool) -> io::Result<()> {
581        setsockopt(&self.inner, c::IPPROTO_IPV6, c::IPV6_V6ONLY, only_v6 as c_int)
582    }
583
584    pub fn only_v6(&self) -> io::Result<bool> {
585        let raw: c_int = getsockopt(&self.inner, c::IPPROTO_IPV6, c::IPV6_V6ONLY)?;
586        Ok(raw != 0)
587    }
588
589    pub fn take_error(&self) -> io::Result<Option<io::Error>> {
590        self.inner.take_error()
591    }
592
593    pub fn set_nonblocking(&self, nonblocking: bool) -> io::Result<()> {
594        self.inner.set_nonblocking(nonblocking)
595    }
596}
597
598impl FromInner<Socket> for TcpListener {
599    fn from_inner(socket: Socket) -> TcpListener {
600        TcpListener { inner: socket }
601    }
602}
603
604impl fmt::Debug for TcpListener {
605    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
606        let mut res = f.debug_struct("TcpListener");
607
608        if let Ok(addr) = self.socket_addr() {
609            res.field("addr", &addr);
610        }
611
612        let name = if cfg!(windows) { "socket" } else { "fd" };
613        res.field(name, &self.inner.as_raw()).finish()
614    }
615}
616
617////////////////////////////////////////////////////////////////////////////////
618// UDP
619////////////////////////////////////////////////////////////////////////////////
620
621pub struct UdpSocket {
622    inner: Socket,
623}
624
625impl UdpSocket {
626    pub fn bind(addr: io::Result<&SocketAddr>) -> io::Result<UdpSocket> {
627        let addr = addr?;
628
629        init();
630
631        let sock = Socket::new(addr, c::SOCK_DGRAM)?;
632        let (addr, len) = socket_addr_to_c(addr);
633        cvt(unsafe { c::bind(sock.as_raw(), addr.as_ptr(), len as _) })?;
634        Ok(UdpSocket { inner: sock })
635    }
636
637    #[inline]
638    pub fn socket(&self) -> &Socket {
639        &self.inner
640    }
641
642    pub fn into_socket(self) -> Socket {
643        self.inner
644    }
645
646    pub fn peer_addr(&self) -> io::Result<SocketAddr> {
647        sockname(|buf, len| unsafe { c::getpeername(self.inner.as_raw(), buf, len) })
648    }
649
650    pub fn socket_addr(&self) -> io::Result<SocketAddr> {
651        sockname(|buf, len| unsafe { c::getsockname(self.inner.as_raw(), buf, len) })
652    }
653
654    pub fn recv_from(&self, buf: &mut [u8]) -> io::Result<(usize, SocketAddr)> {
655        self.inner.recv_from(buf)
656    }
657
658    pub fn peek_from(&self, buf: &mut [u8]) -> io::Result<(usize, SocketAddr)> {
659        self.inner.peek_from(buf)
660    }
661
662    pub fn send_to(&self, buf: &[u8], dst: &SocketAddr) -> io::Result<usize> {
663        let len = cmp::min(buf.len(), <wrlen_t>::MAX as usize) as wrlen_t;
664        let (dst, dstlen) = socket_addr_to_c(dst);
665        let ret = cvt(unsafe {
666            c::sendto(
667                self.inner.as_raw(),
668                buf.as_ptr() as *const c_void,
669                len,
670                MSG_NOSIGNAL,
671                dst.as_ptr(),
672                dstlen,
673            )
674        })?;
675        Ok(ret as usize)
676    }
677
678    pub fn duplicate(&self) -> io::Result<UdpSocket> {
679        self.inner.duplicate().map(|s| UdpSocket { inner: s })
680    }
681
682    pub fn set_read_timeout(&self, dur: Option<Duration>) -> io::Result<()> {
683        self.inner.set_timeout(dur, c::SO_RCVTIMEO)
684    }
685
686    pub fn set_write_timeout(&self, dur: Option<Duration>) -> io::Result<()> {
687        self.inner.set_timeout(dur, c::SO_SNDTIMEO)
688    }
689
690    pub fn read_timeout(&self) -> io::Result<Option<Duration>> {
691        self.inner.timeout(c::SO_RCVTIMEO)
692    }
693
694    pub fn write_timeout(&self) -> io::Result<Option<Duration>> {
695        self.inner.timeout(c::SO_SNDTIMEO)
696    }
697
698    pub fn set_broadcast(&self, broadcast: bool) -> io::Result<()> {
699        setsockopt(&self.inner, c::SOL_SOCKET, c::SO_BROADCAST, broadcast as c_int)
700    }
701
702    pub fn broadcast(&self) -> io::Result<bool> {
703        let raw: c_int = getsockopt(&self.inner, c::SOL_SOCKET, c::SO_BROADCAST)?;
704        Ok(raw != 0)
705    }
706
707    pub fn set_multicast_loop_v4(&self, multicast_loop_v4: bool) -> io::Result<()> {
708        setsockopt(
709            &self.inner,
710            c::IPPROTO_IP,
711            c::IP_MULTICAST_LOOP,
712            multicast_loop_v4 as IpV4MultiCastType,
713        )
714    }
715
716    pub fn multicast_loop_v4(&self) -> io::Result<bool> {
717        let raw: IpV4MultiCastType = getsockopt(&self.inner, c::IPPROTO_IP, c::IP_MULTICAST_LOOP)?;
718        Ok(raw != 0)
719    }
720
721    pub fn set_multicast_ttl_v4(&self, multicast_ttl_v4: u32) -> io::Result<()> {
722        setsockopt(
723            &self.inner,
724            c::IPPROTO_IP,
725            c::IP_MULTICAST_TTL,
726            multicast_ttl_v4 as IpV4MultiCastType,
727        )
728    }
729
730    pub fn multicast_ttl_v4(&self) -> io::Result<u32> {
731        let raw: IpV4MultiCastType = getsockopt(&self.inner, c::IPPROTO_IP, c::IP_MULTICAST_TTL)?;
732        Ok(raw as u32)
733    }
734
735    pub fn set_multicast_loop_v6(&self, multicast_loop_v6: bool) -> io::Result<()> {
736        setsockopt(&self.inner, c::IPPROTO_IPV6, c::IPV6_MULTICAST_LOOP, multicast_loop_v6 as c_int)
737    }
738
739    pub fn multicast_loop_v6(&self) -> io::Result<bool> {
740        let raw: c_int = getsockopt(&self.inner, c::IPPROTO_IPV6, c::IPV6_MULTICAST_LOOP)?;
741        Ok(raw != 0)
742    }
743
744    pub fn join_multicast_v4(&self, multiaddr: &Ipv4Addr, interface: &Ipv4Addr) -> io::Result<()> {
745        let mreq = c::ip_mreq {
746            imr_multiaddr: ip_v4_addr_to_c(multiaddr),
747            imr_interface: ip_v4_addr_to_c(interface),
748        };
749        setsockopt(&self.inner, c::IPPROTO_IP, c::IP_ADD_MEMBERSHIP, mreq)
750    }
751
752    pub fn join_multicast_v6(&self, multiaddr: &Ipv6Addr, interface: u32) -> io::Result<()> {
753        let mreq = c::ipv6_mreq {
754            ipv6mr_multiaddr: ip_v6_addr_to_c(multiaddr),
755            ipv6mr_interface: to_ipv6mr_interface(interface),
756        };
757        setsockopt(&self.inner, c::IPPROTO_IPV6, IPV6_ADD_MEMBERSHIP, mreq)
758    }
759
760    pub fn leave_multicast_v4(&self, multiaddr: &Ipv4Addr, interface: &Ipv4Addr) -> io::Result<()> {
761        let mreq = c::ip_mreq {
762            imr_multiaddr: ip_v4_addr_to_c(multiaddr),
763            imr_interface: ip_v4_addr_to_c(interface),
764        };
765        setsockopt(&self.inner, c::IPPROTO_IP, c::IP_DROP_MEMBERSHIP, mreq)
766    }
767
768    pub fn leave_multicast_v6(&self, multiaddr: &Ipv6Addr, interface: u32) -> io::Result<()> {
769        let mreq = c::ipv6_mreq {
770            ipv6mr_multiaddr: ip_v6_addr_to_c(multiaddr),
771            ipv6mr_interface: to_ipv6mr_interface(interface),
772        };
773        setsockopt(&self.inner, c::IPPROTO_IPV6, IPV6_DROP_MEMBERSHIP, mreq)
774    }
775
776    pub fn set_ttl(&self, ttl: u32) -> io::Result<()> {
777        setsockopt(&self.inner, c::IPPROTO_IP, c::IP_TTL, ttl as c_int)
778    }
779
780    pub fn ttl(&self) -> io::Result<u32> {
781        let raw: c_int = getsockopt(&self.inner, c::IPPROTO_IP, c::IP_TTL)?;
782        Ok(raw as u32)
783    }
784
785    pub fn take_error(&self) -> io::Result<Option<io::Error>> {
786        self.inner.take_error()
787    }
788
789    pub fn set_nonblocking(&self, nonblocking: bool) -> io::Result<()> {
790        self.inner.set_nonblocking(nonblocking)
791    }
792
793    pub fn recv(&self, buf: &mut [u8]) -> io::Result<usize> {
794        self.inner.read(buf)
795    }
796
797    pub fn peek(&self, buf: &mut [u8]) -> io::Result<usize> {
798        self.inner.peek(buf)
799    }
800
801    pub fn send(&self, buf: &[u8]) -> io::Result<usize> {
802        let len = cmp::min(buf.len(), <wrlen_t>::MAX as usize) as wrlen_t;
803        let ret = cvt(unsafe {
804            c::send(self.inner.as_raw(), buf.as_ptr() as *const c_void, len, MSG_NOSIGNAL)
805        })?;
806        Ok(ret as usize)
807    }
808
809    pub fn connect(&self, addr: io::Result<&SocketAddr>) -> io::Result<()> {
810        let (addr, len) = socket_addr_to_c(addr?);
811        cvt_r(|| unsafe { c::connect(self.inner.as_raw(), addr.as_ptr(), len) }).map(drop)
812    }
813}
814
815impl FromInner<Socket> for UdpSocket {
816    fn from_inner(socket: Socket) -> UdpSocket {
817        UdpSocket { inner: socket }
818    }
819}
820
821impl fmt::Debug for UdpSocket {
822    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
823        let mut res = f.debug_struct("UdpSocket");
824
825        if let Ok(addr) = self.socket_addr() {
826            res.field("addr", &addr);
827        }
828
829        let name = if cfg!(windows) { "socket" } else { "fd" };
830        res.field(name, &self.inner.as_raw()).finish()
831    }
832}
std/sys/net/connection/socket.rs

std/sys/net/connection/
socket.rs
