lan_scanner 0.0.1 → 0.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3b03b665db6f858b32fd78d0fa4349ddb272493f86ee947c03ffa6540ee4f950
-  data.tar.gz: 719c9f103d2b88365308fd5cea1a67156ba822f34e3ab82f2193d9e86a85b23c
+  metadata.gz: ad9ff972172708d293dd398f7a9632b46442af01c46c872dcc4e0c592e61b9a4
+  data.tar.gz: e9f7c3b675dcf5f2c7c64dbca357e7c7b61fcb68fcd98c4ef7a1398d0790988e
 SHA512:
-  metadata.gz: ff053ab65a6ea8c93586ff9adb74cc0293bca5caf0415074e6a4ae70cb3340a717d0759836515f71e21b39be125d355859dced101d16c4295f2e31b36869167d
-  data.tar.gz: 3bcf333729f6b09ce19daa4731c86981bb29f741c0d358e83a2f04ea73f7e434247039eb0f7027678d2320b1b8add626d94f45bc34153c22b264d37e9b2e72f0
+  metadata.gz: 68d459f8f39d95cbf3b891e860b5716f252f78e13f20d7aaf89a724ee42c207fb6968ceb644fa8fd5e8e3d84c76564db9c905a0069d2c9b544c30f7eb9362d17
+  data.tar.gz: 15215140fe414f6e9a0bb11c49132fa00ee9d13c45c419f3bf7afc06b18f14da0a56e8c319198c5a43bbc274d27b6d34172bdf58220c199f896e1c73eed9c121

data/README.md

@@ -20,7 +20,7 @@ Based on nmap.
 <a name="usage"></a>
 ## Usage
 
-### Find devices in LAN
+### Find online devices in LAN
 ```ruby
 require 'lan_scanner'
 
@@ -43,6 +43,21 @@ end
 
 ```
 
+### Get state of devices in LAN
+
+```ruby
+require 'lan_scanner'
+
+devices = LanScanner.scan_device_states %w[192.168.178.1 192.168.178.22 192.168.178.44]
+# => [LanScanner::Device, LanScanner::Device, ...]
+
+devices.each do |d|
+  puts "#{d.remote_address} -> #{d.host_name} (#{d.state})"
+end
+# 192.168.178.1 -> server.domain (up)
+# 192.168.178.22 -> mycomputer.domain (up)
+# 192.168.178.44 -> (down)
+```
 
 <a name="installation"></a>
 ## Installation

data/lib/lan_scanner/device.rb

@@ -3,10 +3,12 @@ module LanScanner
   class Device
     attr_reader :host_name
     attr_reader :remote_address
+    attr_reader :state # 'up','down','unknown'
 
-    def initialize(remote_address:, host_name: nil)
+    def initialize(remote_address:, host_name: nil, state: nil)
       @host_name = host_name
       @remote_address = remote_address
+      @state = state
     end
   end
 

data/lib/lan_scanner/version.rb

@@ -1,3 +1,3 @@
 module LanScanner
-  VERSION = '0.0.1'.freeze
+  VERSION = '0.0.3'.freeze
 end

data/lib/lan_scanner.rb

@@ -18,16 +18,44 @@ module LanScanner
       network = my_networks
     end
     network = [network] unless network.is_a? Array
-    xml_results = []
-    tmp_file = "#{Dir.tmpdir}/nmap_scan.xml"
+    sn_xml_results = []
+    tmp_file = "#{Dir.tmpdir}/nmap_scan_#{Random.random_number}.xml"
+    # first we do an -sL scan, which also receives addresses from router/network cache,
+    # that are not found by -sn scan when scanning for the complete network, but are found
+    # with -sn scan, when scanning for this addresses explicitly
+    #
+    # so after this scan we scan for this addresses beneath the networks with -sn
+    sl_xml_results = []
     network.each do |n|
-      ['-sL','-sn'].each do |nmap_type|
+      ['-sL'].each do |nmap_type|
         `nmap #{nmap_type} #{n} -oX "#{tmp_file}"`
-        xml_results.push File.read tmp_file
+        sl_xml_results.push File.read tmp_file
         File.delete tmp_file
       end
     end
-    _parse_nmap_xml xml_results
+    # here we scan for the received ip addresses from network cache
+    sl_ips = _parse_nmap_xml sl_xml_results
+    `nmap -sn #{sl_ips.map(&:remote_address).join(' ')} -oX "#{tmp_file}"`
+    sn_xml_results.push File.read tmp_file
+    # here we ping the networks (fast ping which does not detect all)
+    network.each do |n|
+      ['-sn'].each do |nmap_type|
+        `nmap #{nmap_type} #{n} -oX "#{tmp_file}"`
+        sn_xml_results.push File.read tmp_file
+        File.delete tmp_file
+      end
+    end
+    _parse_nmap_xml sn_xml_results
+  end
+
+  # get states of given addresses
+  def self.scan_device_states addresses
+    addresses = [addresses] unless addresses.is_a? Array
+    tmp_file = "#{Dir.tmpdir}/nmap_scan_#{Random.random_number}.xml"
+    `nmap -sn #{addresses.join(' ')} -oX "#{tmp_file}"`
+    online_hosts = _parse_nmap_xml [File.read(tmp_file)]
+    offline_addresses = addresses.reject { |a| online_hosts.map(&:remote_address).include?(a) }
+    online_hosts + offline_addresses.map { |a| OpenStruct.new(remote_address: a, host_name: nil, state: 'down') }
   end
 
   def self.my_networks
@@ -70,7 +98,7 @@ module LanScanner
     results.values.select do |r|
       r.state == 'up' || r.host_name
     end.map do |r|
-      LanScanner::Device.new host_name: r.host_name, remote_address: r.remote_address
+      LanScanner::Device.new host_name: r.host_name, remote_address: r.remote_address, state: r.state
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lan_scanner
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.3
 platform: ruby
 authors:
 - Matthäus J. N. Beyrle
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-10-21 00:00:00.000000000 Z
+date: 2023-10-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tty-which