Enum nix::sys::socket::ControlMessageOwned [−][src]
pub enum ControlMessageOwned { ScmRights(Vec<RawFd>), ScmTimestamp(TimeVal), Ipv4PacketInfo(in_pktinfo), Ipv6PacketInfo(in6_pktinfo), Ipv4RecvIf(sockaddr_dl), Ipv4RecvDstAddr(in_addr), // some variants omitted }
Expand description
A type-safe wrapper around a single control message, as used with
recvmsg
.
Variants
Received version of
[ControlMessage::ScmRights
][#enum.ControlMessage.html#variant.ScmRights]
A message of type SCM_TIMESTAMP
, containing the time the
packet was received by the kernel.
See the kernel’s explanation in “SO_TIMESTAMP” of networking/timestamping.
Examples
// Set up let message = "Ohayō!".as_bytes(); let in_socket = socket( AddressFamily::Inet, SockType::Datagram, SockFlag::empty(), None).unwrap(); setsockopt(in_socket, sockopt::ReceiveTimestamp, &true).unwrap(); let localhost = InetAddr::new(IpAddr::new_v4(127, 0, 0, 1), 0); bind(in_socket, &SockAddr::new_inet(localhost)).unwrap(); let address = getsockname(in_socket).unwrap(); // Get initial time let time0 = SystemTime::now(); // Send the message let iov = [IoVec::from_slice(message)]; let flags = MsgFlags::empty(); let l = sendmsg(in_socket, &iov, &[], flags, Some(&address)).unwrap(); assert_eq!(message.len(), l); // Receive the message let mut buffer = vec![0u8; message.len()]; let mut cmsgspace = cmsg_space!(TimeVal); let iov = [IoVec::from_mut_slice(&mut buffer)]; let r = recvmsg(in_socket, &iov, Some(&mut cmsgspace), flags).unwrap(); let rtime = match r.cmsgs().next() { Some(ControlMessageOwned::ScmTimestamp(rtime)) => rtime, Some(_) => panic!("Unexpected control message"), None => panic!("No control message") }; // Check the final time let time1 = SystemTime::now(); // the packet's received timestamp should lie in-between the two system // times, unless the system clock was adjusted in the meantime. let rduration = Duration::new(rtime.tv_sec() as u64, rtime.tv_usec() as u32 * 1000); assert!(time0.duration_since(UNIX_EPOCH).unwrap() <= rduration); assert!(rduration <= time1.duration_since(UNIX_EPOCH).unwrap()); // Close socket nix::unistd::close(in_socket).unwrap();
Tuple Fields of ScmTimestamp
0: TimeVal
Tuple Fields of Ipv4PacketInfo
0: in_pktinfo
Tuple Fields of Ipv6PacketInfo
0: in6_pktinfo
Tuple Fields of Ipv4RecvIf
0: sockaddr_dl
Tuple Fields of Ipv4RecvDstAddr
0: in_addr
Trait Implementations
This method tests for self
and other
values to be equal, and is used
by ==
. Read more
This method tests for !=
.
Auto Trait Implementations
impl RefUnwindSafe for ControlMessageOwned
impl Send for ControlMessageOwned
impl Sync for ControlMessageOwned
impl Unpin for ControlMessageOwned
impl UnwindSafe for ControlMessageOwned
Blanket Implementations
Mutably borrows from an owned value. Read more