Code Monkey home page Code Monkey logo

libviface's Introduction

libviface : C++ bindings for Linux tun/tap and netdevice interface

libviface is a small C++11 library that allows to create (or hook to) and configure network interfaces in Linux based Operating Systems.

#include "viface/viface.hpp"

// Create interface
viface::VIface iface("viface%d");

// Configure interface
iface.setMAC("66:23:2d:28:c6:84");
iface.setIPv4("192.168.20.21");

// Bring-up interface
iface.up();

Then you can send(), receive() or setup a dispath() callback to handle virtual interfaces incoming and outgoing packets. Also, interface statistics (rx/tx packets, bytes, etc) are available to read using readStat() and related functions.

For a complete overview check the reference documentation and examples.

Features

  • Object Oriented approach to create virtual interfaces.
  • Can also hook to existing interfaces (real).
  • Multiple strategies for packet reception and emission.
  • Interface configuration API (MAC, Ipv4, IPv6, MTU).
  • Interface statistics reading and clearing.
  • Easily integrated with libtins.

Dependencies

sudo apt-get install build-essential cmake doxygen graphviz

Build

mkdir build
cd build
cmake ..
make
make doc

Improvements

  • Improve and fix possible race conditions when up/down is issued (and thus packet buffer based on MTU is resized) and a dispatcher is active or any other IO is active.

License

Copyright (C) 2015-2018 Hewlett Packard Enterprise Development LP

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing,
software distributed under the License is distributed on an
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
KIND, either express or implied.  See the License for the
specific language governing permissions and limitations
under the License.

libviface's People

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

libviface's Issues

Compilation via VSCode

Hello,

For some reason, when I compile the library using VSCode in Ubuntu 16.04 I get an error: viface/config.hpp: No such file or directory.

However, when I use the manual build process everything works fine. Also, if I change config.hpp.in to config.hpp everything works. Is there anything I'm doing wrong or perhaps a problem with using the VSCode CMake Tools?

Can't compile in Debian

cmake runs from build directory however I receive the following message when trying to run make:

error: ‘function’ in namespace ‘std’ does not name a template type

I'm assuming this is an issue with which version of the c++ standard is used to compile. I edited the CMakeLists.txt file in order to force both c++ 11 and later c++17 but received the same error message both times when running make.

I'm using cmake 3.10.2 and make 4.1

TAP interface misses packets (mostly ICMP)

I have been fighting/investigating this issue for about 3 days and finally figured it out. I found that either using the 'dispatcher' call, or through viface::receive() many packets were missed. They were always visible using tcpdump, wireshark, and iptables logging, but my user-space application would only receive mostly multicast and/or broadcast messages (such as ARP, multicast, and UDP broadcast messages) sent from the host. Trying to 'ping' another virtual device attached to the userspace program (with it's own MAC and IP), I would receive the ARP asking for the mac, and the return would be sent and accepted by the host (device was shown in the arp table). However, the ping command would then start sending ICMP echo request packets to the interface, and they would not be received using either receive() or dispatch functionality. After days of pulling out my hair, messing with iptables rules, rp_filters, the 'sniffer' from libtins, etc. I finally decided to modifiy 'receive' to read from both rx and tx queues and return any packet pending. I now receive all packets.

receive() was modified to this:

int e;
    // Read packet into our buffer
    int nread = read(this->queues.rx, &(this->pktbuff[0]), this->mtu);
    e=errno;

// viface issue.  Kernel writes incoming packets to BOTH queues, so we
// need to read from both
    if (((nread<0) && (e==EAGAIN)) || (nread==0))
    {
        nread = read(this->queues.tx, &(this->pktbuff[0]), this->mtu);
        e=errno;
    }
    // Handle errors
    if (nread == -1) {

I will have to also modify the 'dispatch' reader to add the tx queue file descriptor to the select.
I am not a 'git' guy, so I don't want to have to figure out how to merge my changes in, just wanted to let you know.

I believe this effects ICMP messages the most because it seems the kernel tries to add out-of-band (high priority) messages to the tx queue and not the standard read queue.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.