Class: Rex::Socket::SwitchBoard

This class provides a global routing table that associates subnets with Comm classes. Comm classes are used to instantiate objects that are tied to remote network entities. For example, the Local Comm class is used to building network connections directly from the local machine whereas, for instance, a Meterpreter Comm would build a local socket pair that is associated with a connection established by a remote entity. This can be seen as a uniform way of communicating with hosts through arbitrary channels.

Methods

_init add_route add_route best_comm best_comm each each flush_routes flush_routes remove_by_comm remove_by_comm remove_route remove_route route_exists? routes

Classes and Modules

Class Rex::Socket::SwitchBoard::Route

Attributes

mutex	[R]	The mutex protecting the routes array.
routes	[R]	The routes array.

Public Class methods

add_route(subnet, mask, comm)

Adds a route to the switch board routing table using the supplied Comm instance.

best_comm(addr)

Returns the Comm instance that should be used for the supplied address. If no comm can be found, the default Local Comm is returned.

each(&block)

Enumerate each route in the routing table.

flush_routes()

Flush all the routes from the switch board routing table.

remove_by_comm(comm)

Removes all routes that go through the supplied Comm.

remove_route(subnet, mask, comm)

Removes a route from the switch board routing table for the supplied subnet routing through the supplied Comm instance.

routes()

Returns the array of routes.

Public Instance methods

add_route(subnet, mask, comm)

Adds a route for a given subnet and netmask destined through a given comm instance.

best_comm(addr)

Finds the best possible comm for the supplied target address.

each(&block)

Enumerates each entry in the routing table.

flush_routes()

Flushes all established routes.

remove_by_comm(comm)

Remove all routes that go through the supplied comm.

remove_route(subnet, mask, comm)

Removes a route for a given subnet and netmask destined through a given comm instance.

route_exists?(subnet, netmask)

Checks to see if a route already exists for the supplied subnet and netmask.

Protected Instance methods

_init()