Shouldn't this be moved to CommonRuby?

On Sunday, May 5, 2013, naruse (Yui NARUSE) wrote:

>
> Issue #8368 has been updated by naruse (Yui NARUSE).
>
> Target version set to current: 2.1.0
>
> I'm for this method.
> ----------------------------------------
> Feature #8368: Socket.getifaddrs
> https://bugs.ruby-lang.org/issues/8368#change-39144
>
> Author: akr (Akira Tanaka)
> Status: Open
> Priority: Normal
> Assignee:
> Category:
> Target version: current: 2.1.0
>
>
> I'd like to add a method: Socket.getifaddrs.
>
> This method is a wrapper to getifaddrs() function.
> The result is an array of instances of Socket::Ifaddr class as follows.
>
>   % ./ruby -rpp -rsocket -e 'pp Socket.getifaddrs'
>   [#<Socket::Ifaddr lo UP,LOOPBACK,RUNNING,0x10000 [PACKET protocol:0 lo
> hatype:772 HOST hwaddr:00:00:00:00:00:00]>,
>    #<Socket::Ifaddr eth0 UP,BROADCAST,RUNNING,MULTICAST,0x10000 [PACKET
> protocol:0 eth0 hatype:1 HOST hwaddr:00:16:3e:95:88:bb] broadcast:[PACKET
> protocol:0 eth0 hatype:1 HOST hwaddr:ff:ff:ff:ff:ff:ff]>,
>    #<Socket::Ifaddr sit0 NOARP [PACKET protocol:0 sit0 hatype:776 HOST
> hwaddr:00:00:00:00]>,
>    #<Socket::Ifaddr lo UP,LOOPBACK,RUNNING,0x10000 [127.0.0.1]
> netmask:[255.0.0.0]>,
>    #<Socket::Ifaddr eth0 UP,BROADCAST,RUNNING,MULTICAST,0x10000
> [221.186.184.67] netmask:[255.255.255.240] broadcast:[221.186.184.79]>,
>    #<Socket::Ifaddr lo UP,LOOPBACK,RUNNING,0x10000 [::1]
> netmask:[ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff]>,
>    #<Socket::Ifaddr eth0 UP,BROADCAST,RUNNING,MULTICAST,0x10000
> [fe80::216:3eff:fe95:88bb%eth0] netmask:[ffff:ffff:ffff:ffff::]>]
>
> This method can be used to choose multicast-enabled interfaces.
> Multicast applications needs to identify a such interface to sending a
> multicast datagram.
>
>   % ./ruby -rpp -rsocket -e '
>   pp Socket.getifaddrs.reject {|ifaddr|
>     !ifaddr.addr.ip? || (ifaddr.flags & Socket::IFF_MULTICAST == 0)
>   }.map {|ifaddr| [ifaddr.name, ifaddr.ifindex, ifaddr.addr] }'
>   [["eth0", 2, #<Addrinfo: 221.186.184.67>],
>    ["eth0", 2, #<Addrinfo: fe80::216:3eff:fe95:88bb%eth0>]]
>
> This method can be used to obtain broadcast addresses to send a broadcast
> messages.  (use case: [ruby-talk:329921])
>
> Also, the broadcast addresses can be used to receive broadcast messages.
> (Programming UNIX Sockets in C: 4.12.  How can I write a multi-homed
> server?
>  http://www.faqs.org/faqs/unix-faq/socket/ )
>
> getifaddrs() is not standardized but many platforms have.
> BSDI, FreeBSD, NetBSD, OpenBSD, DragonFly, MirOS, GNU/Linux, MacOS X,
> SunOS 5.11 (OpenIndiana), Cygwin 1.7.15
>
> From Gnulib document, getifaddrs() is not exist on
> AIX 5.1, HP-UX 11, IRIX 6.5, OSF/1 5.1, Solaris 10, Cygwin 1.5.x, mingw,
> MSVC 9, Interix 3.5, BeOS.
> http://www.gnu.org/software/gnulib/manual/html_node/getifaddrs.html
>
> I implemented new Socket::Ifaddr class for return value of
> Socket.getifaddrs,
> instead of constructing the result from currentn data structures such as
> Array.
> This choice make us possible to implement Socket::Ifaddr#inspect to show
> flags as its names (UP,...).
> Also, struct getifaddrs contains Address-specific data, ifa_data which may
> be extended by platforms.
> When we find a way to extract some data from ifa_data, we can add a method
> for that.
>
> Socket::Ifaddr is different from Socket::Interface by
> http://bugs.ruby-lang.org/issues/8075 .
> They have no one-to-one mapping.
> For example, Socket.getifaddrs returns two or more elements for one
> interface.
>
>
>
>
> --
> http://bugs.ruby-lang.org/
>
>

-- 

// Magnus Holm