Class: OpenC3::UdpReadWriteSocket

Inherits:
Object
  • Object
show all
Defined in:
lib/openc3/io/udp_sockets.rb

Direct Known Subclasses

UdpReadSocket, UdpWriteSocket

Constant Summary collapse

HOST_0_0_0_0 = 
'0.0.0.0'
WRITE_FLAGS =

MSG_DONTWAIT is not defined on Windows where sends are left blocking

Socket.const_defined?('MSG_DONTWAIT') ? Socket::MSG_DONTWAIT : 0

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(bind_port = 0, bind_address = HOST_0_0_0_0, external_port = nil, external_address = nil, multicast_interface_address = nil, ttl = 1, read_multicast = true, write_multicast = true, connect_socket = true) ⇒ UdpReadWriteSocket 



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
 
# File 'lib/openc3/io/udp_sockets.rb', line 43

def initialize(
  bind_port = 0,
  bind_address = HOST_0_0_0_0,
  external_port = nil,
  external_address = nil,
  multicast_interface_address = nil,
  ttl = 1,
  read_multicast = true,
  write_multicast = true,
  connect_socket = true
)

  @socket = UDPSocket.new
  @external_address = external_address
  @external_port = external_port
  @connect_socket = connect_socket
  # Resolve the destination once at creation time so writes don't pay for a
  # (potentially blocking) name lookup on every datagram
  @external_sockaddr = nil
  if !connect_socket and external_address and external_port
    # Explicitly resolve IPv4 because UDPSocket is an AF_INET socket and
    # sockaddr_in would otherwise hand back an IPv6 address for names like localhost
    ip_address = Socket.getaddrinfo(external_address, nil, Socket::AF_INET, Socket::SOCK_DGRAM)[0][3]
    @external_sockaddr = Socket.sockaddr_in(external_port, ip_address)
  end

  # Basic setup to reuse address
  @socket.setsockopt(Socket::SOL_SOCKET, Socket::SO_REUSEADDR, 1)

  # Bind to local address and port - This sets recv port, write_src port, recv_address, and write_src_address
  @socket.bind(bind_address, bind_port) if bind_address and bind_port

  # Default send to the specified address and port
  @socket.connect(external_address, external_port) if connect_socket and external_address and external_port

  # Handle multicast
  if UdpReadWriteSocket.multicast?(external_address)
    if write_multicast
      # Basic setup set time to live
      @socket.setsockopt(Socket::IPPROTO_IP, Socket::IP_MULTICAST_TTL, ttl.to_i)

      # Set outgoing interface
      @socket.setsockopt(
        Socket::IPPROTO_IP,
        Socket::IP_MULTICAST_IF,
        IPAddr.new(multicast_interface_address).hton
      ) if multicast_interface_address
    end

    # Receive messages sent to the multicast address
    if read_multicast
      multicast_interface_address = HOST_0_0_0_0 unless multicast_interface_address
      membership = IPAddr.new(external_address).hton + IPAddr.new(multicast_interface_address).hton
      @socket.setsockopt(Socket::IPPROTO_IP, Socket::IP_ADD_MEMBERSHIP, membership)
    end
  end
end

Dynamic Method Handling

This class handles dynamic methods through the method_missing method

#method_missing(method, *args, &block) ⇒ Object

Defer all methods to the UDPSocket



151
152
153
 
# File 'lib/openc3/io/udp_sockets.rb', line 151

def method_missing(method, *args, &block)
  @socket.__send__(method, *args, &block)
end

Class Method Details

.multicast?(host, port = nil) ⇒ Boolean 



158
159
160
161
162
163
164
165
166
167
168
 
# File 'lib/openc3/io/udp_sockets.rb', line 158

def self.multicast?(host, port = nil)
  return false if host.nil?

  begin
    Addrinfo.udp(host, 0).ipv4_multicast?
  rescue SocketError, ArgumentError
    # Hostname isn't resolvable so it can't be a multicast address we handle.
    # Reads don't need the hostname at all so don't fail creating the socket.
    false
  end
end

Instance Method Details

#read(read_timeout = nil) ⇒ Object 



135
136
137
138
139
140
141
142
143
144
145
146
147
148
 
# File 'lib/openc3/io/udp_sockets.rb', line 135

def read(read_timeout = nil)
  data = nil
  begin
    data, _ = @socket.recvfrom_nonblock(65536)
  rescue Errno::EAGAIN, Errno::EWOULDBLOCK
    result = IO.fast_select([@socket], nil, nil, read_timeout)
    if result
      retry
    else
      raise Timeout::Error, "Read Timeout"
    end
  end
  data
end

#write(data, write_timeout = 10.0) ⇒ Object 



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
 
# File 'lib/openc3/io/udp_sockets.rb', line 103

def write(data, write_timeout = 10.0)
  num_bytes_to_send = data.length
  total_bytes_sent  = 0
  bytes_sent = 0
  data_to_send = data

  loop do
    begin
      if @external_sockaddr
        # send is used rather than sendmsg_nonblock because sendmsg is not
        # implemented on Windows
        bytes_sent = @socket.send(data_to_send, WRITE_FLAGS, @external_sockaddr)
      else
        bytes_sent = @socket.write_nonblock(data_to_send)
      end
    rescue Errno::EAGAIN, Errno::EWOULDBLOCK
      result = IO.fast_select(nil, [@socket], nil, write_timeout)
      if result
        retry
      else
        raise Timeout::Error, "Write Timeout"
      end
    end
    total_bytes_sent += bytes_sent
    break if total_bytes_sent >= num_bytes_to_send

    data_to_send = data[total_bytes_sent..-1]
  end
end