Class: BetterCap::Firewalls::Base

Inherits:
Object
  • Object
show all
Defined in:
lib/bettercap/firewalls/base.rb

Overview

Base class for BetterCap::Firewalls objects.

Direct Known Subclasses

BSD, Linux

Constant Summary collapse

@@instance =

Instance of the loaded firewall.

nil

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize ⇒ Base

Initialize the firewall object. Raise NotImplementedError



46
47
48
 
# File 'lib/bettercap/firewalls/base.rb', line 46

def initialize
  @frwd_initial_state = forwarding_enabled?
end

Class Method Details

.clear ⇒ Object

Clear the instance of the BetterCap::Firewalls object.



39
40
41
 
# File 'lib/bettercap/firewalls/base.rb', line 39

def clear
  @@instance = nil
end

.get ⇒ Object

Save and return an instance of the appropriate BetterCap::Firewalls object.



22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
 
# File 'lib/bettercap/firewalls/base.rb', line 22

def get
  return @@instance unless @@instance.nil?

  if RUBY_PLATFORM =~ /.+bsd/ or RUBY_PLATFORM =~ /darwin/
    @@instance = Firewalls::BSD.new
  elsif RUBY_PLATFORM =~ /linux/
    @@instance = Firewalls::Linux.new
  end

  if @@instance.nil? or not @@instance.supported?
    raise BetterCap::Error, 'Unsupported operating system'
  end

  @@instance
end

Instance Method Details

#add_port_redirection(r, use_ipv6) ⇒ Object

Apply the r BetterCap::Firewalls::Redirection port redirection object. Raise NotImplementedError



84
85
86
 
# File 'lib/bettercap/firewalls/base.rb', line 84

def add_port_redirection( r, use_ipv6 )
  not_implemented_method!
end

#del_port_redirection(r, use_ipv6) ⇒ Object

Remove the r BetterCap::Firewalls::Redirection port redirection object. Raise NotImplementedError



90
91
92
 
# File 'lib/bettercap/firewalls/base.rb', line 90

def del_port_redirection( r, use_ipv6 )
  not_implemented_method!
end

#enable_forwarding(enabled) ⇒ Object

If enabled is true will enable packet forwarding, otherwise it will disable it. Raise NotImplementedError



58
59
60
 
# File 'lib/bettercap/firewalls/base.rb', line 58

def enable_forwarding(enabled)
  not_implemented_method!
end

#enable_icmp_bcast(enabled) ⇒ Object

If enabled is true will enable icmp_echo_ignore_broadcasts, otherwise it will disable it. Raise NotImplementedError



65
66
67
 
# File 'lib/bettercap/firewalls/base.rb', line 65

def enable_icmp_bcast(enabled)
  not_implemented_method!
end

#enable_send_redirects(enabled) ⇒ Object

If enabled is true will enable send_redirects, otherwise it will disable it. Raise NotImplementedError



72
73
74
 
# File 'lib/bettercap/firewalls/base.rb', line 72

def enable_send_redirects(enabled)
  not_implemented_method!
end

#forwarding_enabled? ⇒ Boolean

Return true if packet forwarding is currently enabled, otherwise false. Raise NotImplementedError

Returns:

  • (Boolean) 


78
79
80
 
# File 'lib/bettercap/firewalls/base.rb', line 78

def forwarding_enabled?
  not_implemented_method!
end

#restore ⇒ Object

Restore the system’s original packet forwarding state. Raise NotImplementedError



96
97
98
99
100
 
# File 'lib/bettercap/firewalls/base.rb', line 96

def restore
  if forwarding_enabled? != @frwd_initial_state
    enable_forwarding @frwd_initial_state
  end
end

#supported? ⇒ Boolean

OS specific checks.

Returns:

  • (Boolean) 


51
52
53
 
# File 'lib/bettercap/firewalls/base.rb', line 51

def supported?
  true
end