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 7e30474ee4 Implemented barebones VL2 SOCK_RAW functionality, moved ZT core helper functions from OneService to libzt 9 years ago
artwork README updates, misc filename changes, debug trace fixes, introduction of libzt moniker 9 years ago
docs significant upgrade to selftest, added echotest, better checks for data in queue before socket closure 9 years ago
examples More *.md tweaks 9 years ago
ext BSD-license-compatible, and NO_STACK build variants 9 years ago
include Implemented barebones VL2 SOCK_RAW functionality, moved ZT core helper functions from OneService to libzt 9 years ago
src Implemented barebones VL2 SOCK_RAW functionality, moved ZT core helper functions from OneService to libzt 9 years ago
test Implemented barebones VL2 SOCK_RAW functionality, moved ZT core helper functions from OneService to libzt 9 years ago
zto@e4823381c6 Implemented barebones VL2 SOCK_RAW functionality, moved ZT core helper functions from OneService to libzt 9 years ago
.gitignore Added to .gitignore 9 years ago
.gitmodules Added ZeroTierOne as a submodule 9 years ago
BUILDING.md Slight reorganization of docs 9 years ago
Makefile fixed connect/accept behaviour, added to selftest, renamed BSD makefile 9 years ago
README.md Updated README.md 9 years ago
RELEASE-NOTES.md significant upgrade to selftest, added echotest, better checks for data in queue before socket closure 9 years ago
TESTING.md Minor changes to selftest, updated TESTING readme, removed old test personality conf files 9 years ago
check.sh dynamic loading of network stack no longer needed 9 years ago
make-bsd.mk Added ZeroTierOne as a submodule 9 years ago
make-liblwip.mk Implemented barebones VL2 SOCK_RAW functionality, moved ZT core helper functions from OneService to libzt 9 years ago
make-linux.mk Implemented barebones VL2 SOCK_RAW functionality, moved ZT core helper functions from OneService to libzt 9 years ago
make-mac.mk Implemented barebones VL2 SOCK_RAW functionality, moved ZT core helper functions from OneService to libzt 9 years ago
objects.mk Implemented barebones VL2 SOCK_RAW functionality, moved ZT core helper functions from OneService to libzt 9 years ago

README.md

libzt

Embed ZeroTier directly into your app


A library version of the popular ZeroTier One, libzt makes it easy to securely connect devices, servers, cloud VMs, containers, and apps everywhere and manage them at scale. Now you can bake this ability directly into your app or service using your preferred language or framework. We provide a BSD socket-like API supporting SOCK_STREAM, SOCK_DGRAM, and SOCK_RAW to make the integration simple. There's also no longer any need for system-wide virtual interfaces. This connection is exclusive to your app and fully encrypted via the Salsa20 cipher.


irc

Pre-Built Binaries Here: zerotier.com/download.shtml.


Example

#include "libzt.h"

char *str = "welcome to the machine"; // test msg 
char *nwid = "c7cd7c9e1b0f52a2";      // network to join
char *path = "zt1";                   // path where this node's keys and configs will be stored
char *ip = "10.8.8.42";               // host on ZeroTier network
int port = 8080;                      // resource's port

struct sockaddr_in addr;
addr.sin_family = AF_INET;
addr.sin_addr.s_addr = inet_addr(ip);
addr.sin_port = hton(port);	

zts_simple_start(path, nwid);
int fd = zts_socket(AF_INET, SOCK_STREAM, 0);
zts_connect(fd, (const struct sockaddr *)addr, sizeof(addr));
zts_write(fd, str, strlen(str));
zts_close(fd);

Bindings for various languages

For an example using only the Virtual Layer 2, see test/layer2.cpp


Building (linux, macos, bsd, win, ios)

git submodule init
git submodule update
make static_lib

All targets will output to build/. Complete instructions here


Testing and Debugging

Licensing

  • For a BSD license, build using the lwIP network stack with STACK_LWIP=1
  • For a GPL license, build using the picoTCP network stack with STACK_PICO=1

Regardless of which network stack you build with, the socket API will remain the same.