Included Modules

Class/Module Index [+]

Quicksearch

Rex::Socket::Ip

This class provides methods for interacting with a IP socket.

Public Class Methods

create(hash = {}) click to toggle source

Creates the client using the supplied hash.

# File lib/rex/socket/ip.rb, line 21
def self.create(hash = {})
        hash['Proto'] = 'ip'
        self.create_param(Rex::Socket::Parameters.from_hash(hash))
end
create_param(param) click to toggle source

Wrapper around the base socket class' creation method that automatically sets the parameter's protocol to IP.

# File lib/rex/socket/ip.rb, line 30
def self.create_param(param)
        param.proto = 'ip'
        Rex::Socket.create_param(param)
end

Public Instance Methods

def_read_timeout() click to toggle source

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
get(timeout=nil) click to toggle source

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
put(gram) click to toggle source
Alias for: write
read(length = 65535) click to toggle source

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
recvfrom(length = 65535, timeout=def_read_timeout) click to toggle source

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
sendto(gram, peerhost, flags = 0) click to toggle source

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
type?() click to toggle source
# File lib/rex/socket/ip.rb, line 125
def type?
        return 'ip'
end
write(gram) click to toggle source

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
Also aliased as: put

[Validate]

Generated with the Darkfish Rdoc Generator 2.