This class provides methods for interacting with a IP socket.
The default number of seconds to wait for a read operation to timeout.
# File lib/rex/socket/ip.rb, line 121 def def_read_timeout 10 end
Calls recvfrom and only returns the data
# File lib/rex/socket/ip.rb, line 113 def get(timeout=nil) data, saddr = recvfrom(65535, timeout) return data end
Read a datagram from the IP socket.
# File lib/rex/socket/ip.rb, line 53 def read(length = 65535) raise RuntimeError, "IP sockets must use recvfrom(), not read()" end
Receives a datagram and returns the data and host of the requestor as [ data, host ].
# File lib/rex/socket/ip.rb, line 93 def recvfrom(length = 65535, timeout=def_read_timeout) begin if ((rv = ::IO.select([ fd ], nil, nil, timeout)) and (rv[0]) and (rv[0][0] == fd) ) data, saddr = super(length) af, host = Rex::Socket.from_sockaddr(saddr) return [ data, host ] else return [ '', nil ] end rescue Exception return [ '', nil ] end end
Sends a datagram to the supplied host:port with optional flags.
# File lib/rex/socket/ip.rb, line 66 def sendto(gram, peerhost, flags = 0) dest = ::Socket.pack_sockaddr_in(0, peerhost) # Some BSDs require byteswap for len and offset if( Rex::Compat.is_freebsd or Rex::Compat.is_netbsd or Rex::Compat.is_bsdi or Rex::Compat.is_macosx ) gram=gram.dup gram[2,2]=gram[2,2].unpack("n").pack("s") gram[6,2]=gram[6,2].unpack("n").pack("s") end begin send(gram, flags, dest) rescue ::Errno::EHOSTUNREACH,::Errno::ENETDOWN,::Errno::ENETUNREACH,::Errno::ENETRESET,::Errno::EHOSTDOWN,::Errno::EACCES,::Errno::EINVAL,::Errno::EADDRNOTAVAIL return nil end end
Write the supplied datagram to the connected IP socket.
# File lib/rex/socket/ip.rb, line 44 def write(gram) raise RuntimeError, "IP sockets must use sendto(), not write()" end
Generated with the Darkfish Rdoc Generator 2.