This lib is a wrapper for get_ifaddrs C routine.
The original routine returns a linked list that contains avaliable inet interfaces. This lib walks on list and return an hash that contains the interface names and sub-hashes with respectives ip addresses and netmasks.
Supose that /sbin/ifconfig returns:
lo Link encap:Local Loopback
inet addr:127.0.0.1 Mask:255.0.0.0
inet6 addr: ::1/128 Scope:Host
UP LOOPBACK RUNNING MTU:16436 Metric:1
RX packets:86688 errors:0 dropped:0 overruns:0 frame:0
TX packets:86688 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:0
RX bytes:10903658 (10.3 MiB) TX bytes:10903658 (10.3 MiB)
Consider test.rb below:
# test.rb
require "pp"
require "system/getifaddrs"
pp System.get_ifaddrs
pp System.get_all_ifaddrs
When test.rb is executed:
$ ruby test.rb
Should return:
{:lo=>{:inet_addr=>"127.0.0.1", :netmask=>"255.0.0.0"}}
[{:interface => "lo", :inet_addr => #<IPAddr '127.0.0.1'>,
:netmask => #<IPAddr '255.0.0.0'>},
{:interface => "lo", :inet_addr => #<IPAddr '::1'>,
:netmask => #<IPAddr 'ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff'>}]
Copyright (c) 2010-2014 Bruno Coimbra. See LICENSE for details.