ffi-libc 0.0.3 → 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 0102b721ed989c2427b5531a522da0001f4dfda43cf1c295e8eda3071891e02d
+  data.tar.gz: 4e06ead22308e1fdb667d24defc2ea3a069d4737732b1ab046777b663a4d5e00
+SHA512:
+  metadata.gz: 9c4a840ac2740ba51db453edc891b17db0fae22dfe5cebdf5598107b175377ba2436d1dfebbead02fec119bc10a39703b64fa74595467100c0ee35952871a303
+  data.tar.gz: beca1246d6d97ce653c508025f636c70c0dd19ffbd11ff4ffea569495b230f5d401819c89949607c5caa3b94baacc3be4b0c092933f1a2126ac13bfca8fd8fe5

data/.github/workflows/ruby.yml

@@ -0,0 +1,29 @@
+name: CI
+
+on: [ push, pull_request ]
+
+jobs:
+  tests:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        ruby:
+          - 2.4
+          - 2.5
+          - 2.6
+          - 2.7
+          - 3.0
+          - jruby
+          - truffleruby
+    name: Ruby ${{ matrix.ruby }}
+    steps:
+      - uses: actions/checkout@v2
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+      - name: Install dependencies
+        run: bundle install --jobs 4 --retry 3
+      - name: Run tests
+        run: bundle exec rake test

data/.gitignore

@@ -1,4 +1,6 @@
-doc
-pkg
-.bundle
-.yardoc
+/Gemfile.lock
+/doc/
+/pkg/
+/.bundle
+/.yardoc
+/vendor/bundle

data/.rspec

@@ -0,0 +1 @@
+--colour --format documentation

data/ChangeLog.md

