Warpcore is a minimal userspace UDP/IP/Ethernet stack for the netmap packet I/O framework. Due to its dependency on netmap, warpcore supports Linux (with a netmap-patched kernel) and FreeBSD (which has netmap support since release 11).
Warpcore also has a backend implementation using the Socket API that should compile on generic POSIX platforms, such as Linux, Darwin and others. The POSIX backend has experimental support for the Particle IoT stack, allowing applications built on warpcore (such as quant) to support embedded devices. Warpcore also has an experimental support for RIOT, another IoT stack.
Warpcore prioritizes performance over features, and over full standards compliance. It supports zero-copy transmit and receive with netmap, and uses neither threads, timers nor signals. It exposes the underlying file descriptors to an application, for easy integration with different event loops (e.g., libev).
The warpcore repository is on GitHub.
NOTE: Warpcore is a research effort and not meant for production use.
Warpcore uses cmake as a build system. To do an
out-of-source build of warpcore (best practice with
cmake), do the following
to build with
make as a generator:
git submodule update --init --recursive mkdir Debug cd Debug cmake .. make
On platforms where netmap is available, the steps above will build a debug
libsockcore.a against netmap as a backend, and place it into the
Debug/lib. Examples (
sockinetd) will be built in
On platforms where netmap is available, the steps above will also build a debug
libwarpcore.a against netmap as a backend, and place it into the
Debug/lib. Examples (
warpinetd) will also be built in
The default build (per above) is without optimizations and with extensive debug logging enabled. In order to build an optimized build, do this:
git submodule update --init --recursive mkdir Release cd Release cmake -DCMAKE_BUILD_TYPE=Release .. make
Warpcore comes with documentation. This documentation can be built (if
is installed) by doing
in any build directory. The starting page of the documentation is then
Copyright (c) 2014-2020, NetApp, Inc. All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
This software has received funding from the European Union's Horizon 2020 research and innovation program 2014-2018 under grant agreement 644866 ("SSICLOPS"). The European Commission is not responsible for any use that may be made of this software.