Class: IPAccess::TCPSocket

Inherits:
TCPSocket
  • Object
show all
Includes:
Patches::TCPSocket
Defined in:
lib/ipaccess/ghost_doc/ghost_doc_sockets.rb,
lib/ipaccess/socket.rb

Overview

TCPSocket class with IP access control. It uses output access lists.

This class acts the same way as TCPSocket class but provides special member called acl and a few new instance methods for controlling IP access.

This documentation doesn’t cover description of all class and instance methods of the original TCPSocket class, just the patched variants that make use of IP access control.

Example

require 'ipaccess/socket'                                         # load sockets subsystem

acl_set = IPAccess::Set.new                                            # create shared access set
acl_set.output.block 'randomseed.pl'                              # block connections to this host

socket = IPAccess::TCPSocket.new('randomseed.pl', 80)

Instance Attribute Summary collapse

Attributes included from Patches::ACL

#opened_on_deny

Instance Method Summary collapse

Methods included from Patches::ACL

#__ipa_wrap_socket_call, #blacklist_reasonable, #blacklist_reasonable!, #close_on_deny, #close_on_deny=, #default_list, #terminate, #valid_acl?, #whitelist_reasonable, #whitelist_reasonable!

Constructor Details

#new(addr, port) {|socket| ... } ⇒ TCPSocket #new(addr, port, acl) ⇒ TCPSocket

Creates a new object and attempts to connect to the host and port. If a block is provided, it is yielded as socket object. It optionally sets an access set given as the last parameter or as ACL member of opts. The access set given as an argument has precedence over access set given in options. If ACL parameter is not given it defaults to ACL to IPAccess::Set.Global.

Overloads:



659
660
661
 
# File 'lib/ipaccess/ghost_doc/ghost_doc_sockets.rb', line 659

def initialize
  # Real code hidden.
end

Instance Attribute Details

#acl ⇒ Object

This member keeps the information about currently used access set. You may use it to do low-level operations on IPAccess::Set object associated with instance. You cannot however call any of global access set operations – to do that use IPAccess::Set.Global contant referencing to global ACL.



644
645
646
 
# File 'lib/ipaccess/ghost_doc/ghost_doc_sockets.rb', line 644

def acl
  @acl
end

Instance Method Details

#acl_recheck ⇒ Object

This method allows you to re-check access on demad. It uses internal socket’s address and access set assigned to an object. It will close your communication session before throwing an exception in case of denied access – you can prevent it by setting the flag opened_on_deny to true. The flag can be set while initializing object (through argument :opened_on_deny) or by setting the attribute.



672
673
674
 
# File 'lib/ipaccess/ghost_doc/ghost_doc_sockets.rb', line 672

def acl_recheck
  # Real code hidden.
end

#blacklist(*addresses) ⇒ Object #blacklist(list, *addresses) ⇒ Object Also known as: add_black, deny, block 



582
 
# File 'lib/ipaccess/ghost_doc/ghost_doc_sockets.rb', line 582

def blacklist(*addresses); end

#blacklist!(*addresses) ⇒ Object #blacklist!(list, *addresses) ⇒ Object Also known as: add_black!, deny!, block! 



577
 
# File 'lib/ipaccess/ghost_doc/ghost_doc_sockets.rb', line 577

def blacklist!(*addresses); end

#unblacklist(*addresses) ⇒ Object #unblacklist(list, *addresses) ⇒ Object Also known as: unblock, del_black 



602
 
# File 'lib/ipaccess/ghost_doc/ghost_doc_sockets.rb', line 602

def unblacklist(*addresses); end

#unblacklist!(*addresses) ⇒ Object #unblacklist!(list, *addresses) ⇒ Object Also known as: unblock!, del_black! 



597
 
# File 'lib/ipaccess/ghost_doc/ghost_doc_sockets.rb', line 597

def unblacklist!(*addresses); end

#unwhitelist(*addresses) ⇒ Object #unwhitelist(list, *addresses) ⇒ Object Also known as: del_white 



592
 
# File 'lib/ipaccess/ghost_doc/ghost_doc_sockets.rb', line 592

def unwhitelist(*addresses); end

#unwhitelist!(*addresses) ⇒ Object #unwhitelist!(list, *addresses) ⇒ Object Also known as: del_white! 



587
 
# File 'lib/ipaccess/ghost_doc/ghost_doc_sockets.rb', line 587

def unwhitelist!(*addresses); end

#whitelist(*addresses) ⇒ Object #whitelist(list, *addresses) ⇒ Object 



572
 
# File 'lib/ipaccess/ghost_doc/ghost_doc_sockets.rb', line 572

def whitelist(*addresses); end

#whitelist!(*addresses) ⇒ Object #whitelist!(list, *addresses) ⇒ Object 



567
 
# File 'lib/ipaccess/ghost_doc/ghost_doc_sockets.rb', line 567

def whitelist!(*addresses); end