papierkorb / tuntap

TUN/TAP driver for Crystal

tuntap

Create TUN/TAP devices under Linux (And possibly others). If you want to know more about the intrinsics of TUN/TAP, read the kernel documentation over at https://www.kernel.org/doc/Documentation/networking/tuntap.txt

Important: This shard may only run on Linux x86_64. If you want to port this to another platform let me know!

Installation

Add this to your application's shard.yml:

dependencies:
  tuntap:
    github: Papierkorb/tuntap

Usage

require "tuntap"

Please see samples/ for example programs. Don't worry, they're documented :)

Contributing

1. Fork it ( https://github.com/Papierkorb/tuntap/fork )
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create a new Pull Request

Contributors

• Papierkorb Stefan Merettig - creator, maintainer

tuntap's Issues

This repository is not compatible with the latest Crystal version

Passing the address/netmask directly as integer/sockaddr_in

Would it be desired to have some extra overloads for the add_address and add_netmask methods?
It would be nice if I would be able just pass the sockaddr_in structure to them:

def add_address(address : LibC::SockaddrIn)
  ifr = ifreq
  ifr.ifr = LibC::IfReqData.new(addr: address)

  ioctl LibC::SIOCSIFADDR, ifr
end

def add_address(address : String)
  add_address(sockaddr(address))
end