lokinet/readme.md

# LokiNet

LokiNet is the reference implementation of LLARP (low latency anonymous routing protocol), a layer 3 onion routing protocol.

You can learn more about the high level design of LLARP [here](docs/high-level.txt)

And you can read the LLARP protocol specification [here](docs/proto_v0.txt)

![build status](https://gitlab.com/lokiproject/loki-network/badges/master/pipeline.svg "build status")

## Building

Build requirements:

* GNU Make
* CMake
* C++ 17 capable C++ compiler

To build:

    $ sudo apt install build-essential cmake git libcap-dev
    $ git clone https://github.com/loki-project/loki-network
    $ cd loki-network
    $ make -j8

## Running

    $ ./lokinet -g
    $ ./lokinet-bootstrap
    $ ./lokinet

## Usage

see the [documentation](https://loki-project.github.io/loki-docs/Lokinet/LokinetOverview/) on how to get started.
Lokinet soft Reveal Moving LLARP under the Loki banner 2018-06-16 14:31:48 +02:00			`# LokiNet`
RFC Signed-off-by: Jon Titor <j.titor@s.g> 2017-09-22 23:06:48 +02:00
update readme add sighup 2018-09-17 13:47:34 +02:00			`LokiNet is the reference implementation of LLARP (low latency anonymous routing protocol), a layer 3 onion routing protocol.`
more 2017-10-03 21:14:46 +02:00
update links in readme 2018-10-08 14:21:29 +02:00			`You can learn more about the high level design of LLARP [here](docs/high-level.txt)`
initial windows server port. Requires Windows 2000 Server or later. - updated CMake build script - builds with Microsoft C++ 19.1x. such builds require Windows 8.1 or later unless you have the .NET Server 2003-toolset (v141_xp) - windows port requires a C++17 compiler since cpp17::filesystem is POSIX-only - HAVE_CXX17_FILESYSTEM manual toggle in CMake. You must manually specify where std::[experimental::]filesystem is defined in LDFLAGS or CMAKE_x_LINKER_FLAGS. - IPv6 support can be added at any time, and the windows sdk still has that inline getaddrinfo(3) if it can't find a suitable IPv6 stack. - inline code for mingw-w64: there's a few bits and pieces still missing simply because mingw-w64 derives its windows sdk from wine and reactos, and then writing all the newer stuff into it by hand straight from the MSDN manpages. - misc. C++11 stuff (nullptr and friends) - Internal file handling code takes UTF-8 or plain 8-bit text, NTFS is UTF-16, so std::filesystem::path::c_str() is wchar_t. That's no good unless you first call std::filesystem::path::string(). - implemented getifaddrs(3) and if_nametoindex(3) on top of GetAdapters[Info\|Addresses](2). - updated readme with new info BONUS: may implement Solaris/illumos IOCP someday... -despair86 2018-07-30 06:38:14 +02:00
update links in readme 2018-10-08 14:21:29 +02:00			`And you can read the LLARP protocol specification [here](docs/proto_v0.txt)`
update readme 2018-06-01 20:23:01 +02:00
update readme and include bootstrap script 2018-10-23 13:51:11 +02:00			`![build status](https://gitlab.com/lokiproject/loki-network/badges/master/pipeline.svg "build status")`
merge 2018-08-13 10:47:24 +02:00
update readme and include bootstrap script 2018-10-23 13:51:11 +02:00			`## Building`
merge 2018-08-13 10:47:24 +02:00
			`Build requirements:`

bundle relevent libsodium parts 2018-10-23 13:29:37 +02:00			`* GNU Make`
merge 2018-08-13 10:47:24 +02:00			`* CMake`
bundle relevent libsodium parts 2018-10-23 13:29:37 +02:00			`* C++ 17 capable C++ compiler`
merge 2018-08-13 10:47:24 +02:00
fix markdown 2018-10-23 13:54:04 +02:00			`To build:`

update readme and include bootstrap script 2018-10-23 13:51:11 +02:00			`$ sudo apt install build-essential cmake git libcap-dev`
			`$ git clone https://github.com/loki-project/loki-network`
			`$ cd loki-network`
			`$ make -j8`
update readme 2018-09-19 14:07:13 +02:00
update readme and include bootstrap script 2018-10-23 13:51:11 +02:00			`## Running`
bundle relevent libsodium parts 2018-10-23 13:29:37 +02:00
forgot line 2018-10-24 13:47:57 +02:00			`$ ./lokinet -g`
update readme and include bootstrap script 2018-10-23 13:51:11 +02:00			`$ ./lokinet-bootstrap`
			`$ ./lokinet`
update readme and make dht bootstrap work with low peer count 2018-09-09 14:27:56 +02:00
update readme add sighup 2018-09-17 13:47:34 +02:00			`## Usage`
update readme and make dht bootstrap work with low peer count 2018-09-09 14:27:56 +02:00
update readme and include bootstrap script 2018-10-23 13:51:11 +02:00			`see the [documentation](https://loki-project.github.io/loki-docs/Lokinet/LokinetOverview/) on how to get started.`