system-ifaddrs Code ClimateGem VersionDependency Status

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:  Mask:
    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=>"", :netmask=>""}}
[{:interface => "lo", :inet_addr => #<IPAddr ''>,
    :netmask   => #<IPAddr ''>},
 {: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.