@@ -1,3 +1,47 @@
+### 0.1.1 / 2021-09-22
+
+* Removed `sys_errlist` and `sys_nerr` variables, as they have been removed
+  from glibc (see:
+  https://sourceware.org/pipermail/libc-announce/2020/000029.html).
+* Load `libc` via `FFI::Library::LIBC`.
+
+### 0.1.0 / 2013-08-15
+
+* Require ffi ~> 1.0.
+* Added `alarm`.
+* Added `clock`.
+* Added `getc`.
+* Added `getchar`.
+* Added `gets`.
+* Added `ungetc`.
+* Added `getifaddrs`.
+* Added `puts`.
+* Added `putchar`.
+* Added `putc`.
+* Added `strcmp`.
+* Added `strncmp`.
+* Added {FFI::LibC::NULL}.
+* Added {FFI::LibC::Ifaddrs}.
+* Added {FFI::LibC.raise_error}.
+* Added {FFI::LibC.each_ifaddr}.
+* Added {FFI::LibC.rusage}.
+
+### 0.0.5 / 2011-05-11
+
+* Skip `clearenv`, `memrchr`, `stdin`, `stdout` and `stderr` if they cannot
+  be loaded (thanks FreneticEntropy and mephux).
+  * The `libc` installed on OSX lacks these functions/global-variables.
+* Opt into `test.rubygems.org`.
+
+### 0.0.4 / 2011-02-03
+
+* Require ffi >= 0.6.0, <= 1.1.0:
+  * JRuby requires ffi >= 1.0.0.
+  * A lot of projects still require ffi ~> 0.6.0.
+* Added `stdin`.
+* Added `stdout`.
+* Added `stderr`.
+
 ### 0.0.3 / 2010-08-03
 
 * Load libc from the current process.
@@ -11,10 +55,10 @@
 * Added the Structs:
   * {FFI::LibC::InAddr}.
   * {FFI::LibC::In6Addr}.
-  * {FFI::LibC::SockAddr}.
-  * {FFI::LibC::SockAddrDL}.
-  * {FFI::LibC::SockAddrIn}.
-  * {FFI::LibC::SockAddrIn6}.
+  * {FFI::LibC::Sockaddr}.
+  * {FFI::LibC::SockaddrDL}.
+  * {FFI::LibC::SockaddrIn}.
+  * {FFI::LibC::SockaddrIn6}.
 
 ### 0.0.1 / 2010-05-19
 

data/Gemfile

@@ -1,24 +1,11 @@
 source 'https://rubygems.org'
 
-group(:runtime) do
-  gem 'ffi',		'~> 0.6.0'
+gemspec
+
+group :development do
+  gem 'rake'
+  gem 'rubygems-tasks', '~> 0.2'
+  gem 'rspec',          '~> 3.0'
+  gem 'kramdown'
+  gem 'yard',           '~> 0.9'
 end
-
-group(:development) do
-  gem 'bundler',	'~> 0.9.25'
-  gem 'rake',		'~> 0.8.7'
-  gem 'jeweler',	'~> 1.4.0', :git => 'git://github.com/technicalpickles/jeweler.git'
-end
-
-group(:doc) do
-  case RUBY_PLATFORM
-  when 'java'
-    gem 'maruku',	'~> 0.6.0'
-  else
-    gem 'rdiscount',	'~> 1.6.3'
-  end
-
-  gem 'yard',		'~> 0.5.3'
-end
-
-gem 'rspec',	'~> 1.3.0', :group => [:development, :test]

data/LICENSE.txt

@@ -1,7 +1,4 @@
-
-The MIT License
-
-Copyright (c) 2010 Hal Brodigan
+Copyright (c) 2010-2021 Hal Brodigan
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/README.md

@@ -1,8 +1,11 @@
 # ffi-libc
 
-* [github.com/postmodern/ffi-libc](http://github.com/postmodern/ffi-libc/)
-* [github.com/postmodern/ffi-libc/issues](http://github.com/postmodern/ffi-libc/issues)
-* Postmodern (postmodern.mod3 at gmail.com)
+[![CI](https://github.com/postmodern/ffi-libc/actions/workflows/ruby.yml/badge.svg)](https://github.com/postmodern/ffi-libc/actions/workflows/ruby.yml)
+[![Code Climate](https://codeclimate.com/github/postmodern/ffi-libc.svg)](https://codeclimate.com/github/postmodern/ffi-libc)
+
+* [Source](https://github.com/postmodern/ffi-libc/)
+* [Issues](https://github.com/postmodern/ffi-libc/issues)
+* [Documentation](https://rubydoc.info/gems/ffi-libc)
 
 ## Description
 
@@ -10,18 +13,122 @@ Useful Ruby FFI bindings for `libc`.
 
 ## Features
 
-* Provides common Structs used in `libc`.
-* Binds to common functions and global variables in `libc`.
+* Provides common Structs used in `libc`:
+  * {FFI::LibC::Ifaddrs}
+  * {FFI::LibC::In6Addr}
+  * {FFI::LibC::InAddr}
+  * {FFI::LibC::SockaddrDL}
+  * {FFI::LibC::SockaddrFamily}
+  * {FFI::LibC::SockaddrIn6}
+  * {FFI::LibC::SockaddrIn}
+  * {FFI::LibC::Sockaddr}
+  * {FFI::LibC::Timeval}
+  * {FFI::LibC::Timezone}
+  * {FFI::LibC::RUsage}
+* Binds to common functions and global variables in `libc`:
+  * `errno.h`:
+    * `sys_errlist` (BSD)
+    * `sys_nerr` (BSD)
+    * `errno`
+  * `unistd.h`:
+    * `brk`
+    * `sbrk`
+    * `getpid`
+    * `getppid`
+    * `getuid`
+    * `geteuid`
+    * `getgid`
+    * `getegid`
+  * `stdlib.h`:
+    * `calloc`
+    * `malloc`
+    * `free`
+    * `realloc`
+    * `getenv`
+    * `putenv`
+    * `unsetenv`
+    * `clearenv`
+  * `time.h`:
+    * `time`
+  * `sys/time.h`:
+    * `gettimeofday`
+    * `settimeofday`
+  * `sys/resource.h` / `bits/resource.h`:
+    * `getrusage`
+  * `sys/mman.h`:
+    * `mmap`
+    * `munmap`
+  * `string.h`:
+    * `bzero`
+    * `memset`
+    * `memcpy`
+    * `memcmp`
+    * `memchr`
+    * `memrchr`
+    * `strcpy`
+    * `strncpy`
+    * `strlen`
+    * `index`
+    * `rindex`
+    * `strchr`
+    * `strrchr`
+    * `strstr`
+    * `strerror`
+  * `stdio.h`:
+    * `stdin`
+    * `stdout`
+    * `stderr`
+    * `fopen`
+    * `fdopen`
+    * `freopen`
+    * `fseek`
+    * `ftell`
+    * `rewind`
+    * `fread`
+    * `fwrite`
+    * `fgetc`
+    * `fgets`
+    * `fputc`
+    * `fputs`
+    * `fflush`
+    * `fclose`
+    * `clearerr`
+    * `feof`
+    * `ferror`
+    * `fileno`
+    * `perror`
+  * `netdb.h`:
+    * `getnameinfo`
+  * `ifaddrs.h`:
+    * `getifaddrs`
+    * `freeifaddrs`
 
 ## Requirements
 
-* [ffi](http://github.com/ffi/ffi) ~> 0.6.0
+* [ffi] ~> 1.0
 
 ## Install
 
-    $ sudo gem install ffi-libc
+```shell
+$ gem install ffi-libc
+```
+
+### gemspec
+
+```ruby
+gem.add_dependency 'ffi-libc', '~> 0.1'
+```
+
+### Gemfile
+
+```ruby
+gem 'ffi-libc', '~> 0.1'
+```
 
 ## License
 
+Copyright (c) 2010-2021 Hal Brodigan
+
 See {file:LICENSE.txt} for license information.
 
+[ffi]: https://github.com/ffi/ffi#readme

data/Rakefile

@@ -1,38 +1,13 @@
 require 'rubygems'
-require 'bundler'
 
-begin
-  Bundler.setup(:development, :doc)
-rescue Bundler::BundlerError => e
-  STDERR.puts e.message
-  STDERR.puts "Run `bundle install` to install missing gems"
-  exit e.status_code
-end
+require 'rubygems/tasks'
+Gem::Tasks.new
 
-require 'rake'
-require 'rake/clean'
-require 'jeweler'
-
-Jeweler::Tasks.new do |gem|
-  gem.name = 'ffi-libc'
-  gem.licenses = ['MIT']
-  gem.summary = %Q{Useful FFI bindings for libc}
-  gem.email = 'postmodern.mod3@gmail.com'
-  gem.homepage = %Q{http://github.com/postmodern/ffi-libc}
-  gem.description = %Q{Useful Ruby FFI bindings for libc.}
-  gem.authors = ['Postmodern']
-  gem.has_rdoc = 'yard'
-end
-
-require 'spec/rake/spectask'
-
-desc "Run all specifications"
-Spec::Rake::SpecTask.new(:spec) do |spec|
-  spec.libs += ['lib', 'spec']
-  spec.spec_files = FileList['spec/**/*_spec.rb']
-  spec.spec_opts = ['--options', '.specopts']
-end
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new
+task :test => :spec
 task :default => :spec
 
 require 'yard'
 YARD::Rake::YardocTask.new
+task :doc => :yard

data/ffi-libc.gemspec

@@ -1,77 +1,61 @@
-# Generated by jeweler
-# DO NOT EDIT THIS FILE DIRECTLY
-# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
-# -*- encoding: utf-8 -*-
+# encoding: utf-8
 
-Gem::Specification.new do |s|
-  s.name = %q{ffi-libc}
-  s.version = "0.0.3"
+require 'yaml'
 
-  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
-  s.authors = ["Postmodern"]
-  s.date = %q{2010-08-03}
-  s.description = %q{Useful Ruby FFI bindings for libc.}
-  s.email = %q{postmodern.mod3@gmail.com}
-  s.extra_rdoc_files = [
-    "ChangeLog.md",
-    "LICENSE.txt",
-    "README.md"
-  ]
-  s.files = [
-    ".gitignore",
-    ".specopts",
-    ".yardopts",
-    "ChangeLog.md",
-    "Gemfile",
-    "LICENSE.txt",
-    "README.md",
-    "Rakefile",
-    "VERSION",
-    "ffi-libc.gemspec",
-    "lib/ffi/libc.rb",
-    "lib/ffi/libc/af.rb",
-    "lib/ffi/libc/in6_addr.rb",
-    "lib/ffi/libc/in_addr.rb",
-    "lib/ffi/libc/libc.rb",
-    "lib/ffi/libc/sock_addr.rb",
-    "lib/ffi/libc/sock_addr_dl.rb",
-    "lib/ffi/libc/sock_addr_family.rb",
-    "lib/ffi/libc/sock_addr_in.rb",
-    "lib/ffi/libc/sock_addr_in6.rb",
-    "lib/ffi/libc/timeval.rb",
-    "lib/ffi/libc/timezone.rb",
-    "lib/ffi/libc/types.rb"
-  ]
-  s.has_rdoc = %q{yard}
-  s.homepage = %q{http://github.com/postmodern/ffi-libc}
-  s.licenses = ["MIT"]
-  s.require_paths = ["lib"]
-  s.rubygems_version = %q{1.3.7}
-  s.summary = %q{Useful FFI bindings for libc}
+Gem::Specification.new do |gem|
+  gemspec = YAML.load_file('gemspec.yml')
 
-  if s.respond_to? :specification_version then
-    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
-    s.specification_version = 3
+  gem.name    = gemspec.fetch('name')
+  gem.version = gemspec.fetch('version') do
+                  lib_dir = File.join(File.dirname(__FILE__),'lib')
+                  $LOAD_PATH << lib_dir unless $LOAD_PATH.include?(lib_dir)
 
-    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
-      s.add_runtime_dependency(%q<ffi>, ["~> 0.6.0"])
-      s.add_development_dependency(%q<bundler>, ["~> 0.9.25"])
-      s.add_development_dependency(%q<rake>, ["~> 0.8.7"])
-      s.add_development_dependency(%q<jeweler>, ["~> 1.4.0"])
-      s.add_development_dependency(%q<rspec>, ["~> 1.3.0"])
-    else
-      s.add_dependency(%q<ffi>, ["~> 0.6.0"])
-      s.add_dependency(%q<bundler>, ["~> 0.9.25"])
-      s.add_dependency(%q<rake>, ["~> 0.8.7"])
-      s.add_dependency(%q<jeweler>, ["~> 1.4.0"])
-      s.add_dependency(%q<rspec>, ["~> 1.3.0"])
+                  require 'ffi/libc/version'
+                  FFI::LibC::VERSION
+                end
+
+  gem.summary     = gemspec['summary']
+  gem.description = gemspec['description']
+  gem.licenses    = Array(gemspec['license'])
+  gem.authors     = Array(gemspec['authors'])
+  gem.email       = gemspec['email']
+  gem.homepage    = gemspec['homepage']
+  gem.metadata    = gemspec['metadata'] if gemspec['metadata']
+
+  glob = lambda { |patterns| gem.files & Dir[*patterns] }
+
+  gem.files = `git ls-files`.split($/)
+  gem.files = glob[gemspec['files']] if gemspec['files']
+
+  gem.executables = gemspec.fetch('executables') do
+    glob['bin/*'].map { |path| File.basename(path) }
+  end
+  gem.default_executable = gem.executables.first if Gem::VERSION < '1.7.'
+
+  gem.extensions       = glob[gemspec['extensions'] || 'ext/**/extconf.rb']
+  gem.test_files       = glob[gemspec['test_files'] || '{test/{**/}*_test.rb']
+  gem.extra_rdoc_files = glob[gemspec['extra_doc_files'] || '*.{txt,md}']
+
+  gem.require_paths = Array(gemspec.fetch('require_paths') {
+    %w[ext lib].select { |dir| File.directory?(dir) }
+  })
+
+  gem.requirements              = gemspec['requirements']
+  gem.required_ruby_version     = gemspec['required_ruby_version']
+  gem.required_rubygems_version = gemspec['required_rubygems_version']
+  gem.post_install_message      = gemspec['post_install_message']
+
+  split = lambda { |string| string.split(/,\s*/) }
+
+  if gemspec['dependencies']
+    gemspec['dependencies'].each do |name,versions|
+      gem.add_dependency(name,split[versions])
     end
-  else
-    s.add_dependency(%q<ffi>, ["~> 0.6.0"])
-    s.add_dependency(%q<bundler>, ["~> 0.9.25"])
-    s.add_dependency(%q<rake>, ["~> 0.8.7"])
-    s.add_dependency(%q<jeweler>, ["~> 1.4.0"])
-    s.add_dependency(%q<rspec>, ["~> 1.3.0"])
   end
-end
 
+  if gemspec['development_dependencies']
+    gemspec['development_dependencies'].each do |name,versions|
+      gem.add_development_dependency(name,split[versions])
+    end
+  end
+end

data/gemspec.yml

@@ -0,0 +1,21 @@
+name: ffi-libc
+version: 0.1.1
+summary: Useful FFI bindings for libc
+description: Useful Ruby FFI bindings for libc.
+license: MIT
+authors: Postmodern
+email: postmodern.mod3@gmail.com
+homepage: https://github.com/postmodern/ffi-libc#redme
+has_yard: true
+
+metadata:
+  documentation_uri: https://rubydoc.info/gems/ffi-libc
+  source_code_uri:   https://github.com/postmodern/ffi-libc
+  bug_tracker_uri:   https://github.com/postmodern/ffi-libc/issues
+  changelog_uri:     https://github.com/postmodern/ffi-libc/blob/master/ChangeLog.md
+
+dependencies:
+  ffi: ~> 1.0
+
+development_dependencies:
+  bundler: ~> 2.0

data/lib/ffi/libc/ifaddrs.rb

@@ -0,0 +1,93 @@
+require 'ffi/libc/ifaddrs_union'
+require 'ffi/libc/sockaddr'
+
+module FFI
+  module LibC
+    #
+    # @since 0.1.0
+    #
+    class Ifaddrs < FFI::Struct
+
+      layout :ifa_next,    :pointer,
+             :ifa_name,    :string,
+             :ifa_flags,   :uint,
+             :ifa_addr,    :pointer,
+             :ifa_netmask, :pointer,
+             :ifa_ifu,     IfaddrsUnion,
+             :ifa_data,    :pointer
+
+      #
+      # Gets the next Interface Address in the list.
+      #
+      # @return [Ifaddrs, nil]
+      #   The next Interface Address in the list.
+      #
+      def next
+        unless self[:ifa_next].null?
+          Ifaddrs.new(self[:ifa_next])
+        end
+      end
+
+      #
+      # The name of the Interface.
+      #
+      # @return [String]
+      #   The name.
+      #
+      def name
+        self[:ifa_name]
+      end
+
+      #
+      # The flags of the Interface.
+      #
+      # @return [Integer]
+      #   The flags.
+      #
+      def flags
+        self[:ifa_flags]
+      end
+
+      #
+      # The address of the Interface.
+      #
+      # @return [Sockaddr]
+      #   The basic socket address.
+      #
+      def addr
+        Sockaddr.new(self[:ifa_addr])
+      end
+
+      #
+      # The netmask of the Interface.
+      #
+      # @return [Sockaddr]
+      #   The socket address containing the netmask.
+      #
+      def netmask
+        Sockaddr.new(self[:ifa_netmask])
+      end
+
+      #
+      # The broadcast address of the Interface.
+      #
+      # @return [Sockaddr]
+      #   The broadcast address.
+      #
+      def broadaddr
+        Sockaddr.new(self[:ifa_ifu][:ifu_broadaddr])
+      end
+
+      #
+      # The destination address of the Interface.
+      #
+      # @return [Sockaddr]
+      #   The destination address.
+      #
+      def dstaddr
+        Sockaddr.new(self[:ifa_ifu][:ifu_dstaddr])
+      end
+
+    end
+  end
+end

data/lib/ffi/libc/ifaddrs_union.rb

@@ -0,0 +1,15 @@
+require 'ffi'
+
+module FFI
+  module LibC
+    #
+    # @since 0.1.0
+    #
+    class IfaddrsUnion < FFI::Union
+
+      layout :ifu_broadaddr, :pointer,
+             :ifu_dstaddr,   :pointer
+
+    end
+  end
+end

data/lib/ffi/libc/libc.rb

@@ -1,6 +1,8 @@
 require 'ffi/libc/types'
 require 'ffi/libc/timeval'
 require 'ffi/libc/timezone'
+require 'ffi/libc/ifaddrs'
+require 'ffi/libc/rusage'
 
 require 'ffi'
 
@@ -8,13 +10,23 @@ module FFI
   module LibC
     extend FFI::Library
 
-    ffi_lib [FFI::CURRENT_PROCESS, 'c']
+    ffi_lib FFI::Library::LIBC
+
+    # The NULL constant
+    NULL = nil
 
     # errno.h
-    attach_variable :sys_errlist, :pointer
-    attach_variable :sys_nerr, :int
+    begin
+      attach_variable :sys_errlist, :pointer
+      attach_variable :sys_nerr, :int
+    rescue FFI::NotFoundError
+    end
     attach_variable :errno, :int
 
+    def self.raise_error(error=self.errno)
+      raise(strerror(error))
+    end
+
     # unistd.h
     attach_function :brk, [:pointer], :int
     attach_function :sbrk, [:pointer], :pointer
@@ -24,6 +36,7 @@ module FFI
     attach_function :geteuid, [], :uid_t
     attach_function :getgid, [], :gid_t
     attach_function :getegid, [], :gid_t
+    attach_function :alarm, [:uint], :uint
 
     # stdlib.h
     attach_function :calloc, [:size_t, :size_t], :pointer
@@ -33,9 +46,15 @@ module FFI
     attach_function :getenv, [:string], :string
     attach_function :putenv, [:string], :int
     attach_function :unsetenv, [:string], :int
-    attach_function :clearenv, [], :int
+
+    begin
+      attach_function :clearenv, [], :int
+    rescue FFI::NotFoundError
+      # clearenv is not available on OSX
+    end
 
     # time.h
+    attach_function :clock, [], :clock_t
     attach_function :time, [:pointer], :time_t
 
     # sys/time.h
@@ -49,33 +68,48 @@ module FFI
     # string.h
     attach_function :bzero, [:pointer, :size_t], :void
     attach_function :memset, [:pointer, :int, :size_t], :pointer
-    attach_function :memcpy, [:pointer, :pointer, :size_t], :pointer
-    attach_function :memcmp, [:pointer, :pointer, :size_t], :int
-    attach_function :memchr, [:pointer, :int, :size_t], :pointer
-    attach_function :memrchr, [:pointer, :int, :size_t], :pointer
-    attach_function :strcpy, [:string, :string], :pointer
-    attach_function :strncpy, [:string, :string, :size_t], :pointer
-    attach_function :strlen, [:string], :size_t
-    attach_function :index, [:string, :int], :string
-    attach_function :rindex, [:string, :int], :string
-    attach_function :strchr, [:string, :int], :string
-    attach_function :strrchr, [:string, :int], :string
-    attach_function :strstr, [:string, :string], :string
+    attach_function :memcpy, [:buffer_out, :buffer_in, :size_t], :pointer
+    attach_function :memcmp, [:buffer_in, :buffer_in, :size_t], :int
+    attach_function :memchr, [:buffer_in, :int, :size_t], :pointer
+
+    begin
+      attach_function :memrchr, [:buffer_in, :int, :size_t], :pointer
+    rescue FFI::NotFoundError
+      # memrchr is not available on OSX
+    end
+
+    attach_function :strcpy, [:buffer_out, :string], :pointer
+    attach_function :strncpy, [:buffer_out, :string, :size_t], :pointer
+    attach_function :strcmp, [:buffer_in, :buffer_in], :int
+    attach_function :strncmp, [:buffer_in, :buffer_in, :size_t], :int
+    attach_function :strlen, [:buffer_in], :size_t
+    attach_function :index, [:buffer_in, :int], :pointer
+    attach_function :rindex, [:buffer_in, :int], :pointer
+    attach_function :strchr, [:buffer_in, :int], :pointer
+    attach_function :strrchr, [:buffer_in, :int], :pointer
+    attach_function :strstr, [:buffer_in, :string], :pointer
     attach_function :strerror, [:int], :string
 
-    # stdio.h
+    begin
+      attach_variable :stdin, :pointer
+      attach_variable :stdout, :pointer
+      attach_variable :stderr, :pointer
+    rescue FFI::NotFoundError
+      # stdin, stdout, stderr are not available on OSX
+    end
+
     attach_function :fopen, [:string, :string], :FILE
     attach_function :fdopen, [:int, :string], :FILE
     attach_function :freopen, [:string, :string, :FILE], :FILE
     attach_function :fseek, [:FILE, :long, :int], :int
     attach_function :ftell, [:FILE], :long
     attach_function :rewind, [:FILE], :void
-    attach_function :fread, [:pointer, :size_t, :size_t, :FILE], :size_t
-    attach_function :fwrite, [:pointer, :size_t, :size_t, :FILE], :size_t
+    attach_function :fread, [:buffer_out, :size_t, :size_t, :FILE], :size_t
+    attach_function :fwrite, [:buffer_in, :size_t, :size_t, :FILE], :size_t
     attach_function :fgetc, [:FILE], :int
-    attach_function :fgets, [:pointer, :int, :FILE], :pointer
+    attach_function :fgets, [:buffer_out, :int, :FILE], :pointer
     attach_function :fputc, [:int, :FILE], :int
-    attach_function :fputs, [:string, :FILE], :int
+    attach_function :fputs, [:buffer_in, :FILE], :int
     attach_function :fflush, [:FILE], :int
     attach_function :fclose, [:FILE], :int
     attach_function :clearerr, [:FILE], :void
@@ -83,5 +117,104 @@ module FFI
     attach_function :ferror, [:FILE], :int
     attach_function :fileno, [:FILE], :int
     attach_function :perror, [:string], :void
+
+    attach_function :getc, [:FILE], :int
+    attach_function :getchar, [], :int
+    attach_function :gets, [:buffer_out], :int
+    attach_function :ungetc, [:int, :pointer], :int
+
+    attach_function :putc, [:int, :FILE], :int
+    attach_function :putchar, [:int], :int
+    attach_function :puts, [:string], :int
+
+    # netdb.h
+    attach_function :getnameinfo, [
+      :pointer,
+      :socklen_t, :pointer,
+      :socklen_t, :pointer,
+      :socklen_t, :int
+    ], :int
+
+    NI_MAXHOST = 1024
+    NI_MAXSERV = 32
+
+    NI_NUMERICHOST = 1       # Don't try to look up hostname.
+    NI_NUMERICSERV = 2       # Don't convert port number to name.
+    NI_NOFQDN      = 4       # Only return nodename portion.
+    NI_NAMEREQD    = 8       # Don't return numeric addresses.
+    NI_DGRAM       = 16      # Look up UDP service rather than TCP.
+
+    # ifaddrs.h
+    attach_function :getifaddrs, [:pointer], :int
+    attach_function :freeifaddrs, [:pointer], :void
+
+    #
+    # Enumerates over the Interface Addresses.
+    #
+    # @yield [ifaddr]
+    #   The given block will be passed each Interface Address.
+    #
+    # @yieldparam [Ifaddrs] ifaddr
+    #   An Interface Address.
+    #
+    # @return [Enumerator]
+    #   If no block is given, an enumerator will be returned.
+    #
+    # @since 0.1.0
+    #
+    def self.each_ifaddr
+      return enum_for(__method__) unless block_given?
+
+      ptr = MemoryPointer.new(:pointer)
+
+      if getifaddrs(ptr) == -1
+        raise_error
+      end
+
+      if (ifaddrs = ptr.get_pointer(0)).null?
+        return
+      end
+
+      ifaddr = Ifaddrs.new(ifaddrs)
+
+      while ifaddr
+        yield ifaddr
+
+        ifaddr = ifaddr.next
+      end
+
+      freeifaddrs(ifaddrs)
+    end
+
+    # bits/resource.h (Linux) / sys/resource.h (Darwin)
+    RUSAGE_SELF = 0
+    RUSAGE_CHILDREN = -1
+    RUSAGE_THREAD = 1 # Linux/glibc only
+
+    attach_function :getrusage, [:int, :pointer], :int
+
+    #
+    # Gets the RUsage for the user.
+    #
+    # @param [RUSAGE_SELF, RUSAGE_CHILDREN, RUSAGE_THREAD] who
+    #   Whome to get RUsage statistics for.
+    #
+    # @return [RUsage]
+    #   The RUsage statistics.
+    #
+    # @raise [RuntimeError]
+    #   An error has occurred.
+    #
+    # @since 0.1.0
+    #
+    def self.rusage(who=RUSAGE_SELF)
+      rusage = RUsage.new
+
+      unless (ret = getrusage(who,rusage)) == 0
+        raise_error(ret)
+      end
+
+      return rusage
+    end
   end
 end

data/lib/ffi/libc/rusage.rb

@@ -0,0 +1,30 @@
+require 'ffi/libc/types'
+require 'ffi/libc/timeval'
+
+module FFI
+  module LibC
+    #
+    # @since 0.1.0
+    #
+    class RUsage < FFI::Struct
+
+      layout :ru_utime, Timeval,
+             :ru_stime, Timeval,
+             :ru_maxrss, :long,
+             :ru_ixrss, :long,
+             :ru_idrss, :long,
+             :ru_isrss, :long,
+             :ru_minflt, :long,
+             :ru_majflt, :long,
+             :ru_nswap, :long,
+             :ru_inblock, :long,
+             :ru_oublock, :long,
+             :ru_msgsnd, :long,
+             :ru_msgrcv, :long,
+             :ru_nsignals, :long,
+             :ru_nvcsw, :long,
+             :ru_nivcsw, :long
+
+    end
+  end
+end

data/lib/ffi/libc/sockaddr.rb

@@ -0,0 +1,16 @@
+require 'ffi/libc/types'
+require 'ffi/libc/sockaddr_family'
+
+module FFI
+  module LibC
+    #
+    # The generic `sockaddr` structure.
+    #
+    class Sockaddr < SockaddrFamily
+
+      layout :family, :sa_family_t,
+             :data,   [:char, 14]
+
+    end
+  end
+end

data/lib/ffi/libc/{sock_addr_dl.rb → sockaddr_dl.rb}

@@ -1,12 +1,12 @@
 require 'ffi/libc/types'
-require 'ffi/libc/sock_addr_family'
+require 'ffi/libc/sockaddr_family'
 
 module FFI
   module LibC
     #
     # The data-link socket address
     #
-    class SockAddrDL < SockAddrFamily
+    class SockaddrDL < SockaddrFamily
 
       layout :len, :uint8,
              :family, :sa_family_t,

data/lib/ffi/libc/{sock_addr_family.rb → sockaddr_family.rb}

@@ -5,7 +5,7 @@ module FFI
     #
     # Common abstract superclass for all sockaddr struct classes
     #
-    class SockAddrFamily < ::FFI::Struct
+    class SockaddrFamily < ::FFI::Struct
 
     end
   end

data/lib/ffi/libc/sockaddr_in.rb

@@ -0,0 +1,19 @@
+require 'ffi/libc/types'
+require 'ffi/libc/sockaddr_family'
+
+module FFI
+  module LibC
+    #
+    # sockaddr inet, always good to have around
+    #
+    class SockaddrIn < SockaddrFamily
+
+      layout :len,      :uint8,
+             :family,   :sa_family_t,
+             :port,     :in_port_t,
+             :addr,     :in_addr_t,
+             :_sa_zero, [:uint8, 8]
+
+    end
+  end
+end

data/lib/ffi/libc/{sock_addr_in6.rb → sockaddr_in6.rb}

@@ -1,4 +1,5 @@
 require 'ffi/libc/types'
+require 'ffi/libc/sockaddr_family'
 require 'ffi/libc/in6_addr'
 
 module FFI
@@ -6,7 +7,7 @@ module FFI
     #
     # IPv6 socket address
     #
-    class SockAddrIn6 < SockAddrFamily
+    class SockaddrIn6 < SockaddrFamily
 
       layout :len, :uint8,
              :family, :sa_family_t,

data/lib/ffi/libc/types.rb

@@ -7,5 +7,8 @@ module FFI
     typedef :pointer, :FILE
     typedef :uint32, :in_addr_t
     typedef :uint16, :in_port_t
+
+    # time.h
+    typedef :long, :clock_t
   end
 end

data/lib/ffi/libc.rb

@@ -1,2 +1,13 @@
 require 'ffi/libc/types'
+require 'ffi/libc/af'
+require 'ffi/libc/ifaddrs'
+require 'ffi/libc/in_addr'
+require 'ffi/libc/in6_addr'
+require 'ffi/libc/sockaddr'
+require 'ffi/libc/sockaddr_dl'
+require 'ffi/libc/sockaddr_in'
+require 'ffi/libc/sockaddr_in6'
+require 'ffi/libc/timeval'
+require 'ffi/libc/timezone'
+require 'ffi/libc/rusage'
 require 'ffi/libc/libc'

data/spec/ifaddrs_spec.rb

@@ -0,0 +1,30 @@
+require 'spec_helper'
+require 'ffi/libc/ifaddrs'
+
+describe Ifaddrs do
+  subject { LibC.each_ifaddr.first }
+
+  it "should have a name" do
+    expect(subject.name).to_not be_empty
+  end
+
+  it "should have flags" do
+    expect(subject.flags).to be_kind_of(Integer)
+  end
+
+  it "should have an addr" do
+    expect(subject.addr).to be_kind_of(Sockaddr)
+  end
+
+  it "should have an netmask" do
+    expect(subject.netmask).to be_kind_of(Sockaddr)
+  end
+
+  it "should have a broadcast addr" do
+    expect(subject.broadaddr).to be_kind_of(Sockaddr)
+  end
+
+  it "should have a destination addr" do
+    expect(subject.dstaddr).to be_kind_of(Sockaddr)
+  end
+end

data/spec/libc_spec.rb

@@ -0,0 +1,36 @@
+require 'spec_helper'
+require 'ffi/libc'
+
+describe FFI::LibC do
+  describe "NULL" do
+    subject { described_class::NULL }
+
+    it { expect(subject).to be == nil }
+  end
+
+  describe "each_ifaddr" do
+    it "should yield Ifaddrs" do
+      addrs = []
+
+      described_class.each_ifaddr do |ifaddr|
+        addrs << ifaddr
+      end
+
+      expect(addrs).to all(be_kind_of(Ifaddrs))
+    end
+
+    context "when not given a block" do
+      subject { described_class.each_ifaddr }
+
+      it { expect(subject).to be_kind_of(Enumerable) }
+    end
+  end
+
+  describe "rusage" do
+    subject { described_class.rusage }
+
+    it "should be able to fetch its own memory usage" do
+      expect(subject[:ru_maxrss]).to be > 4000
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,5 @@
+require 'rspec'
+require 'ffi/libc'
+
+include FFI
+include FFI::LibC

metadata

@@ -1,163 +1,107 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: ffi-libc
-version: !ruby/object:Gem::Version 
-  prerelease: false
-  segments: 
-  - 0
-  - 0
-  - 3
-  version: 0.0.3
+version: !ruby/object:Gem::Version
+  version: 0.1.1
 platform: ruby
-authors: 
+authors:
 - Postmodern
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-
-date: 2010-08-03 00:00:00 -07:00
-default_executable: 
-dependencies: 
-- !ruby/object:Gem::Dependency 
+date: 2021-09-22 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
   name: ffi
-  requirement: &id001 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
-    - - ~>
-      - !ruby/object:Gem::Version 
-        segments: 
-        - 0
-        - 6
-        - 0
-        version: 0.6.0
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
   type: :runtime
   prerelease: false
-  version_requirements: *id001
-- !ruby/object:Gem::Dependency 
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
   name: bundler
-  requirement: &id002 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
-    - - ~>
-      - !ruby/object:Gem::Version 
-        segments: 
-        - 0
-        - 9
-        - 25
-        version: 0.9.25
-  type: :development
-  prerelease: false
-  version_requirements: *id002
-- !ruby/object:Gem::Dependency 
-  name: rake
-  requirement: &id003 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
-    - - ~>
-      - !ruby/object:Gem::Version 
-        segments: 
-        - 0
-        - 8
-        - 7
-        version: 0.8.7
-  type: :development
-  prerelease: false
-  version_requirements: *id003
-- !ruby/object:Gem::Dependency 
-  name: jeweler
-  requirement: &id004 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
-    - - ~>
-      - !ruby/object:Gem::Version 
-        segments: 
-        - 1
-        - 4
-        - 0
-        version: 1.4.0
-  type: :development
-  prerelease: false
-  version_requirements: *id004
-- !ruby/object:Gem::Dependency 
-  name: rspec
-  requirement: &id005 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
-    - - ~>
-      - !ruby/object:Gem::Version 
-        segments: 
-        - 1
-        - 3
-        - 0
-        version: 1.3.0
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
   type: :development
   prerelease: false
-  version_requirements: *id005
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
 description: Useful Ruby FFI bindings for libc.
 email: postmodern.mod3@gmail.com
 executables: []
-
 extensions: []
-
-extra_rdoc_files: 
+extra_rdoc_files:
 - ChangeLog.md
 - LICENSE.txt
 - README.md
-files: 
-- .gitignore
-- .specopts
-- .yardopts
+files:
+- ".github/workflows/ruby.yml"
+- ".gitignore"
+- ".rspec"
+- ".yardopts"
 - ChangeLog.md
 - Gemfile
 - LICENSE.txt
 - README.md
 - Rakefile
-- VERSION
 - ffi-libc.gemspec
+- gemspec.yml
 - lib/ffi/libc.rb
 - lib/ffi/libc/af.rb
+- lib/ffi/libc/ifaddrs.rb
+- lib/ffi/libc/ifaddrs_union.rb
 - lib/ffi/libc/in6_addr.rb
 - lib/ffi/libc/in_addr.rb
 - lib/ffi/libc/libc.rb
-- lib/ffi/libc/sock_addr.rb
-- lib/ffi/libc/sock_addr_dl.rb
-- lib/ffi/libc/sock_addr_family.rb
-- lib/ffi/libc/sock_addr_in.rb
-- lib/ffi/libc/sock_addr_in6.rb
+- lib/ffi/libc/rusage.rb
+- lib/ffi/libc/sockaddr.rb
+- lib/ffi/libc/sockaddr_dl.rb
+- lib/ffi/libc/sockaddr_family.rb
+- lib/ffi/libc/sockaddr_in.rb
+- lib/ffi/libc/sockaddr_in6.rb
 - lib/ffi/libc/timeval.rb
 - lib/ffi/libc/timezone.rb
 - lib/ffi/libc/types.rb
-has_rdoc: yard
-homepage: http://github.com/postmodern/ffi-libc
-licenses: 
+- spec/ifaddrs_spec.rb
+- spec/libc_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/postmodern/ffi-libc#redme
+licenses:
 - MIT
-post_install_message: 
+metadata:
+  documentation_uri: https://rubydoc.info/gems/ffi-libc
+  source_code_uri: https://github.com/postmodern/ffi-libc
+  bug_tracker_uri: https://github.com/postmodern/ffi-libc/issues
+  changelog_uri: https://github.com/postmodern/ffi-libc/blob/master/ChangeLog.md
+post_install_message:
 rdoc_options: []
-
-require_paths: 
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
-  none: false
-  requirements: 
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
   - - ">="
-    - !ruby/object:Gem::Version 
-      hash: -2959684172308845082
-      segments: 
-      - 0
-      version: "0"
-required_rubygems_version: !ruby/object:Gem::Requirement 
-  none: false
-  requirements: 
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
   - - ">="
-    - !ruby/object:Gem::Version 
-      segments: 
-      - 0
-      version: "0"
+    - !ruby/object:Gem::Version
+      version: '0'
 requirements: []
-
-rubyforge_project: 
-rubygems_version: 1.3.7
-signing_key: 
-specification_version: 3
+rubygems_version: 3.2.22
+signing_key:
+specification_version: 4
 summary: Useful FFI bindings for libc
 test_files: []
-

data/.specopts

@@ -1 +0,0 @@
---colour --format specdoc

data/VERSION

@@ -1 +0,0 @@
-0.0.3

data/lib/ffi/libc/sock_addr.rb

@@ -1,17 +0,0 @@
-require 'ffi/libc/types'
-require 'ffi/libc/sock_addr_family'
-
-module FFI
-  module LibC
-    #
-    # The generic `sock_addr` structure.
-    #
-    class SockAddr < SockAddrFamily
-
-      layout :len, :uint8,
-             :family, :sa_family_t,
-             :data, :char
-
-    end
-  end
-end

data/lib/ffi/libc/sock_addr_in.rb

@@ -1,19 +0,0 @@
-require 'ffi/libc/types'
-require 'ffi/libc/sock_addr_family'
-
-module FFI
-  module LibC
-    #
-    # sockaddr inet, always good to have around
-    #
-    class SockAddrIn < SockAddrFamily
-
-      layout :len, :uint8,
-             :family, :sa_family_t,
-             :port, :in_port_t,
-             :addr, :in_addr_t,
-             :_sa_zero, [:uint8, 8]
-
-    end
-  end
-end