lan_scanner 0.0.2 → 0.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 06453e92801f03ccff92ba3b1b0155e540ca626228f3b2d61f72f8605c851bac
-  data.tar.gz: 9a28ca27720d9d69c3bf93cdaf0f9f6b9693bfdee5fc9e20ec2b7f78152b85ff
+  metadata.gz: ad9ff972172708d293dd398f7a9632b46442af01c46c872dcc4e0c592e61b9a4
+  data.tar.gz: e9f7c3b675dcf5f2c7c64dbca357e7c7b61fcb68fcd98c4ef7a1398d0790988e
 SHA512:
-  metadata.gz: '0598fb4619c48ae76d23a19d3b9255b9f679f13f2df5f32ff1768293b2c7ebf368ea34d82fbb94c0787223d05f1edb4908dff8fbe1f4385cbab66aa958b23e66'
-  data.tar.gz: fef519bb6deb35fe43e99f6b8d6d68151ad5fe724ce105802810ead54ddc926d6eb592be0e0bca842732498839e01b45c6695c998790958dd0eb846f77aa8890
+  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.2'.freeze
+  VERSION = '0.0.3'.freeze
 end

data/lib/lan_scanner.rb

@@ -19,7 +19,7 @@ module LanScanner
     end
     network = [network] unless network.is_a? Array
     sn_xml_results = []
-    tmp_file = "#{Dir.tmpdir}/nmap_scan.xml"
+    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
@@ -48,6 +48,16 @@ module LanScanner
     _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
     my_ip_addresses.map do |a|
       if a.include?('.')
@@ -88,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,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lan_scanner
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.3
 platform: ruby
 authors:
 - Matthäus J. N. Beyrle