You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
Joseph Henry b62d63592c Added version resource file for Windows DLL build 7 years ago
examples Updated Android example 7 years ago
ext Updated lwip-contrib submodule revision 7 years ago
include Minor changes for Windows build 7 years ago
ports Added .gitattributes to exclude certain directories from git-archive 7 years ago
src Minor changes for Windows build 7 years ago
test Updated example simple.cpp for Windows 7 years ago
.gitattributes Tweaked .gitattributes 7 years ago
.gitignore Added *.aar and *.keystore to .gitignore 7 years ago
.gitmodules Added forked joseph-henry/lwip-contrib as new lwip-contrib submodule 7 years ago
API.md Updated documentation, removed unnecessary include 7 years ago
CHANGELOG.md Added function in dist.sh to generate markdown-formatted changelogs 7 years ago
CMakeLists.txt Added dynamic library to install section of CMakeLists.txt 7 years ago
LICENSE.GPL-3 Added license files for libzt and lwip 9 years ago
Makefile Minor build fixes for Windows 7 years ago
README.md Added Homebrew blurb, fixed test example, removed patches from Makefile 7 years ago
clean.bat Promoted dist.sh to top-level directory, updated .gitignore 7 years ago
dist.bat Changes to dist.bat for Windows build 7 years ago
dist.sh Added function in dist.sh to generate markdown-formatted changelogs 7 years ago
version.rc.in Added version resource file for Windows DLL build 7 years ago

README.md

ZeroTier SDK (libzt, libztcore)

Library edition of ZeroTier


The ZeroTier SDK is composed of two libraries: libztcore which is the platform-agnostic network hypervisor, and libzt which is the network hypervisor paired with a userspace network stack. libzt is a superset of libztcore and is distinguished by the fact that it exposes a standard socket API and simple network control API. With these libraries the stack and virtual link are exclusive to your app and traffic is fully encrypted via the Salsa20 cipher. For a more in-depth discussion on the technical side of ZeroTier, check out our Manual



Downloads / Installation

Tarballs:

Homebrew

brew install libzt


Example

#include "ZeroTier.h"

void myZeroTierEventCallback(struct zts_callback_msg *msg)
{
    switch (msg->eventCode)
    {
        //
    }
}

int main()
{
    zts_start("yourConfig/key/path", &myZeroTierEventCallback, 9994);
    zts_join(0x0123456789abcdef);
    zts_socket(ZTS_AF_INET, ZTS_SOCK_STREAM, 0);
    zts_connect(fd, (const struct sockaddr *)&addr, sizeof(addr));
    zts_write(fd, "welcome to the machine", 22);
    zts_close(fd);
    zts_stop();
    return 0;
}

...

After you've created a virtual network and added its nwid to the sample code, run:

clang++ example.cpp -o example -lzt
./example

The complete API specification can be found here: API.md


Build from source

Build scripts use a combination of make, and cmake. To retrieve sources for all submodules, patch them, and build all targets (debug and release) for your host machine, issue the following:

make update
make patch
make all

All build targets can be seen by using make list.

Resultant libraries will be placed in lib, test and example programs will be placed in bin.


Commercial License

If you want a commercial license to use the ZeroTier SDK in your product contact us directly via contact@zerotier.com